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
tree -- the previous method used symlinks to try and build the book
inside the tree. The old method now fails because various support
files don't exist in the web tree. Rather than creating a nest of
symlinks, this is a simpler approach.
