From rra at debian.org  Mon Dec 29 18:29:58 2008
From: rra at debian.org (Russ Allbery)
Date: Mon, 29 Dec 2008 10:29:58 -0800
Subject: [debiandoc-sgml-pkgs] Bug#510141: debiandoc-sgml: stray <hr> in the
	middle of footnotes
Message-ID: <20081229182958.10568.83991.reportbug@windlord.stanford.edu>

Package: debiandoc-sgml
Version: 1.2.9
Severity: minor

Ronny Standtke noticed today that there's a stray <hr> tag in the middle
of the footnotes for debian-policy.  See:

http://www.debian.org/doc/debian-policy/footnotes.html#f29

I've confirmed that it's in the output generated by debiandoc-sgml the
last time I uploaded debian-policy.  There doesn't seem to be anything
weird about the relevant source for that footnote:

        The package management system manipulates data represented in
        a common format, known as <em>control data</em>, stored in
        <em>control files</em>.
        Control files are used for source packages, binary packages and
        the <file>.changes</file> files which control the installation
        of uploaded files<footnote>
            <prgn>dpkg</prgn>'s internal databases are in a similar
            format.
        </footnote>.
      </p>

but for some reason the output in footnotes.html for that note is:

<h2><a href="ch-controlfields.html#fr29" name="f29">29</a></h2>

<hr>

<p>
<code>dpkg</code>'s internal databases are in a similar format.
</p>

That's the only <hr> in the middle of the footnotes.

-- System Information:
Debian Release: lenny/sid
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: i386 (i686)

Kernel: Linux 2.6.26-1-686 (SMP w/1 CPU core)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages debiandoc-sgml depends on:
ii  libhtml-parser-perl       3.56-1+b1      A collection of modules that parse
ii  libroman-perl             1.22-2         Perl module for converting between
ii  libsgmls-perl             1.03ii-32      Perl modules for processing SGML p
ii  libtext-format-perl       0.52-21        Perl module for formatting (text) 
ii  liburi-perl               1.35.dfsg.1-1  Manipulates and accesses URI strin
ii  perl                      5.10.0-18      Larry Wall's Practical Extraction 
ii  perl-modules [libi18n-lan 5.10.0-18      Core Perl modules
ii  sgml-base                 1.26           SGML infrastructure and SGML catal
ii  sgml-data                 2.0.3          common SGML and XML data
ii  sgmlspl                   1.03ii-32      SGMLS-based example Perl script fo
ii  sp                        1.3.4-1.2.1-47 James Clark's SGML parsing tools

Versions of packages debiandoc-sgml recommends:
ii  ghostscript              8.62.dfsg.1-3.1 The GPL Ghostscript PostScript/PDF
ii  libpaper1 [libpaperg]    1.1.23+nmu1     library for handling paper charact
ii  texinfo                  4.11.dfsg.1-4   Documentation system for on-line i
ii  texlive-fonts-recommende 2007.dfsg.1-4   TeX Live: Recommended fonts
ii  texlive-latex-base       2007.dfsg.1-4   TeX Live: Basic LaTeX packages
ii  texlive-latex-extra      2007.dfsg.11-1  TeX Live: LaTeX supplementary pack
ii  texlive-latex-recommende 2007.dfsg.1-4   TeX Live: LaTeX recommended packag

Versions of packages debiandoc-sgml suggests:
pn  debiandoc-sgml-doc            <none>     (no description available)
pn  hlatex                        <none>     (no description available)
pn  latex-cjk-all                 <none>     (no description available)
pn  littex                        <none>     (no description available)

-- no debconf information




From rra at debian.org  Mon Dec 29 20:43:15 2008
From: rra at debian.org (Russ Allbery)
Date: Mon, 29 Dec 2008 12:43:15 -0800
Subject: [debiandoc-sgml-pkgs] Bug#510141: horizontal line in footnote #29
In-Reply-To: <1230581244.17997.6.camel@kaa.jungle.aubergine.my-net-space.net>
	(Adam D. Barratt's message of "Mon\,
	29 Dec 2008 20\:07\:24 +0000")
References: <200812291745.41706.Ronny.Standtke@gmx.net>
	<87iqp2ltqv.fsf@windlord.stanford.edu>
	<1230581244.17997.6.camel@kaa.jungle.aubergine.my-net-space.net>
Message-ID: <87y6xyk90c.fsf@windlord.stanford.edu>

"Adam D. Barratt" <adam at adam-barratt.org.uk> writes:
> On Mon, 2008-12-29 at 10:30 -0800, Russ Allbery wrote:

>> Huh, there is indeed, but I'm not sure why.  Those pages are generated
>> from DebianDoc-SGML source and there isn't anything strange that I can see
>> about the SGML source:
> [...]
>> I assume it must be a bug in debiandoc-sgml, but it's a very strange one.
>> I'll file a bug against that package.

> fwiw, wrapping the paragraph in a section removes the line (although
> isn't an ideal solution).

Ah, yes, that's it.  I think it's the only place in Policy where there's a
footnote inside a <p> tag that's directly inside a <chapter> and not
contained in a <section>.  The <hr> is probably supposed to be the <hr>
between the chapter heading and the paragraph and got transplanted into
the footnotes, since other chapters with <p> tags directly inside the
<chapter> have a leading <hr> before that paragraph.

-- 
Russ Allbery (rra at debian.org)               <http://www.eyrie.org/~eagle/>