From owner-freebsd-questions@FreeBSD.ORG  Wed Jan 21 07:35:06 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 1E0C216A4CE
	for <freebsd-questions@freebsd.org>;
	Wed, 21 Jan 2004 07:35:06 -0800 (PST)
Received: from firecrest.mail.pas.earthlink.net
	(firecrest.mail.pas.earthlink.net [207.217.121.247])
	by mx1.FreeBSD.org (Postfix) with ESMTP id EB45143D1D
	for <freebsd-questions@freebsd.org>;
	Wed, 21 Jan 2004 07:35:04 -0800 (PST)
	(envelope-from algould@datawok.com)
Received: from 22-15.lctv-b4.cablelynx.com ([24.204.22.15]
	helo=yoda.datawok.com)
	by firecrest.mail.pas.earthlink.net with asmtp (TLSv1:RC4-MD5:128)
	(Exim 3.33 #1)	id 1AjKNj-00044X-00; Wed, 21 Jan 2004 07:35:03 -0800
From: "Andrew L. Gould" <algould@datawok.com>
To: Lowell Gilbert <freebsd-questions-local@be-well.ilk.org>
Date: Wed, 21 Jan 2004 09:35:03 -0600
User-Agent: KMail/1.5.4
References: <200401201007.32634.algould@datawok.com>
	<200401210901.46777.algould@datawok.com> <44isj5mil3.fsf@be-well.ilk.org>
In-Reply-To: <44isj5mil3.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: <200401210935.03793.algould@datawok.com>
X-ELNK-Trace: ee791d459e3d6817d780f4a490ca69564776905774d2ac4bb1615d6d677166c1c7a80f79e5493fda350badd9bab72f9c350badd9bab72f9c350badd9bab72f9c
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:35:06 -0000

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

I installed from the package at ftp.freebsd.org.  I'll pkg_delete and install 
from the port.

Thanks,

Andrew Gould