[Rpm-maint] [rpm-software-management/rpm] Add a rpm-version(7) man page for the rpm versioning system (PR #3885)

[Panu Matilainen]

@pmatilai commented on this pull request.



> +
+Technically, the format is exactly the same as for _VERSION_.
+
+## Epoch
+The _EPOCH_ is a non-negative integer, separated from the version with
+a colon (*:*). It's the most significant part of an
+_EVR_, skewing version comparison to make an older version to appear newer.
+It's sometime necessary to work around version anomalies such as software
+project changing it's versioning scheme, but also packaging errors.
+
+The epoch should be only used as a last resort. It violates the principle
+of least surprise, and changing it requires all related versioned
+dependencies in other packages to be updated accordingly.
+
+## Comparing
+Two _EVR_'s are compared left to right, component at a time.

Getting rid of the ' required a bit of an undocumented scdoc feature: `_EVR_\s` - otherwise it'd ignore the latter `_` to end the underlining. scdoc renders that the way we want it to so hopefully it renders okay in the web too.

-- 
Reply to this email directly or view it on GitHub:
https://github.com/rpm-software-management/rpm/pull/3885#discussion_r2315075397
You are receiving this because you are subscribed to this thread.

Message ID: <rpm-software-management/rpm/pull/3885/review/3175093520 at github.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rpm.org/pipermail/rpm-maint/attachments/20250901/840907be/attachment.htm>