From owner-freebsd-questions@FreeBSD.ORG Mon Jan 5 19:07:17 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 73FD216A4CE for ; Mon, 5 Jan 2004 19:07:17 -0800 (PST) Received: from rwcrmhc11.comcast.net (rwcrmhc11.comcast.net [204.127.198.35]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4386D43D41 for ; Mon, 5 Jan 2004 19:07:16 -0800 (PST) (envelope-from freebsd-questions-local@be-well.ilk.org) Received: from be-well.no-ip.com ([66.30.200.37]) by comcast.net (rwcrmhc11) with ESMTP id <2004010603071501300kn16ue>; Tue, 6 Jan 2004 03:07:15 +0000 Received: by be-well.no-ip.com (Postfix, from userid 1147) id 548BA3A; Mon, 5 Jan 2004 22:07:15 -0500 (EST) Sender: lowell@be-well.ilk.org To: freebsd-questions@freebsd.org References: <20040105094348.J596@genisis.domain.org> <20040105150420.GR33404@submonkey.net> <44oetiig55.fsf@be-well.ilk.org> <20040105102119.H596@genisis.domain.org> From: Lowell Gilbert Date: 05 Jan 2004 22:07:15 -0500 In-Reply-To: <20040105102119.H596@genisis.domain.org> Message-ID: <44isjp22sc.fsf@be-well.ilk.org> Lines: 37 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Subject: Re: viewing sgml articles 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: Tue, 06 Jan 2004 03:07:17 -0000 Dru writes: > On Mon, 5 Jan 2004, Lowell Gilbert wrote: > > > Ceri Davies writes: > > > > > On Mon, Jan 05, 2004 at 09:48:13AM -0500, Dru wrote: > > > > > > > > What's the easiest way for an end-user to view the SGML articles in > > > > /usr/doc? Is there a viewer, or do they have to be converted to say, html > > > > first? I know they're mirrored online, but it would be nice to have the > > > > ability to read off-line. > > > > > > Install the textproc/docproj-nojadetex port and run > > > "cd /usr/doc;make install clean". > > > > > > The formatted docs will then be in /usr/share/doc. > > > > Or even just download the pre-built documentation from the FreeBSD FTP > > sites. Instructions for doing that are at the top of all of the > > pieces of documentation. > > Thanks to you both. > > I think the mist is clearing, let's see if I have this straight. The > contents of /usr/share/doc come with the system, and any cvsup'd changes > go instead into /usr/doc. If I want to merge the two, I use Ceri's > suggestion. Otherwise, I can download direct as per Lowell's suggestion. Roughly right. The documents are installed into /usr/share/doc by default. The source code for those documents can be cvsup'd, and the typical place to put them is /usr/doc. Building the documents involves a fairly substantial amount of software (although if you already use teTeX, it's not so bad). If you all you want is updates to the documents, you can download new versions easily. If you want to suggest modifications to the documents, you really should install the docproj port and its many dependencies, and build your own versions.