From owner-freebsd-doc Mon Mar 3 23:57:29 2003 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1354C37B401 for ; Mon, 3 Mar 2003 23:57:25 -0800 (PST) Received: from pcwin002.win.tue.nl (pcwin002.win.tue.nl [131.155.71.72]) by mx1.FreeBSD.org (Postfix) with ESMTP id 669A843FA3 for ; Mon, 3 Mar 2003 23:57:19 -0800 (PST) (envelope-from stijn@pcwin002.win.tue.nl) Received: from pcwin002.win.tue.nl (orb_rules@localhost [127.0.0.1]) by pcwin002.win.tue.nl (8.12.6/8.12.6) with ESMTP id h247vFoV004488; Tue, 4 Mar 2003 08:57:15 +0100 (CET) (envelope-from stijn@pcwin002.win.tue.nl) Received: (from stijn@localhost) by pcwin002.win.tue.nl (8.12.6/8.12.6/Submit) id h247vF86004487; Tue, 4 Mar 2003 08:57:15 +0100 (CET) Date: Tue, 4 Mar 2003 08:57:15 +0100 From: Stijn Hoop To: Sue Blake Cc: freebsd-doc@freebsd.org Subject: Re: keeping /usr/share/doc up to date Message-ID: <20030304075715.GA4319@pcwin002.win.tue.nl> References: <20030304003041.51869.qmail@web14007.mail.yahoo.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="RnlQjJ0d97Da+TV1" Content-Disposition: inline In-Reply-To: <20030304003041.51869.qmail@web14007.mail.yahoo.com> User-Agent: Mutt/1.4i X-Bright-Idea: Let's abolish HTML mail! Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --RnlQjJ0d97Da+TV1 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Mar 04, 2003 at 11:30:41AM +1100, Sue Blake wrote: > After upgrading I need to get an up to date handbook, faq, and preferably > the other material that resides under /usr/share/doc too. >=20 > Our Internet access is limited to web browser with passworded proxy, so I > can only get to ftp sites by point and click. Downloading each of these > book.html.tar.gz and article.html.tar.gz files, in case they might have > been updated, is tedious but doable. We do have access to a local CVS > repository here, but it only gives SGML for docs. >=20 > It would be much nicer if there existed a small simple tool that could > quietly convert the SGML to rough HTML or text during the upgrade. > We have lots of tiny gems that convert other document formats, but I > don't know of any for this task. Processing SGML seems to need several > huge and small pieces of interdependent software probably of various > origins and license types, each one requiring approval installation > documentation auditing and maintenance. That's not realistic for this sit= e. >=20 > We will face the same problem each time the systems are upgraded: > the expectation that the online documentation that appears on the OS > filesystem alongside the binaries would be approximately the documentation > that speaks for those binaries. >=20 > I think I could whip up a script that takes the checked out sgml and simp= ly > removes anything between angle brackets and presents the result as a text > file (with big thanks to the neatness of the docs writers!), but I would = be > grateful for any better suggestions. Why not FTP the doc distribution for your release? For example, get all the files from ftp://ftp.freebsd.org/pub/FreeBSD/releases/i386/4.7-RELEASE/doc and then use # DESTDIR=3D/where/you/want/the/docs # export DESTDIR # mkdir $DESTDIR # sh install.sh to install them. Sysinstall would also work, but I'm not really familiar with that. HTH, --Stijn --=20 SIGSIG -- signature too long (core dumped) --RnlQjJ0d97Da+TV1 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+ZFxbY3r/tLQmfWcRAijuAKCXDi8V3IqmkuV3UGJ9zpNn7IAvTgCeK0TP jmNIhMVDIVinAGdiSwK1fGw= =FVDr -----END PGP SIGNATURE----- --RnlQjJ0d97Da+TV1-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message