--- Begin Message ---
- To: Debian Bug Tracking System <maintonly@bugs.debian.org>
- Subject: apt-doc: footnotes.html href back-links
- From: Kevin Ryde <user42@zip.com.au>
- Date: Sat, 27 Jul 2013 09:59:27 +1000
- Message-id: <87k3kczxcw.fsf@blah.blah>
Package: apt-doc
Version: 0.9.9.2
Severity: minor
File: /usr/share/doc/apt-doc/guide.html/footnotes.html
footnotes.html contains a back-reference
<h2><a href="#fr2" name="f2">2</a></h2>
but it seems that #fr2 is in ch4.html, not footnotes.html. I wonder if
that link should be "ch4.html#fr2", similar to what the preceding "1"
back-reference has,
<h2><a href="ch2.html#fr1" name="f1">1</a></h2>
-- System Information:
Debian Release: 7.0
APT prefers unstable
APT policy: (990, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 2.6.32-5-486
Locale: LANG=en_AU, LC_CTYPE=en_AU (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash
-- no debconf information
--- End Message ---
--- Begin Message ---
On Sun, Mar 02, 2025 at 09:29:42PM +0100, Kamil Ignacak wrote:
> Hi,
>
> I think that this problem disappeared when a transition from SGML to
> DocBook was made. I was able to reproduce the problem in documentation
> generated from apt version 0.9.9.2 files. I was unable to reproduce the
> problem in documentation accompanying apt version 2.9.29.
>
> The conversion of the guide file's format took place in
> https://salsa.debian.org/apt-team/apt/-/commit/271733ee8eb9a673747bdef320af5ca8e8f18273.
> Few neighboring commits are also related to change of documentation
> format.
>
>
> Steps needed for successful reproduction of the problem in 0.9.9.2's
> code on trixie/sid:
>
> 1. Install debiandoc-sgml (package with debiandoc2html tool)
> 2. Checkout 209a7f8 (revision tagged with "0.9.9.2")
> 3. Build guide in html format from guide.sgml
> mkdir my_guide
> cd my_guide
> /usr/bin/debiandoc2html -l en.UTF-8 ../doc/guide.sgml
> 4. Open chapter 2 in web browser
> links guide.html/ch2.html
> 5. Find footnote link #1. Test it, observe that
> - going from main text to footnote works,
> - going from footnote back to main text works <---- no problem here
> 6. Open chapter 4 in web browser
> links guide.html/ch4.html
> 7. Find footnote links #2 and #3 to footnotes. Test them, observe that
> - going from main text to footnote works,
> - going from footnote back to main text doesn't work <---- this is
> the problem
>
> The guide only has three footnotes, with the following texts:
> 1: "If you are using an http proxy server you must..."
> 2: "The dselect method actually is a set of wrapper scripts..."
> 3: "APT however considers all known dependencies and ..."
>
>
> Steps needed for reproduction attempt in 2.9.29 on trixie/sid:
>
> 1. Install apt-doc
> 2. Go to /usr/share/doc/apt-doc/
> 3. Open chapter 2 in web browser
> links guide.html/ch2.html
> 4. Find footnote link #1. Test it, observe that
> - going from main text to footnote works,
> - going from footnote back to main text works <---- no problem here
> 5. Open chapter 4 in web browser
> links guide.html/ch4.html
> 7. Find footnote links #2 and #3 to footnotes. Test them, observe that
> - going from main text to footnote works,
> - going from footnote back to main text works <---- no problem anymore
>
> This guide has only three footnotes, with following texts:
> 1: "If you are using an http proxy server you must..."
> 2: "The dselect method actually is a set of wrapper scripts..."
> 3: "APT however considers all known dependencies and..."
>
> As you can see, in both versions of the guide (from the two versions of
> apt), the texts of the footnotes are the same, meaning that the
> structure of footnotes is the same between the document versions.
>
>
> I suggest to close this ticket as done.
Doing so, ta.
(feel free to close bugs yourself though)
--
debian developer - deb.li/jak | jak-linux.org - free software dev
ubuntu core developer i speak de, en
--- End Message ---