cc0f196 doc: update docs to recommend "modern versioning"

2 files Authored by zbyszek 2 years ago, Committed by nphilipp 2 years ago,
    doc: update docs to recommend "modern versioning"
    
    The Packaging Guidelines have been adjusted a few months ago [1] to make use of
    tilde and caret support in rpm, and in effect significantly simplified. The
    version information about a package (including pre- and post-releases,
    snapshots, and non-sortable upstream versions) is included in the Version field,
    and the Release field is allowed to remain a simple counter (except in a few
    special cases). This actually works great with %autorelease, since there's no
    interference between the parts of Version that were embedded in the Release
    field. So it's nice to be able to describe the simplified form of versioning
    here too, since it makes %autorelease use significantly simpler.
    
    This patch mirrors the change done in the Packaging Guidelines: a description of
    "traditional versioning" is still present, but it's deemphasized and moved to a
    separate chapter. It is still allowed and useful for RHEL7- systems, but the
    simpler form is recommended.
    
    Anchors were changed in the Packaging Guidelines rewrite, so they needed to be
    adjusted.
    
    v2:
    - '-p' is also relegated to the section about "Traditional Versioning".
    
      This is correct thing for almost all packages, they shouldn't use '-p'.
      I'm aware of one exception: fedora-release uses "-p" before the final
      release. This is because fedora-release wants a version-release to be
      N-0.x and then N-y, e.g. 35-0.1, 35-0.2, 35-0.3, 35-1, 35-2, 35-3.
      But that is a very special case, and it actually does not work well. We
      currently get 35-0.1, 35-0.2, 35-0.3, 35-4, 35-5, 35-6, which is functional,
      but not pretty. In the end, it seems appropriate to "deprecate" "-p" here.
      The mechanism in fedora-release might need to be adjusted anyway.
    
    [1] https://pagure.io/packaging-committee/pull-request/1073
    
    Signed-off-by: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
    
        
file modified
+32 -6
file modified
+5 -4