From: Eric Blake <eblake@redhat.com>
Date: Tue, 20 Apr 2010 22:26:27 +0000 (-0600)
Subject: docs: document transformation of obsolete sort syntax
X-Git-Tag: v8.5~4
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=a9b904a282b5ca61c9a1f41389832747689ed9cf;p=platform%2Fupstream%2Fcoreutils.git

docs: document transformation of obsolete sort syntax

* doc/coreutils.texi (sort invocation): Mention the conversion.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 7561f2a..f40993e 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -4126,6 +4126,11 @@ is counted from the first nonblank character of the field.
 @vindex POSIXLY_CORRECT
 On older systems, @command{sort} supports an obsolete origin-zero
 syntax @samp{+@var{pos1} [-@var{pos2}]} for specifying sort keys.
+The obsolete sequence @samp{sort +@var{a}.@var{x} -@var{b}.@var{y}}
+is equivalent to @samp{sort -k @var{a+1}.@var{x+1},@var{b}} if @var{y}
+is @samp{0} or absent, otherwise it is equivalent to @samp{sort -k
+@var{a+1}.@var{x+1},@var{b+1}.@var{y}}.
+
 This obsolete behavior can be enabled or disabled with the
 @env{_POSIX2_VERSION} environment variable (@pxref{Standards
 conformance}); it can also be enabled when @env{POSIXLY_CORRECT} is