Documentation / config / versionsort.txton commit Merge branch 'tz/completion' (2850232)
   1versionsort.prereleaseSuffix (deprecated)::
   2        Deprecated alias for `versionsort.suffix`.  Ignored if
   3        `versionsort.suffix` is set.
   4
   5versionsort.suffix::
   6        Even when version sort is used in linkgit:git-tag[1], tagnames
   7        with the same base version but different suffixes are still sorted
   8        lexicographically, resulting e.g. in prerelease tags appearing
   9        after the main release (e.g. "1.0-rc1" after "1.0").  This
  10        variable can be specified to determine the sorting order of tags
  11        with different suffixes.
  12+
  13By specifying a single suffix in this variable, any tagname containing
  14that suffix will appear before the corresponding main release.  E.g. if
  15the variable is set to "-rc", then all "1.0-rcX" tags will appear before
  16"1.0".  If specified multiple times, once per suffix, then the order of
  17suffixes in the configuration will determine the sorting order of tagnames
  18with those suffixes.  E.g. if "-pre" appears before "-rc" in the
  19configuration, then all "1.0-preX" tags will be listed before any
  20"1.0-rcX" tags.  The placement of the main release tag relative to tags
  21with various suffixes can be determined by specifying the empty suffix
  22among those other suffixes.  E.g. if the suffixes "-rc", "", "-ck" and
  23"-bfs" appear in the configuration in this order, then all "v4.8-rcX" tags
  24are listed first, followed by "v4.8", then "v4.8-ckX" and finally
  25"v4.8-bfsX".
  26+
  27If more than one suffixes match the same tagname, then that tagname will
  28be sorted according to the suffix which starts at the earliest position in
  29the tagname.  If more than one different matching suffixes start at
  30that earliest position, then that tagname will be sorted according to the
  31longest of those suffixes.
  32The sorting order between different suffixes is undefined if they are
  33in multiple config files.