[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#18428: coreutils binary breaks coreutils documentation

From: Pádraig Brady
Subject: bug#18428: coreutils binary breaks coreutils documentation
Date: Mon, 08 Sep 2014 22:27:29 +0100
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130110 Thunderbird/17.0.2

On 09/08/2014 08:30 PM, Pádraig Brady wrote:
> On 09/08/2014 07:12 PM, Andreas Schwab wrote:
>> Bob Proulx <address@hidden> 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.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]