Re: Docs: Using backslashed in node names causes problems with pdf and texi2html ("The \override command")

[Reinhold Kainhofer]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am Dienstag, 12. August 2008 schrieb Werner LEMBERG:
> > >> Although the texinfo manual does not explicitly forbid it, using
> > >> backslashes in node names causes problems with both texi2pdf and
> > >> texi2html:
> > >
> > > That's a pity, but if that's the technical limitation, that's the
> > > technical limitation.
> >
> > Is there a way to print this character another way, for instance by
> > embedding some tex magic code such as $\backslash$ ?
>
> As far as I can see, this is about *node names* which aren't printed
> at all.

Yes and no: You are right, this is about node names and as such they are not 
printed on their page (the section title is, which allows markup). However, 
the node name will be shown in links to those nodes.

Unfortunately, with our current way of using @rlearning etc, I don't know any 
way to get the links to show backslashes...

The @ref command has a third argument, which controls the displayed text, but 
our definitions in macros.texi don't use this third argument. 
Unfortunately, using @ref directly is also no option because (1) it breaks 
with big-page and (2) if we ever change the names of our manuals, we'll have 
to go through all the documentation and the point of using macros.itexi is 
made mood.

The only solution I see is to also define two-argument macros similar to 
@rlearning and the like, where the second argument gives the displayed text. 
These could then also be used in the "About ....." sections of the LM (see my 
other mail "Uses of @ref for xrefs in our docs" to the list).

Cheers,
Reinhold


- -- 
- ------------------------------------------------------------------
Reinhold Kainhofer, Vienna University of Technology, Austria
email: address@hidden, http://reinhold.kainhofer.com/
 * Financial and Actuarial Mathematics, TU Wien, http://www.fam.tuwien.ac.at/
 * K Desktop Environment, http://www.kde.org, KOrganizer maintainer
 * Chorvereinigung "Jung-Wien", http://www.jung-wien.at/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFIofxeTqjEwhXvPN0RAjcbAJ9GgsYTcEUrd5Yh2SOF+KMsnWdqKQCeICQo
2wAaPlwqwJmI2nEiltv5I34=
=IzNm
-----END PGP SIGNATURE-----