bug-texinfo
[Top][All Lists]
Advanced

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

Re: Command names in index of Texinfo manual


From: Karl Berry
Subject: Re: Command names in index of Texinfo manual
Date: Tue, 10 Feb 2015 01:21:43 GMT

    A few times I have struggled to find the documentation of some
    Texinfo commands (like @w, or @c) because there isn't an index entry

I implemented a consistency check for @findex vs. the command list in
doc/texinfo/refcard/txicmdcheck and added a number of index entries as a
result.  Most were simple omissions.  I'm not sure that having every
single @def...x command as an index entry is really helpful, but I added
them anyway for completeness.

    which is the command name exactly.  (Pressing ic<ret> in the info
    browser takes you to the node "Printing Indices and Menus".)

Well, this seems like a separate issue.  Because there are many (30 or
so) index entries besides the previously-discussed @c and @w where the
manual intentionally has some explanatory text.  For example:

@findex H @r{Hungarian umlaut accent}

And when I type iH<TAB> in the standalone Info browser (from dev
sources), that entry appears first in the list.  But when I hit RET, it
goes to the "@- @hyphenation" node.  I don't know why, but it doesn't
seem right.  I couldn't easily check current Emacs Info behavior at the
moment.

In any case, I don't want to delete all those glosses, since I think
they are useful information for readers.  Seems like the tools should be
able to deal.

k



reply via email to

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