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

Previous Next

Full log

Message #14 received at 18428 <at> debbugs.gnu.org (full text, mbox):

From: Pádraig Brady <P <at> draigBrady.com>
To: Andreas Schwab <schwab <at> linux-m68k.org>
Cc: 18428 <at> debbugs.gnu.org, 760861 <at> bugs.debian.org
Subject: Re: bug#18428: coreutils binary breaks coreutils documentation
Date: Mon, 08 Sep 2014 22:27:29 +0100

On 09/08/2014 08:30 PM, Pádraig Brady wrote:
> On 09/08/2014 07:12 PM, Andreas Schwab wrote:
>> Bob Proulx <bob <at> proulx.com> writes:
>>
>>> For instance, in the touch(1) man page:
>>>
>>>   The full documentation for touch is maintained as a Texinfo manual.  If
>>>   the info and touch programs are properly installed at  your  site,  the
>>>   command
>>>
>>>          info coreutils 'touch invocation'
>>>
>>>   should give you access to the complete manual.
>>>
>>> This is now incorrect (as of 8.23?), because it gives the page:
>>
>> "info touch" still works, which is equivalent to "info '(coreutils)touch
>> invocation'".
>>
>>> Note: Since the coreutils utility doesn't seem to exist in Debian, this
>>> section could be removed, but this problem may reappear in the future.
>>> So, it's better to use the capital letter C.
>>
>> Having info dir entries only differing in case seems like a bad idea.
> 
> I agree.
> 
> We could rename the node, but the bracketed form works well
> without the need for any extra quoting. I.E. this is unambiguous:
> 
>   info '(coreutils) stat invocation'
> 
> The following simple patch implements that.

Another advantage of this more canonical form
is that the pinfo curses info viewer can parse it.

Pádraig.

Previous Next

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