Difference between revisions of "Documentation/DevGuide/Extensions/Extension Versions"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (added links)
m (changes for OOo 3.3)
(2 intermediate revisions by 2 users not shown)
Line 4: Line 4:
 
|NextPage=Documentation/DevGuide/Extensions/Target Platform
 
|NextPage=Documentation/DevGuide/Extensions/Target Platform
 
}}
 
}}
 +
{{Documentation/DevGuideLanguages|Documentation/DevGuide/Extensions/{{SUBPAGENAME}}}}
 
{{DISPLAYTITLE:Extension Versions}}
 
{{DISPLAYTITLE:Extension Versions}}
 
Extensions are often improved over time. That is, publishers want to ship new versions of the same extension with added functionality and/or bug fixes. Adding extension versions allows publishers to ship new versions, and allows {{PRODUCTNAME}} to detect and handle the case that an extension installed by the user is an update of an existing extension.
 
Extensions are often improved over time. That is, publishers want to ship new versions of the same extension with added functionality and/or bug fixes. Adding extension versions allows publishers to ship new versions, and allows {{PRODUCTNAME}} to detect and handle the case that an extension installed by the user is an update of an existing extension.
Line 18: Line 19:
 
No general semantics are prescribed to versions, other than the total order which determines whether one version is less than, equal to, or greater than another version, respectively. However, extension publishers are encouraged to use the widely accepted three-level scheme of major (incompatible changes), minor (compatible changes), micro (bug fixes) where applicable.
 
No general semantics are prescribed to versions, other than the total order which determines whether one version is less than, equal to, or greater than another version, respectively. However, extension publishers are encouraged to use the widely accepted three-level scheme of major (incompatible changes), minor (compatible changes), micro (bug fixes) where applicable.
  
 +
'''As of OOo 3.3''' providing a version is necessary for bundled and shared extensions (see [[Documentation/DevGuide/Extensions/Processing_Extensions#Removing_a_shared_extension|Processing Extensions]]).
  
 
'''See also'''
 
'''See also'''

Revision as of 05:37, 9 June 2010



Extensions are often improved over time. That is, publishers want to ship new versions of the same extension with added functionality and/or bug fixes. Adding extension versions allows publishers to ship new versions, and allows OpenOffice.org to detect and handle the case that an extension installed by the user is an update of an existing extension.

Technically, an extension version v is defined as an infinite sequence of non-negative integers v = ‹v0, v1, ...› where all but a finite number of elements have the value zero. A total order is defined on versions via lexicographical comparison. A textual representation of a version v = ‹v0, v1, ...› is a finite string built from the BNF

 version ::= [element (“.” element)*]
 element ::= (“0” | “1” | “2” | “3” | “4” | “5” | “6” | “7” | “8” | “9”)+

of n ≥ 0 elements where each element is a decimal representation of vi for 0 ≤ i < n, and each vi = 0 for i ≥ n.

The extension version is obtained from the description.xml contained in the extension. If the extension does not specify such an explicit version, then an implict textual version representation of the empty string (representing a version of all zeroes) is assumed.

No general semantics are prescribed to versions, other than the total order which determines whether one version is less than, equal to, or greater than another version, respectively. However, extension publishers are encouraged to use the widely accepted three-level scheme of major (incompatible changes), minor (compatible changes), micro (bug fixes) where applicable.

As of OOo 3.3 providing a version is necessary for bundled and shared extensions (see Processing Extensions).

See also


Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages