Date: Sun, 25 May 2003 16:17:58 +0200 From: "Simon L. Nielsen" <simon@nitro.dk> To: Ceri Davies <setantae@submonkey.net>, Dag-Erling Smorgrav <des@ofug.org>, doc@freebsd.org Subject: Re: doc build with .OBJDIR Message-ID: <20030525141757.GH419@nitro.dk> In-Reply-To: <20030525130154.GA71089@submonkey.net> References: <20030523015453.GF92953@nitro.dk> <xzphe7mxudr.fsf@flood.ping.uio.no> <xzpd6iaxua1.fsf@flood.ping.uio.no> <20030523141349.GF402@nitro.dk> <20030523203245.GG3794@nosferatu.blackend.org> <20030524085738.GB806@nosferatu.blackend.org> <xzpptm8tzr1.fsf@flood.ping.uio.no> <20030524103711.GE418@nitro.dk> <xzpd6i8txp8.fsf@flood.ping.uio.no> <20030525130154.GA71089@submonkey.net>
next in thread | previous in thread | raw e-mail | index | archive | help
--KFztAG8eRSV9hGtP Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.25 14:01:54 +0100, Ceri Davies wrote: > On Sat, May 24, 2003 at 01:01:55PM +0200, Dag-Erling Smorgrav wrote: > > "Simon L. Nielsen" <simon@nitro.dk> writes: > > > Doesn't the XML docbook have problems with including other files as d= one > > > e.g. in the handbook? > >=20 > > Not at all: > >=20 > > <?xml version=3D"1.0" encoding=3D"iso-8859-1"?> > > <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" > > "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd" [ > > <!ENTITY % manpages SYSTEM "../manpages.ent"> > > %manpages; > > ]> >=20 > That works, but all the parameter entities in handbook/book.sgml, such as >=20 > <![ %chap.config; [ &chap.config; ]]> >=20 > all fail, since marked sections aren't allowed in an XML document. This is to allow only to include some chapters, right? That could be handled easily with a little sed/grep magic, if we really need it. > I suspect this is what Simon was referring to. I must admit I don't remember what the exact problem was, just that there was some issue with include files, which led to using SGML instead of XML at work. > If it turns out that we don't care about using this functionality and are > prepared to lose it, then I have a patch to doc.docbook.mk here that allo= ws=20 > an XML build to finish (although the finished documents don't quite valid= ate > due to a strange issue with the footer in freebsd-html.xsl), although it = does > have other issues as I've outlined previously > (<20030413200045.GA97520@submonkey.net>). The current SGML->XML support in the makefiles doesn't work, right? In that case I don't see any reason not to commit the patch you are refering to in that mail, since it doesn't affect anything but XML. One note about that patch. I think you should use "${ECHO_CMD}" instead of "echo"; not that it makes much real difference, but for style. --=20 Simon L. Nielsen --KFztAG8eRSV9hGtP Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+0NCV8kocFXgPTRwRAge2AJ4tcMYf+PM9LxvcCml74MD260ZKuQCdFln2 +xGkHAiNUEMWZTLzmI8YWEQ= =5Bm+ -----END PGP SIGNATURE----- --KFztAG8eRSV9hGtP--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030525141757.GH419>