From owner-freebsd-doc@FreeBSD.ORG Sun May 25 07:18:01 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3510337B401 for ; Sun, 25 May 2003 07:18:01 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 68EDB43F3F for ; Sun, 25 May 2003 07:18:00 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id CD7E810BF81; Sun, 25 May 2003 16:17:58 +0200 (CEST) Date: Sun, 25 May 2003 16:17:58 +0200 From: "Simon L. Nielsen" To: Ceri Davies , Dag-Erling Smorgrav , doc@freebsd.org Message-ID: <20030525141757.GH419@nitro.dk> References: <20030523015453.GF92953@nitro.dk> <20030523141349.GF402@nitro.dk> <20030523203245.GG3794@nosferatu.blackend.org> <20030524085738.GB806@nosferatu.blackend.org> <20030524103711.GE418@nitro.dk> <20030525130154.GA71089@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="KFztAG8eRSV9hGtP" Content-Disposition: inline In-Reply-To: <20030525130154.GA71089@submonkey.net> User-Agent: Mutt/1.5.4i Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 25 May 2003 14:18:01 -0000 --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" 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 > > > > > "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd" [ > > > > %manpages; > > ]> >=20 > That works, but all the parameter entities in handbook/book.sgml, such as >=20 > >=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--