Built-in Version Number Adapter plugins

NameInitial versionIncrement optionsDescription

PlainVersionNumerationAdapter

1

INCREASE_DEFAULT

Plain incrementing integer (1, 2, 3...), formatted with the version.numeration.format configuration parameter (default %d).

PlainZeroVersionNumerationAdapter

0

INCREASE_DEFAULT

Same as PlainVersionNumerationAdapter, but starting at 0 instead of 1.

MajorMinorVersionNumerationAdapter

1.0

INCREASE_MAJOR

major.minor numbering. The UI only offers a "major" increase checkbox: checking it bumps the major number and resets minor to 0; leaving it unchecked increases the minor number by default.

MajorMinorReleaseVersionNumerationAdapter

0.0.0

INCREASE_MAJOR_MINOR

major.minor.release numbering. The UI offers "major" and "minor" increase checkboxes: major resets minor and release to 0, minor resets only release to 0, and release increases by default when neither is checked.

BranchVersionNumerationAdapter

1

INCREASE_DEFAULT

Dot-separated branch numbering that grows in depth on collision: normally increments the last segment (1 → 2), but if that number is already taken by another branch, starts a new sub-branch instead (e.g. 11.0).

VersionLetterAdapter

A

INCREASE_DEFAULT

Alphabetic numbering: A, B, C... Z, AA, AB... up to 702 combinations (A-Z followed by AA-ZZ), spreadsheet-column style.

Unlike most other plugin types, only one Version Number Adapter is active at a time, application-wide - it is not toggled from the plugin list or a profile, but selected by canonical class name in the version.numeration.adapter configuration parameter (Administration > Configuration parameters), and requires an application restart to take effect. Changing it after documents already have versions may require migrating the old version numbers to the new format, since the new adapter has to be able to parse whatever is already stored.

See Creating your own Version Number Adapter for the interface and a full example.

Table of contents [ Hide Show ]