actual directories under /doc. This broke inter-document links if
you started at http://www.freebsd.org/{FAQ,handbook}, instead of the
longer .../doc/en_US.ISO8859-1/books/{faq,handbook}, and has caused a
steady stream of complaints to -doc.
Instead, have a static index.html in both those directories with a
http-equiv="refresh" that points people to the right place.
Adjust the build process to take account of this.
* Use make variables instead of hard coding commands, paths, and
options.
* Wrap some long lines.
* Replace shell loops with make for loops, etc.
PR: docs/31132
Submitted by: Cyrille Lefevre <clefevre@citeweb.net>
same naming scheme as that used by the doc/ repo.
Update docs.sgml to point to the documentation in this canonical location.
Update the FAQ/ and handbook/ directories to use symlinks to point to
the real documentation under doc/en_US.ISO_8859-1/. This means that local
testing of the site (and mirrors) will still work as expected using the
legacy URLs. Mirrors that expect to see a lot of traffic are advised to
alter their web server configuration so that $WEBROOT/FAQ and $WEBROOT/handbook
are redirected to $WEBROOT/doc/en_US.ISO_8859-1/books/{faq,handbook},
instead of relying on the symlinks.
Discussed on: doc, www
