[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: syntax changes before beta version
From: |
Reinhold Kainhofer |
Subject: |
Re: syntax changes before beta version |
Date: |
Mon, 21 Jul 2008 02:20:36 +0200 |
User-agent: |
KMail/1.9.9 |
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Am Sonntag, 20. Juli 2008 schrieb John Mandereau:
> On 2008/07/19 21:19 +0200, Reinhold Kainhofer wrote:
> > Okay, I've now added the script buildscripts/extract_texi_filenames.py to
> > create that list (tab-separated file with entries
> > NODENAME\tFILENAME\tANCHORNAME). I took the texi-gettext.py file and
> > adjusted it (basically rewrote everything, but the ideas can still be
> > seen in my script).
>
> This sounds good. I'll compile and look at dev/texi2html tomorrow or
> later, to see what you did and what I can do.
Okay. BTW, I've now added this script to the makefiles and also added
the %_xref.map file as dependency for the %.html file in
Documentation/user/GNUmakefile.
I tried adding the *_xref.map files to the local-WWW-1 target in
texinfo-rules.make, but for some unknown reason this did not have any effect,
so I added it to Documentation/user/GNUmakefile.
If you build the dev/texi2html branch, don't worry about the excessive debug
output, which is in the init file, because I've not yet managed to properly
load the map files.
> > and where $(XREF_MAP_FILES) as prerequisites for a target?
>
> in texinfo-targets.make, e.g.
>
> local-WWW-1: $(XREF_MAP_FILES) [[other possibly existing prerequisites]]
Unfortunately, this didn't have any effect for me...
> > The only issue that I see with the makefiles is that if one .tely file
> > changes a node name, where other manuals point to, how can we make sure
> > that those other manuals get rebuilt with the new link target file name?
> > The *_xref.map file for that changed manual will be updated, but I don't
> > see a way to automatically rebuild the other manuals except by adding all
> > _xref.map files as prerequisites for all texinfo files. This would then
> > mean that just one node name change would trigger a rebuild of all .html
> > files, which is far from ideal...
>
> I can't see a reasonable solution other than adding _xref.map files
> as prerequisites. The best thing for compiling the documentation would
> be to write yet another script which would write .dep files as needed to
> force regenerating docs compilation, but there are much more important
> issues IMHO.
Well, for now I'd say we can also ignore this problem. a clean doc build will
always work correctly,
> We have one Texinfo document (called 'lilypond-snippets') in input/lsr,
> and all other in Documentation/user. We want to share info for cross
> references between all these documents, so the best place is to create a
> new directory at <top-dir>/out. Of course, this requires adding a -I or
> --include option so that texi2html finds the _ref.map files.
>
> For a simpler solution, we could just turn off cross-references advanced
> resolution you implemented from and to lilypond-snippets, which would
> work with cross-references we currently use.
If the init file can't find a map file, it will default to the standard target
naming...
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)
iD8DBQFIg9ZXTqjEwhXvPN0RAvs8AKCrl7W56XczRhr+mxce7h03qD6/xQCgp2jd
2Yp3oJcKRae9aq1G4Rj5QD4=
=8n3D
-----END PGP SIGNATURE-----
- Re: syntax changes before beta version, (continued)
- Re: syntax changes before beta version, John Mandereau, 2008/07/19
- Re: syntax changes before beta version, Francisco Vila, 2008/07/19
- Re: syntax changes before beta version, Reinhold Kainhofer, 2008/07/19
- Re: syntax changes before beta version, John Mandereau, 2008/07/19
- Re: syntax changes before beta version, Francisco Vila, 2008/07/19
- docs css file, Graham Percival, 2008/07/19
- Re: docs css file, Valentin Villenave, 2008/07/20
- Re: docs css file, Graham Percival, 2008/07/20
- Re: syntax changes before beta version, Reinhold Kainhofer, 2008/07/19
- Re: syntax changes before beta version, John Mandereau, 2008/07/19
- Re: syntax changes before beta version,
Reinhold Kainhofer <=
- Re: syntax changes before beta version, John Mandereau, 2008/07/21
Re: syntax changes before beta version, Reinhold Kainhofer, 2008/07/13