GNU bug report logs - #5991
[bug#5958 PATCH] docs: document translation of obsolete sort syntax

Previous Next

Package: coreutils;

Reported by: Eric Blake <eblake <at> redhat.com>

Date: Tue, 20 Apr 2010 22:34:01 UTC

Severity: normal

Merged with 5958

Fixed in version 8.5

Done: Eric Blake <eblake <at> redhat.com>

Bug is archived. No further changes may be made.

Full log

View this message in rfc822 format

From: Jim Meyering <jim <at> meyering.net>
To: Pádraig Brady <P <at> draigBrady.com>
Cc: Eric Blake <eblake <at> redhat.com>, 5991 <at> debbugs.gnu.org
Subject: bug#5991: [bug#5958 PATCH] docs: document translation of obsolete sort syntax
Date: Wed, 21 Apr 2010 11:19:43 +0200

Pádraig Brady wrote:
> On 20/04/10 23:33, Eric Blake wrote:
>> * doc/coreutils.texi (sort invocation): Mention the conversion.
>> How about this followup, copying the comment from Pádraig's patch into
>> our documentation?

Thanks.

>> diff --git a/doc/coreutils.texi b/doc/coreutils.texi
...
>> +The sequence @samp{sort +@var{a}.@var{x} -@var{b}.@var{y}}
>> +translates to @samp{sort -k <at> var{a+1}.@var{x+1},@var{b}} if @var{y}
>> +is @samp{0} or absent, otherwise it translates to @samp{sort
>> +-k <at> var{a+1}.@var{x+1},@var{b+1}.@var{y}}.
>
> Looks good.
> Hopefully this will encourage people to change from the old to new format.
> Perhaps s/translates/is equivalent/; s/-k/-k /;

Another suggestion, to make it clearer why you'll want to convert:

s/The/The obsolete/
This bug report was last modified 15 years and 35 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.