Source: dict-jargon
Followup-For: Bug #914542
X-Debbugs-Cc: [email protected]
I've investigated what is required to generate the Tex Info file and what
blocks it.
In theory this command should be sufficient but it generates a lot of
errors apparently due to not using the correct XML stylesheet:
$ docbook2x-texi jargon.xml
It's man-page in section CONVERSION PROCESS details the two steps the
tool wraps and following the first step has less problems and may be the
basis to proceed:
$ db2x_xsltproc --stylesheet texi -o jargon-translated.txml jargon.xml
jargon.xml:525: parser error : Entity 'rsqyuo' not defined
same way as a CB ‘handle&rsqyuo;. Login names are often used as
^
warning: failed to load external entity "names.xml"
error : xmlAddEntity: invalid redeclaration of predefined entity
docbook2texi:/book: no description for directory entr
Focusing on the external entity "names.xml" (from jargon.xml preamble)
<!ENTITY names SYSTEM "names.xml">
"names.xml" is generated via the original 'jargon' file Makefile rule:
# This is needed for the book version
names.xml: jargon.xml
name-extract <jargon.xml >names.xml
but "name-extract" is a script (in unknown language) documented in the
jargon Makefile's:
TOOLS = replace overwrite pagemaker nbreak.c pagemaker getversion \
name-extract wraptext
and referred to in jargon.xml comment:
<!-- The point of listing them here is so the name-extract script will do -->
This is in the context of a list of contributors to the jargon file that
are not related to specific entries and are listed at the end of
jargon.xml in the format:
<!-- from *Hobbit* <[email protected]>, -->
The problem here is that "names.xml" is a temporary generated file and I
can find no instances of it or "name-extract" anywhere.
Returning to the first step, if we use the stylesheet provided in the
jargon file source ("jargsrc.tar.gz") we seem to get further (although
there is no jargon file documentation to say this stylesheet should be
used):
$ sed -i 's#\(docbook-xsl-\)1.61.0#\11.62.4#' jargon.xsl
$ db2x_xsltproc --stylesheet ./jargon.xsl -o jargon-translated.xml jargon.xml
jargon.xml:525: parser error : Entity 'rsqyuo' not defined
same way as a CB ‘handle&rsqyuo;. Login names are often used as
^
warning: failed to load external entity "names.xml"
Error: no glossentry for glossterm: hacking.
Error: no glossentry for glossterm: network, the.
Error: no glossentry for glossterm: wallpaper.
But that still has problems and they seem to be related to the state of
the jargon source package being broken - note how "jargon.xsl" needs a
"sed" operation to correct its reference to the docbook version included
in the source, let alone the actual XSL errors.
I've put out a request for "name-extract" and/or "names.xml" in this
github repo that generates jargon file and has the original source as in
"jargsrc.tar.gz"
https://github.com/agiacalone/jargonfile/issues/11
