Re: Text decoration in node names and index entries

[Gavin Smith]

On 3 July 2015 at 20:51, Eli Zaretskii <address@hidden> wrote:
>> I'd like to propose that when @-commands that produce decoration
>> around text are used in node names or index entries, the decoration is
>> suppressed.
>
> I think you will take away a feature if you do that: some @-commands
> change the output in ways that cannot be given up without losing
> something.

Which @-commands did you have in mind? I've made @emph, @strong, @sub
and @sup be kept, and also anything defined with @definfoenclose. I'm
not sure what's the best.

Karl> FWIW, I agree, at least wrt quotes.  This exact issue is why I used @t
instead of @code or @samp or something else in the @node names in
texinfo.texi when I changed them to use @-commands.

It should be possible to change the @t's to something more semantic now.

I noticed that I had a warning when using a @definfoenclose in an index entry

infoenclose.texi:4: warning: @phoo should not appear in @cindex

With makeinfo 4.13, @definfoenclose does work as expected in an index entry.

Problems as well using a @definfoenclose in a node name:

tp/infoenclose.texi:5: warning: @phoo should not appear in @cindex
tp/infoenclose.texi:13: warning: @phoo should not appear in @node
tp/infoenclose.texi:13: warning: unreferenced node address@hidden'
tp/infoenclose.texi:13: warning: node `Top' is up for address@hidden' in
sectioning but not in menu
tp/infoenclose.texi:1: node `Top' lacks menu item for address@hidden'
despite being its Up target

Input:

@node Top
@top

@definfoenclose phoo,//,\\
@cindex address@hidden

@phoo{BB}

@menu
@phoo{CC}::
@end menu

@node @phoo{CC}
@chapter Chapter One

It's not documented to be allowed in the "HTML Cross Reference Command
Expansion" section of the manual, so this error isn't surprising.

Eli > This has come up before, so I suggest to look up past discussions,
> around the time the option mentioned below was introduced.
>
>> For comparison, the output of makeinfo 4.13 (using the --force option):
>
> Btw, makeinfo 4.13 has the --commands-in-node-names for this.

--commands-in-node-names was in texinfo 4.0 released September 1999,
and --force in 3.11, in July 1997. The mail archives at
https://lists.gnu.org/archive/html/bug-texinfo/ only go back to
September 2000.