Date: Sun, 5 Nov 2006 18:00:46 GMT From: Giorgos Keramidas <keramida@freebsd.org> To: freebsd-doc@FreeBSD.org Subject: Re: docs/48980: [PATCH] nsgmls -s errors and sect. 3.2.1 of the fdp-primer Message-ID: <200611051800.kA5I0k8f001827@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200611051800.kA5I0k8f001827>