From owner-freebsd-questions@FreeBSD.ORG Fri Aug 6 18:49:27 2004 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 527A916A4CE for ; Fri, 6 Aug 2004 18:49:27 +0000 (GMT) Received: from smtp.infracaninophile.co.uk (smtp.infracaninophile.co.uk [81.2.69.218]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5619343D3F for ; Fri, 6 Aug 2004 18:49:26 +0000 (GMT) (envelope-from m.seaman@infracaninophile.co.uk) Received: from happy-idiot-talk.infracaninophile.co.uk (localhost.infracaninophile.co.uk [IPv6:::1])i76InN2Z091789 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 6 Aug 2004 19:49:23 +0100 (BST) (envelope-from matthew@happy-idiot-talk.infracaninophile.co.uk) Received: (from matthew@localhost)id i76InNsm091788; Fri, 6 Aug 2004 19:49:23 +0100 (BST) (envelope-from matthew) Date: Fri, 6 Aug 2004 19:49:23 +0100 From: Matthew Seaman To: Tom Munro Glass Message-ID: <20040806184922.GA91576@happy-idiot-talk.infracaninophile.co.uk> Mail-Followup-To: Matthew Seaman , Tom Munro Glass , freebsd-questions@freebsd.org References: <200408061541.19592.gentoo@tmgcon.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="AhhlLboLdkugWU4S" Content-Disposition: inline In-Reply-To: <200408061541.19592.gentoo@tmgcon.com> User-Agent: Mutt/1.5.6i X-Greylist: Message not sent from an IPv4 address, not delayed by milter-greylist-1.5.3 (smtp.infracaninophile.co.uk [0.0.0.0]); Fri, 06 Aug 2004 19:49:23 +0100 (BST) X-Virus-Scanned: clamd / ClamAV version devel-20040705, clamav-milter version 0.74a on smtp.infracaninophile.co.uk X-Virus-Status: Clean X-Spam-Status: No, hits=-4.8 required=5.0 tests=AWL,BAYES_00 autolearn=ham version=2.64 X-Spam-Checker-Version: SpamAssassin 2.64 (2004-01-11) on happy-idiot-talk.infracaninophile.co.uk cc: freebsd-questions@freebsd.org Subject: Re: Updating local copy of documentation X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 06 Aug 2004 18:49:27 -0000 --AhhlLboLdkugWU4S Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Aug 06, 2004 at 03:41:19PM +1200, Tom Munro Glass wrote: > When you install FreeBSD, lots of useful documentation is installed in th= e=20 > articles and books directories under /usr/share/doc/ including the essent= ial=20 > handbook. >=20 > Is there a way of automatically updating this documentation - I thought t= hat=20 > maybe this was done as a part of cvsup, make buildworld, etc, but apparen= tly=20 > not? I realise that I can download the latest version with FTP, but it wo= uld=20 > be nice if this could be done as part of the normal maintenance tasks. Yes, you can update the doc sources using cvsup(1), and build them locally. You need to install one of the textproc/docproj ports (install one with jadetex if you want to be able to create PDF output), and use a supfile like so: *default host=3DCHANGE_THIS.FreeBSD.org *default base=3D/usr *default prefix=3D/usr *default release=3Dcvs tag=3D. *default delete use-rel-suffix *default compress =20 doc-all A handy way of doing that is simply to make the following settings in /etc/make.conf: SUP_UPDATE=3D yes # SUP=3D /usr/local/bin/cvsup SUPFLAGS=3D -g -L 2 SUPHOST=3D CHANGE_THIS.FreeBSD.org SUPFILE=3D /usr/share/examples/cvsup/stable-supfile PORTSSUPFILE=3D /usr/share/examples/cvsup/ports-supfile DOCSUPFILE=3D /usr/share/examples/cvsup/doc-supfile Then you can just type 'make update' in either /usr/src or in /usr/doc to pull down the latest sources. Note that will bring down the sources for all of the different language versions of the docs. If you just want the English versions, you can use a refuse file like: doc/bn_* doc/da_* doc/de_* doc/el_* doc/es_* doc/fr_* doc/it_* doc/ja_* doc/nl_* doc/no_* doc/pl_* doc/pt_* doc/ru_* doc/sr_* doc/tr_* doc/zh_* As ever, start by reading the documentation, in this the FreeBSD Documentation Project Primer: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html Note that locally built copies of the documentation end up somewhere below /usr/doc/en_US.ISO8859-1, unlike the copy of the handbook installed with the system in /usr/share/doc Cheers, Matthew --=20 Dr Matthew J Seaman MA, D.Phil. 26 The Paddocks Savill Way PGP: http://www.infracaninophile.co.uk/pgpkey Marlow Tel: +44 1628 476614 Bucks., SL7 1TH UK --AhhlLboLdkugWU4S Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (FreeBSD) iD8DBQFBE9KyiD657aJF7eIRAmiGAJ9tI7uC82aKyv7hCjyN926H9wPiSACfX5KJ NC5CO5/Q3A27C2AFxsT2CYE= =apXp -----END PGP SIGNATURE----- --AhhlLboLdkugWU4S--