From owner-freebsd-questions@FreeBSD.ORG Wed Jan 21 07:23:31 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 933DC16A4CE for ; Wed, 21 Jan 2004 07:23:31 -0800 (PST) Received: from sccrmhc13.comcast.net (sccrmhc13.comcast.net [204.127.202.64]) by mx1.FreeBSD.org (Postfix) with ESMTP id CB85C43D2F for ; Wed, 21 Jan 2004 07:23:24 -0800 (PST) (envelope-from freebsd-questions-local@be-well.ilk.org) Received: from be-well.no-ip.com ([66.30.196.44]) by comcast.net (sccrmhc13) with ESMTP id <2004012115232401600gcjfne>; Wed, 21 Jan 2004 15:23:24 +0000 Received: by be-well.no-ip.com (Postfix, from userid 1147) id A724211; Wed, 21 Jan 2004 10:23:20 -0500 (EST) Sender: lowell@be-well.ilk.org To: "Andrew L. Gould" References: <200401201007.32634.algould@datawok.com> <44r7xt4dty.fsf@be-well.ilk.org> <200401210901.46777.algould@datawok.com> From: Lowell Gilbert Date: 21 Jan 2004 10:23:20 -0500 In-Reply-To: <200401210901.46777.algould@datawok.com> Message-ID: <44isj5mil3.fsf@be-well.ilk.org> Lines: 34 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii cc: freebsd-questions@freebsd.org Subject: Re: viewing sgml documents 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: Wed, 21 Jan 2004 15:23:31 -0000 "Andrew L. Gould" writes: > On Wednesday 21 January 2004 07:43 am, Lowell Gilbert wrote: > > "Andrew L. Gould" writes: > > > When ports install sgml documents to /usr/local/share/doc/*, what apps > > > are used to view them without the markups? > > > > Normally a web browser is used to view the html files that are > > generated from them... > > I'm trying to view the operators' guide for dancer-ircd port. The sgml > documents are in /usr/local/share/doc/dancer-ircd/sgml/dancer-oper-guide/. > I've installed the ports docproj and sgmltools; and I've read the README > files and MAKEFILE's in the relevant directories. > > When I perform "make doc" per the MAKEFILE, it doesn't do anything. No > messages are returned. > > When I use sgmltools, the html option creates one empty directory. The ps and > txt options create documents with the entirety of the contents on one line. > > Is it generally this hard to produce documentation, or is this port an > exception? The typical case is that the port does it for you. In this case, the latest version of the port seems to download and install text documentation; no sgml documents are installed, as far as I can see. -- Lowell Gilbert, embedded/networking software engineer, Boston area: resume/CV at http://be-well.ilk.org:8088/~lowell/resume/ username/password "public"