Hello,
proposed patch which updates info documentation about version sort (to reflect
filevercmp behavior) is attached.
Kamil
From 6ae36e04df4db674ab2022c12df0319b768260dd Mon Sep 17 00:00:00 2001
From: Kamil Dudka <kdu...@redhat.com>
Date: Wed, 25 Feb 2009 10:10:36 +0100
Subject: [PATCH] update info documentation about version sort
* doc/coreutils.texi: Reflect current filevercmp behavior.
---
doc/coreutils.texi | 22 +++++++++++++---------
1 files changed, 13 insertions(+), 9 deletions(-)
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 2c1fae5..c65927d 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -6661,21 +6661,25 @@ 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:
+The file names are compared in a way that if VER1 and VER2 are version numbers
+and PREFIX and SUFFIX (SUFFIX defined as (\.[A-Za-z][A-Za-z0-9]*)*) are strings
+then VER1 < VER2 implies that file "PREFIX VER1 SUFFIX" is before
+"PREFIX VER2 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.
-...@xref{string/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 the @code{fileverscmp} function
+from gnulib. One result of that implementation decision is that @code{ls -v}
+and @code{sort -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}.
@node General output formatting
@subsection General output formatting
--
1.6.1.2
_______________________________________________
Bug-coreutils mailing list
Bug-coreutils@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-coreutils
