Re: Uses of @ref for xrefs in our docs

[Reinhold Kainhofer]

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

Am Montag, 11. August 2008 schrieb Reinhold Kainhofer:
> Am Montag, 11. August 2008 schrieb Graham Percival:
> > On Sun, 10 Aug 2008 18:39:11 +0200
> >
> > Reinhold Kainhofer <address@hidden> wrote:
> > > There are currently four spots, where an explicit @ref is used for a
> > > cross-reference to a different manual:
> > >
> > > changing-defaults.itely:@ref{Top,Internals
> > > Reference,,lilypond-internals}. introduction.itely:@ref{Top,Music
> > > glossary,,music-glossary}: introduction.itely:@ref{Top,LilyPond
> > > Snippet List,,lilypond-snippets}: this shows a
> > > introduction.itely:@ref{Top,Internals Reference,,lilypond-internals}:
> > > this is a set
> > >
> > > While this seems to work at first glance, it breaks with bigpage. Can
> > > anyone fix those four references (and of course the corresponding
> > > translations!) to use @rglos, @rlsra and @rinternals.
> >
> > What node name would we use?  If we use @rglos{top}, would it
> > appear as "Music glossary" (what we want), or "top"?
>
> Currently with texi2html it appears as "Top" anyway ;-) I'll have to find a
> solution for this.

FWIW, the PDF files are also broken. They display:
"About the Snippet List (SL)
<undefined> [Top], page <undefined>: this shows a selected set of LilyPond 
snippets from the LilyPond Snippet Repository (LSR). All the snippets are in 
the public domain."

According to the texinfo manual, the fact that makeinfo --html produces only 
the name of the link as text is not really following the definition:
http://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#Four-and-Five-Arguments

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.9 (GNU/Linux)

iD8DBQFIoHXMTqjEwhXvPN0RArlRAKC2xWFHyOl+qkTo3Bwx+fPaM2FhCwCeNwTV
Kz+CHhtuho8w5bWWZQ+mheE=
=HNlt
-----END PGP SIGNATURE-----