Bug#717944: apt-doc: footnotes.html href back-links

[Kamil Ignacak <acerion@wp.pl>]

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.

Kamil