summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPatrick McDermott <patrick.mcdermott@libiquity.com>2021-01-08 18:57:54 (EST)
committer Patrick McDermott <patrick.mcdermott@libiquity.com>2021-01-08 19:01:38 (EST)
commit9c89390c76a800e513c9df82ee51a1c30f28ac82 (patch)
tree44407c90085e69fd84dade560bc10296ef778e08
parent02d46adca288344b95e3fe2f730eeb90c10051be (diff)
SPF 2.0: Allow epochs in version identifiers
-rw-r--r--specs/spf-2.0/metadata.mdwn9
1 files changed, 8 insertions, 1 deletions
diff --git a/specs/spf-2.0/metadata.mdwn b/specs/spf-2.0/metadata.mdwn
index 74fdefe..36f4326 100644
--- a/specs/spf-2.0/metadata.mdwn
+++ b/specs/spf-2.0/metadata.mdwn
@@ -129,7 +129,14 @@ Source Package Version Identifier [src-ver]
In general, the syntax of source package version identifiers is:
- <pkgver>[+sip<siprev>][-<pkgrev>][+<dist>~<distrev>][~bpu<distnum>+<bpurev>]
+ [<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,