Re: Broken refs

[Reinhold Kainhofer]

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

Am Donnerstag, 6. August 2009 13:46:33 schrieb Francisco Vila:
> 2009/8/6 Graham Percival <address@hidden>:
> > As for the "one big HTML" docs, I'd suggest that it @ref to the
> > splitted general html. 

No, big pages should link to the other big pages. That's how the current .init 
file is supposed to work. If it doesn' t, then that' s a bug in the script and 
needs to be fixed.

> > That said, I've never been a fan of the
> > "one big html" stuff, so if anybody who uses that wants to argue
> > that we *should* create one big general.html... 

Why one large file? I thought it should be one large file per manual, with the 
xrefs going between those large files.

> > and if that person
> > wants to patch the init script or whatever so that we generate
> > such a file... then I won't object.
>
> I'm not sure to understand it well. A reader of the big page does not
> want him to be taked off from there to a splitted page, but rather
> stay on the document him/her is reading.

Yes, that' s how the script is supposed to work. Links within the manual 
should point to the anchor in the same file, xrefs to other manuals point to 
the anchor in the other big file.

Or am I misunderstanding what is being said?

Cheers,
Reinhold
- -- 
- ------------------------------------------------------------------
Reinhold Kainhofer, address@hidden, http://reinhold.kainhofer.com/
 * Financial & Actuarial Math., Vienna Univ. of Technology, Austria
 * http://www.fam.tuwien.ac.at/, DVR: 0005886
 * LilyPond, Music typesetting, http://www.lilypond.org
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iD8DBQFKesPVTqjEwhXvPN0RAk7cAKCR1IdZHvWo5AZEEoOSU/Pp6JkncQCeOUJV
/6zJdkWBq3Okb7+kvCVvUo8=
=txGx
-----END PGP SIGNATURE-----