GNU bug report logs - #18428
coreutils binary breaks coreutils documentation

Previous Next

Full log

View this message in rfc822 format

From: Assaf Gordon <assafgordon <at> gmail.com>
To: Michael Stone <mstone <at> debian.org>, Pádraig Brady <P <at> draigBrady.com>, 760861 <at> bugs.debian.org
Cc: 18428 <at> debbugs.gnu.org, Bob Proulx <bob <at> proulx.com>
Subject: bug#18428: Bug#760861: bug#18428: Bug#760861: bug#18428: coreutils binary breaks coreutils documentation
Date: Tue, 09 Sep 2014 12:58:14 -0400

On 09/09/2014 10:52 AM, Michael Stone wrote:
> On Tue, Sep 09, 2014 at 03:31:35PM +0100, Pádraig Brady wrote:
>> It's useful to many, but I agree most don't bother with it
>> due to the awkward non intuitive default info reader _interface_
>> (though pinfo is a bit better in that regard).
>
> Right. I've heard the argument for 15 years that info docs are really good, it's just the interface. :) In all that time, a better interface hasn't really caught on, and the web happened.
>
>> Though it would be better to have direct links.
>> Now the above full node URL is too long/awkward, so I've just now setup redirects,
>> so the following proposed new trailers for ls --help and man pages should work:
>>
>> ls --help:
>>  ...
>>  Full documentation online at: <http://www.gnu.org/software/coreutils/ls>
>>  Full installed documentation: info '(coreutils) ls invocation'
>
> A huge improvement. I suspect that this might also help the info docs show up in google, instead of being below the fold. Alternative wording:
>
>    Full documentation online at: <http://www.gnu.org/software/coreutils/ls>
>    or available locally via: info '(coreutils) ls invocation'
>

BTW,
 "http://gnu.org/s/"  redirects to "http://www.gnu.org/software/" ,
so
 http://gnu.org/s/coreutils/ls

also works.

Previous Next

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