From owner-freebsd-doc@FreeBSD.ORG  Sun Nov  5 18:00:49 2006
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@hub.freebsd.org
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 32EF316A415
	for <freebsd-doc@hub.freebsd.org>; Sun,  5 Nov 2006 18:00:49 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 1192B43D60
	for <freebsd-doc@hub.freebsd.org>; Sun,  5 Nov 2006 18:00:47 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id kA5I0ko7001828
	for <freebsd-doc@freefall.freebsd.org>; Sun, 5 Nov 2006 18:00:46 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.4/8.13.4/Submit) id kA5I0k8f001827;
	Sun, 5 Nov 2006 18:00:46 GMT (envelope-from gnats)
Date: Sun, 5 Nov 2006 18:00:46 GMT
Message-Id: <200611051800.kA5I0k8f001827@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Giorgos Keramidas <keramida@freebsd.org>
Cc: 
Subject: Re: docs/48980: [PATCH] nsgmls -s errors and sect. 3.2.1 of the
	fdp-primer
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Giorgos Keramidas <keramida@freebsd.org>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 05 Nov 2006 18:00:49 -0000

The following reply was made to PR docs/48980; it has been noted by GNATS.

From: Giorgos Keramidas <keramida@freebsd.org>
To: Martin Karlsson <mk-freebsd@bredband.net>
Cc: bug-followup@freebsd.org
Subject: Re: docs/48980: [PATCH] nsgmls -s errors and sect. 3.2.1 of the fdp-primer
Date: Sun, 5 Nov 2006 19:56:35 +0200

 On 2003-03-06 19:09, Martin Karlsson <mk-freebsd@bredband.net> wrote:
 > 	Section 3.2.1 of the fdp-primer shows some environment variables
 > for use with the FDP and SGML files. As pointed out by Warren Block 
 > (Message-ID: Pine.BSF.4.21.0212021241330.8913-100000@wonkity.com) in 
 > an e-mail to the doc mailing list, running nsgmls -s on an SGML file,
 > with these environment variables set, produces errors. This patch swaps 
 > the docbook and iso8879 lines so that the docbook line is first 
 > (per Warren's suggestion), and this appears to fix the problem.
 > >How-To-Repeat:
 > 	Use the environment variables shown in section 3.2.1 of the
 > fdp-primer, and test an SGML file with nsgmls -s foo.sgml.
 
 Hi Martin,
 
 Using nsgmls is not the recommended way of building or testing the
 documentation, as far as I know.  If you use the doc/ Makefiles, then
 the correct SGML_CATALOG_FILES will be used.  You can even build the
 doc/ tree _without_ _anything_ in SGML_CATALOG_FILES.
 
 I'm not sure I would find it nice if we started recommending that people
 bypass the entire doc/ Makefile framework and use nsgmls manually
 themselves.
 
 - Giorgos