Re: Broken refs

[John Mandereau]

Le jeudi 06 août 2009 à 11:35 +0100, Trevor Daniels a écrit :
> > Not until we have @rweb or @rgeneral or whatever it gets called.
> > At least, that's what the @ref{Setup for MacOS X} are waiting for.
> > I admit that I could fix the @rprogram{LilyPond-book} link right
> > now if it was a priority.

Adding cross-references macros in macros.itexi should work out of the
box for HTML splitted pages and Info.  For other formats, it will
require some xref->@uref hacky conversion, as I think a web site in one
big HTML or single PDF page doesn't make much sense, does it?


> It's a python program.  I could send it to
> you, but I didn't write it for general use
> so I'm not too keen on adding it to the source
> tree without some tidying up.  There are a
> few cludges to get round the lack of machine-
> generated files in the docs.  John's got
> enough to do at the moment.  I run it every
> time I edit the docs, so I'm happy to continue
> fixing broken links as they appear.

Have you tried building docs inside the source tree, then cd into
Documentation/ and run

make check-xrefs

and/or

make fix-xrefs

?

It's currently broken for translations, but it seems to work for docs in
English, e.g. "make check-xrefs" gives

###########

../scripts/auxiliar/check_texi_refs.py --batch \
        -I . -I /home/lilydev/git/lily/master/Documentation/out-www
-I /home/lilydev/git/lily/master/Documentation/snippets
-I /home/lilydev/git/lily/master/Documentation/snippets/out-www 
../python/auxiliar/manuals_definitions.py
Reading files...
Processing manual ./notation.tely (ruser)
Processing manual ./out-www/internals.texi (rinternals)
Processing manual ./application.tely (rprogram)
Processing manual ./learning.tely (rlearning)
Processing manual ./music-glossary.tely (rglos)
Processing manual ./snippets.tely (rlsr)
Checking cross-references...

./notation/notation-appendices.itely: 939: `Fonts': external ruser x-ref
should be internal

./notation/notation-appendices.itely: 940: `Text encoding': external
ruser x-ref should be internal

./notation/notation-appendices.itely: 981: `Layout interfaces': external
ruser x-ref should be internal
Done: 7137 x-refs found, 3 bad x-refs found, fixed 0.

##########

These 3 nits should be fixed automatically by fix-xrefs BTW.

Best,
John

signature.asc
Description: Ceci est une partie de message numériquement signée