Hi,
Quite useful discussion ... please read on :-)
On Sat, Jan 09, 2010 at 12:34:14AM +1100, Craig Small wrote:
> Hello,
> Well there originally was a big long email here, and then I noticed
> this:
>
> maint-guide.fr.sgml:
> <sect id="debuild">
> <heading>
> La commande <prgn>debuild</prgn>
> </heading>
>
> maint-guide.sgml:
> <sect id="debuild">The <prgn>debuild</prgn> command
>
> Should the French document have those heading tags? Only it and some
> parts of the Russian document have it.
It does not seem to matter, since both are parsed as the same thing
by debiandoc2* (at least for HTML).
At least that was what I understand as maintainer. <heading> is undocumented
tag in
debiandoc-sgml-doc but widely used by old debiandoc-sgml documents. If
that cause problem, drop them.
> Anyhow, here is the rest of the most-likely useless email....
> ----------------------
Oh no, your latex is good. (I am debiandoc-sgml maintainer too.)
> Following up on this bug, putting in a -v flag gives this:
>
> Chapitre 6.
> [31]
> ! Undefined control sequence.
> \...@old@sect ...sname }\fi #7}\else \def \...@svsechd
> {#6{\hskip #3\relax
> \...@svse...
> l.1988 ...FDP\texttt{debuild}\AutoSpaceBeforeFDP}}
>
> )
>
> I ran debiandoc2latex and then latex maint-guide.fr.tex and found
> it's this line:
> \section{La commande
> {\NoAutoSpaceBeforeFDP\texttt{debuild}\AutoSpaceBeforeFDP}}
> \label{s-debuild}
>
> It's the \NoAutoSpaceBeforeFDP within the \section area. If I
> comment/delete those lines it builds fine, until it hits the next one.
> Alternatively:
> \section{La commande {\texttt{debuild}}}
> works fine too.
I see. This comes from somewhere like:
$ pwd; grep NoAutoSpaceBeforeFDP *
/usr/share/perl5/DebianDoc_SGML/Format
LaTeX.pm: output( "{\\NoAutoSpaceBeforeFDP" ) if $locale{ 'babel' } eq
'french';
LaTeX.pm: output( "{\\NoAutoSpaceBeforeFDP" ) if $locale{ 'babel' } eq
'french';
LaTeX.pm: output( "{\\NoAutoSpaceBeforeFDP" ) if $locale{ 'babel' } eq
'french';
LaTeX.pm: output( "{\\NoAutoSpaceBeforeFDP" ) if $locale{ 'babel' } eq
'french';
> The following lines work ok, so it seems these FDP macros don't like
> being inside \section{} :
I found tagging within section headings were problematic. I know info
also had issues. Anyway, this is bug of debiandoc-sgml.
I recommend you to avoid using tags causing problem as workaround. (Or
give me patch for debiandoc-sgml)
> Vous pouvez automatiser encore plus le processus de construction avec
> la commande {\NoAutoSpaceBeforeFDP\texttt{debuild2}\AutoSpaceBeforeFDP}.
> Voir {\NoAutoSpaceBeforeFDP\texttt{debuild(1)}\AutoSpaceBeforeFDP}.
>
> The english document tex file looks like the following and works:
> \section{The \texttt{debuild} command}
>
> So for some reason debiandoc2latex puts that unknown command in. My LaTeX
> is a bit rusty but I do recall things behave differently inside
> \section{} areas.
There are several idiosyncrasies with debiandoc-sgml. Since documents
are written to cope with them, "fixing" it sometimes causes problem too.
So I am keeping them as is. My package maintenance was mostly to add
new language support. You can file bug but it will be wontfix (or
I_can_not_fix) unless it comes with patch and patch looks safe.
This is another reason to rewrite the whole thing in docbook xml. (Auto
conversion does most of the work.)
Osamu
PS: Martin, this XML conversion may be fun for you.
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
