Hi,
On Sun, Sep 11, 2005, W. Borgert wrote:
> Certain files in the source archive are not really sources. In
> almost all files under
> /usr/share/xml/docbook/stylesheet/db2latex/latex/common/, it is
> stated, that "Developers should not commit sundry patches
> against this file. The source file (with documentation!) is in
> the admin directory." The admin directory seems to be in
> upstream CVS only. (I have to check that, currently sf.net is
> not available.)
>
> To us, it is important to build from the real sources, because
> we get useful translation patches, that should be integrated at
> the right place, not in generated files.
So, I had a look at this old bug, and did the following:
- exported admin/gentext from CVS and copied it to the Debian source
- tried updating xsl/common from admin/gentext stuff
My conclusions so far:
- it seems that admin/gentext is a self-contained piece which is about
having overrides files for stuff not in the main docbook-xsl; IOW, it
permits defining some additional translations and/or keys which are
not in the upstream docbook-xsl
- if you install docbook-xsl, you can try to call "make
GENTEXT_DIR=/usr/share/xml/docbook/stylesheet/nwalsh/common" from
admin/gentext to update xsl/common
- it seems that these three lines wont pass this update process anymore
with current docbook-xsl (below "xref-number"):
<template name="appendix"><Appendix/> %n</template>
<template name="chapter"><Chapter/> %n %t</template>
<template name="reference"><Reference/> %n</template>
(I don't understand why.)
- the above appendix/chapter/reference appear in de/en/es/fr.xml, all
the other files seem quite empty
- the above process is based on xsl/merge.xsl and xsl/xsl.xsl
- there's also a process to import new translation files when they are
added on the docbook side, it happens during make all automatically,
but it is borken as well for other reasons
My global feeling is that db2latex is dead upstream and didn't catch up
with the latest docbook changes, and I would suggest changing db2latex
to use docbook-xml directly.
I lack the skills, time, and interest to do so, but I'm sending this
here to save other people from the investigation.
Cheers,
--
Loïc Minier <[EMAIL PROTECTED]>
