diff options
Diffstat (limited to 'specs/spf-2.0/metadata.mdwn')
-rw-r--r-- | specs/spf-2.0/metadata.mdwn | 66 |
1 files changed, 47 insertions, 19 deletions
diff --git a/specs/spf-2.0/metadata.mdwn b/specs/spf-2.0/metadata.mdwn index 5323d4c..913fd43 100644 --- a/specs/spf-2.0/metadata.mdwn +++ b/specs/spf-2.0/metadata.mdwn @@ -87,8 +87,8 @@ Each configuration file must be described with an entry of the following format: directory -- either `/usr/share/platconf/PLATFORM/PACKAGE_VERSION` or `/usr/share/platconf/PLATFORM/PACKAGE`, where `PLATFORM` is the architecture string denoting an application platform, `PACKAGE` is the name of the -configurable source package, and `VERSION` is the upstream version of the -configurable source package. +configurable source package, and `VERSION` is a shell command language pattern +matching the upstream version of the configurable source package. `destination` is the path (file or directory) to which the file should be copied. For a file used at build time, it is a path relative to the package @@ -107,7 +107,9 @@ and minus signs, and periods. Names must be at least two characters long and must start with either a letter or a digit. (A regular expression for this is `[a-z0-9][a-z0-9+.-]+`.) -Source package names may not begin with the reserved string "src-". +Source package names may not begin with the reserved string "src-". *This +limitation is expected to be removed in a future draft of this version of this +Source Package Format.* Binary Package Names [bin-name] ------------------------------- @@ -117,11 +119,14 @@ and minus signs, and periods. Names must be at least two characters long and must start with either a letter or a digit. (A regular expression for this is `[a-z0-9][a-z0-9+.-]+`.) -Binary package names may not begin with the reserved string "src-". +Binary package names may not begin with the reserved string "src-". *This +limitation is expected to be removed in a future draft of this version of this +Source Package Format.* A binary package clean name is a binary package name with all plus and minus signs and periods removed. No two binary packages built from the same source -package may have the same clean name. +package may have the same clean name. *This limitation is expected to be +removed in a future draft of this version of this Source Package Format.* Source Package Version Identifier [src-ver] @@ -129,7 +134,14 @@ Source Package Version Identifier [src-ver] In general, the syntax of source package version identifiers is: - <pkgver>[+sip<siprev>][-<pkgrev>][+<dist>~<distrev>] + [<epoch>:]<pkgver>[+sip<siprev>][-<pkgrev>][+<dist>~<distrev>][~bpu<distnum>+<bpurev>] + +`<epoch>` should almost always be omitted, in which case it is effectively zero. +It may be used when the upstream version numbering scheme changes or when one or +more binary packages are migrated to a different source package with a different +upstream version numbering scheme. It must be a string of one or more digits, +the first of which must be greater than or equal to `1`. (A regular expression +for this is `[1-9][0-9]*`.) `<pkgver>` is the version of the original upstream package or the native package. It may only consist of lowercase Latin letters, digits, periods, @@ -148,18 +160,34 @@ regular expression for this is `[1-9][0-9]*`.) should be omitted for native packages. It should be incremented on each revision of packaging while `<pkgver>` and `<siprev>` remain constant. It should be reset to `1` for the first revision of packaging for a new upstream -package version or source archive repack. It must be a string of one or more -digits, the first of which must be greater than or equal to `1`. (A regular -expression for this is `[1-9][0-9]*`.) +package version or source archive repack if the package is to be installed into +the `trunk` distribution; otherwise it should be set to `0` and never +incremented. It must be a string of one or more digits. (A regular expression +for this is `[0-9]+`.) If the package is to be installed into a distribution other than `trunk`, the -string `+<dist>~<distrev>` must be appended to the end of the version -identifier. `<dist>` is the distribution into which the package is to be -installed, may only consist of lowercase Latin letters and digits, and must be -at least one character long. (A regular expression for this is `[a-z0-9]+`.) -`<distrev>` is a number that should be incremented on each upload to `<dist>` -while `<pkgver>`, `<siprev>`, and `<pkgrev>` remain constant. It should be -reset to `1` for the first upload to `<dist>` of a new upstream package version, -source archive repack, or distribution packaging revision. It must be a string -of one or more digits, the first of which must be greater than or equal to `1`. -(A regular expression for this is `[1-9][0-9]*`.) +string `+<dist>~<distrev>` must be included in the version identifier. `<dist>` +is the distribution into which the package is to be installed, may only consist +of lowercase Latin letters and digits, and must be at least one character long. +(A regular expression for this is `[a-z0-9]+`.) `<distrev>` is a number that +should be incremented on each upload to `<dist>` while `<pkgver>`, `<siprev>`, +and `<pkgrev>` remain constant. It should be reset to `1` for the first upload +to `<dist>` of a new upstream package version, source archive repack, or +distribution packaging revision. It must be a string of one or more digits, the +first of which must be greater than or equal to `1`. (A regular expression for +this is `[1-9][0-9]*`.) + +If the package is to be backported from `trunk` or another distribution into a +different distribution other than `trunk`, the string `~bpu<distnum>+<bpurev>` +must be included in the version identifier. `<distnum>` is a numeric +distribution version identifier for the distribution to which the package is +backported. It must be a string of one or more digits, the first of which must +be greater than or equal to `1`. (A regular expression for this is +`[1-9][0-9]*`.) `<bpurev>` is a number that should be incremented on each +backport to distribution version `<distnum>` while `<pkgver>`, `<siprev>`, +`<pkgrev>`, `<dist>`, and `<distrev>` remain constant. It should be reset to +`1` for the first backport to distribution version `<distnum>` of a new upstream +package version, source archive repack, distribution packaging revision, or +installation into a distribution other than `trunk`. It must be a string of one +or more digits, the first of which must be greater than or equal to `1`. (A +regular expression for this is `[1-9][0-9]*`.) |