docs/48980: [PATCH] nsgmls -s errors and sect. 3.2.1 of the fdp-primer

[Giorgos Keramidas]

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

From: Giorgos Keramidas <keramida at freebsd.org>
To: Martin Karlsson <mk-freebsd at bredband.net>
Cc: bug-followup at 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 at 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 at 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