[xml/sgml-pkgs] Bug#327616: db2latex-xsl: admin directory missing in source archive

[Loïc Minier]

        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/>&#160;%n</template>
      <template name="chapter"><Chapter/>&#160;%n %t</template>
      <template name="reference"><Reference/>&#160;%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 <lool at dooz.org>