The doc pages link three text files the install puts out of their reach

[xroche]

The doc pages link ../license.txt, ../greetings.txt and ../history.txt. Those three files sit at the repo root and index.html sits in html/, so in the source tree the ../ is right. tools/doc-links.py has checked exactly that for years. The install put the same three files beside index.html instead, so there the ../ walked one level too high and all three dangled. #1474 recorded it as a known gap, because no static href satisfies both trees.

htmldir now defaults to $(docdir)/html rather than autoconf's $(docdir), and the three text files install into $(docdir) alone. The installed tree then has the shape the source tree has, so both checkers agree. Fedora already passes exactly this. Another --htmldir still works, and test 382 reports those links as a gap of that layout rather than as a failure.

Debian inverts the layout: debian/rules makes the pages real under /usr/share/httrack/html and turns /usr/share/doc/httrack/html into a symlink pointing at them. It did that by moving all of $(docdir). That now carries the three text files along and leaves the pages one level too deep, so dh_movefiles loses /usr/share/httrack/html/server and the deb build fails. It moves $(docdir)/html instead, and the step that moved httrack-doc.html back out is gone.

Two more things follow from $(docdir) being a real doc directory on Debian. dh_installchangelogs already ships history.txt there as changelog.gz, so the copy is a duplicate lintian rejects, and debian/rules drops it. dh_compress would gzip license.txt, so -X.txt keeps the two remaining files at the names the pages link. The Debian package therefore fixes two of the three links and leaves ../history.txt dead, where all three were dead before. Getting the third back means shipping the changelog twice.

Two more things fall out of the move. history.txt was in both HelpHtmlroot_DATA and HelpHtmlTxt_DATA, which were the same directory by default, so a parallel make install could send two rules at one path. That failed once in about 35 attempts and dates back to 3.30.1. And httrack-doc.html's link to html/index.html was broken for the mirror-image reason. Test 382 now walks $(docdir) as well as $(htmldir) to catch it.

Checked by staging installs. Master and this branch install the same 289 files and ship the same 997 in make dist. make uninstall leaves nothing behind, and the duplicate write of history.txt is gone. Four layouts pass for the right reason. The default resolves 605 links across 64 pages with nothing dangling. A flat --htmldir and one outside $(docdir) record their gaps, and $(docdir)/foo still scans all 64 pages. Three mutants die: a missing license.txt, a link to a page that is not installed, and a staged page from no source file. The Debian half was built for real, in a clean sid chroot holding only the declared Build-Depends. tools/mkdeb.sh --sbuild comes back Status: successful on this branch and on the merge base, 412 tests and no lintian hint.

Packagers get a new default path for the HTML documentation, noted in PACKAGING.md.