From owner-freebsd-questions@FreeBSD.ORG  Wed Jan 21 07:02:00 2004
Return-Path: <owner-freebsd-questions@FreeBSD.ORG>
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 5F0C116A4CE
	for <freebsd-questions@freebsd.org>;
	Wed, 21 Jan 2004 07:02:00 -0800 (PST)
Received: from heron.mail.pas.earthlink.net (heron.mail.pas.earthlink.net
	[207.217.120.189])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 473BE43D55
	for <freebsd-questions@freebsd.org>;
	Wed, 21 Jan 2004 07:01:53 -0800 (PST)
	(envelope-from algould@datawok.com)
Received: from 22-15.lctv-b4.cablelynx.com ([24.204.22.15]
	helo=yoda.datawok.com)
	by heron.mail.pas.earthlink.net with asmtp (TLSv1:RC4-MD5:128)
	(Exim 3.33 #1)	id 1AjJrW-0001dI-00; Wed, 21 Jan 2004 07:01:46 -0800
From: "Andrew L. Gould" <algould@datawok.com>
To: Lowell Gilbert <freebsd-questions-local@be-well.ilk.org>
Date: Wed, 21 Jan 2004 09:01:46 -0600
User-Agent: KMail/1.5.4
References: <200401201007.32634.algould@datawok.com>
	<44r7xt4dty.fsf@be-well.ilk.org>
In-Reply-To: <44r7xt4dty.fsf@be-well.ilk.org>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200401210901.46777.algould@datawok.com>
X-ELNK-Trace: ee791d459e3d6817d780f4a490ca69564776905774d2ac4bfe3e9a51cc8b31a96f6121d81b0d8ded350badd9bab72f9c350badd9bab72f9c350badd9bab72f9c
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 <freebsd-questions.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>,
	<mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>,
	<mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 21 Jan 2004 15:02:00 -0000

On Wednesday 21 January 2004 07:43 am, Lowell Gilbert wrote:
> "Andrew L. Gould" <algould@datawok.com> 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?

Andrew Gould