-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Although the texinfo manual does not explicitly forbid it, using backslashes
in node names causes problems with both texi2pdf and texi2html:
- -) texi2pdf throws an error (I don't know why, because "@" is the command
prefix and not "\" ...). We never ran into this problem yet, because we
don't create PDFs for translated manuals yet. The only place with a link to a
node with a backslash ("The \override command") is in the German and French
translations of tweaks.itely (but not in the original English version...)
- -) texi2html will simply remove the backslash if it is used in a macro call
(i.e. @ruser{The \override command} does the same as @ruser{The override
command} and thus points to a non-existing file/anchor).
makeinfo --html and texi2html will generate links to the correct anchors for
links when called with @ref.
However, backslashes will also cause problems if they are used in macro
arguments (and all our external refs ARE called through macro arguments).
Here, also texi2pdf and makeinfo --html fails...
As a solution I propose to remove the backslash from the node names and the
xrefs, so links will work. They can/should stay in the section titles, which
are not used for the links anyway. There they don't cause any errors anyway.
We already use node names with the @code removed, so this should not be an
issue. The only thing is that the file names will be different, but I don't
regard this as an issue, either, since all links within our docs are
automatically generated anyway.
Cheers,
Reinhold
PS: To see the problem, simply try to run the attached file with texi2html,
texi2pdf and makeinfo --html. The correct anchor would
be "The-_005coverride-command" for all links, but neither translator manages
to do this...
- --
- ------------------------------------------------------------------
Reinhold Kainhofer, Vienna University of Technology, Austria
email: [EMAIL PROTECTED], 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)
iD8DBQFIoKR3TqjEwhXvPN0RArKwAKCl72shH8Sv7cE5Vlf2pv17q6DsbwCfRD+O
SNkFbBKgKf1VRC2JcpdNq/0=
=c73h
-----END PGP SIGNATURE-----
\input texinfo @c -*-texinfo-*-
@macro ownref{TEXT}
@ref{\TEXT\,,,other-manual,Other Manual}
@end macro
@node Top
@top The backslashed in section names
Here comes a link to a section with backslash: @ref{The \override command}.
As an external link: @ownref{The \override command}.
@menu
* The \override command::
@end menu
@node The \override command
@chapter The @code{\override} command
@contents
@bye
_______________________________________________
lilypond-devel mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/lilypond-devel
