Re: Bug#762092: sha...sum man pages refer to nonexistent 'sha...sum invocation' info pages

[Eric Blake]

On 09/18/2014 08:29 AM, Eric Blake wrote:
> On 09/18/2014 08:13 AM, Pádraig Brady wrote:
>> On 09/18/2014 12:54 PM, Rebecca Palmer wrote:
>>> Package: coreutils
>>> Version: 8.23-2
>>> Severity: minor
>>> Control: tags -1 patch
>>>
>>> The man page of sha512sum states that more documentation can be found at 
>>> info coreutils 'sha512sum invocation', but this info node does not exist; 
>>> the correct name is 'sha2 utilities'.  At least sha256sum, and I suspect 
>>> all four sizes, are also affected.
> 
> Can't we add an @anchor{sha512sum invocation} and so forth into the
> .texi file, so that the GNU Coding Standards recommended interface just
> works at taking you into the right section, without having to do this
> munging of the man pages?

Maybe not; it looks like @anchor{} allows @xref and friends to work to
alias names, but doesn't add entries to the menu, and 'info' is using
just menu names for its shorthand.  I don't know [tex]info well enough
to know if what I'm suggesting is even feasible, only that I've used
@anchor in the past when renaming nodes in order to keep the rest of the
manual working where it uses @xref.

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

signature.asc
Description: OpenPGP digital signature