Install all the documentation in to a single root, $WEBROOT/doc, with the

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
This commit is contained in:
Nik Clayton 2001-04-17 09:05:43 +00:00
parent 5a16245baf
commit eab69689b8
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/www/; revision=9212
5 changed files with 87 additions and 59 deletions

13
en/doc/Makefile Normal file
View file

@ -0,0 +1,13 @@
#
# $FreeBSD: www/en/docs/Makefile,v 1.3 2001/02/24 18:04:10 nik Exp $i
#
# Build the FreeBSD documentation *outside* of the www tree, and install it
# in to the right place as necessary.
#
# This assumes that you have the www/ and doc/ trees checked out beside
# one another -- this was always the case anyway, so there are no extra
# requirements here.
#
all install clean:
(unset DESTDIR || true; cd ${.CURDIR}/../../../doc/en_US.ISO_8859-1 && ${MAKE} FORMATS=html-split DOCDIR=${DESTDIR}/data/doc ${.TARGET})