From 82d4e8fc847a5ca4362f7ac334a1bacf4b768b73 Mon Sep 17 00:00:00 2001 From: Kamil Dudka Date: Fri, 13 Mar 2009 11:44:52 +0100 Subject: [PATCH] update info documentation about version sort * doc/coreutils.texi: Reflect current filevercmp behavior. --- doc/coreutils.texi | 24 +++++++++++++++--------- 1 files changed, 15 insertions(+), 9 deletions(-) diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 0bf978a..6f8c197 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -6661,21 +6661,27 @@ foo.zml-25.gz foo.zml-25.gz foo.zml-6.gz foo.zml-100.gz @end example -Note also that numeric parts with leading zeros are considered as -fractional one: +Version-sorted strings are compared such that if @var{ver1} and @var{ver2} +are version numbers and @var{prefix} and @var{suffix} (@var{suffix} matching +the regular expression @samp{(\.[A-Za-z][A-Za-z0-9]*)*}) are strings then address@hidden < @var{ver2} implies that the name composed of address@hidden @var{ver1} @var{suffix}'' sorts before address@hidden @var{ver2} @var{suffix}''. + +Note also that leading zeros of numeric parts are ignored: @example $ ls -1 $ ls -1v -abc-1.007.tgz abc-1.007.tgz -abc-1.012b.tgz abc-1.01a.tgz +abc-1.007.tgz abc-1.01a.tgz +abc-1.012b.tgz abc-1.007.tgz abc-1.01a.tgz abc-1.012b.tgz @end example -This functionality is implemented using the @code{strverscmp} function. address@hidden/Array Comparison, , , libc, The GNU C Library Reference Manual}. -One result of that implementation decision is that @code{ls -v} does not -use the locale category, @env{LC_COLLATE}. As a result, non-numeric prefixes -are sorted as if @env{LC_COLLATE} were set to @code{C}. +This functionality is implemented using gnulib's @code{filevercmp} function. +One result of that implementation decision is that @samp{ls -v} +and @samp{sort -V} do not use the locale category, @env{LC_COLLATE}, +which means non-numeric prefixes are sorted as if @env{LC_COLLATE} were set +to @samp{C}. @node General output formatting @subsection General output formatting -- 1.6.1.2