Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 25 May 2003 14:01:54 +0100
From:      Ceri Davies <setantae@submonkey.net>
To:        Dag-Erling Smorgrav <des@ofug.org>
Cc:        doc@freebsd.org
Subject:   Re: doc build with .OBJDIR
Message-ID:  <20030525130154.GA71089@submonkey.net>
In-Reply-To: <xzpd6i8txp8.fsf@flood.ping.uio.no>
References:  <xzp1xyqzjxg.fsf@flood.ping.uio.no> <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>

next in thread | previous in thread | raw e-mail | index | archive | help
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 done
> > e.g. in the handbook?
> 
> Not at all:
> 
> <?xml version="1.0" encoding="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;
> ]>

That works, but all the parameter entities in handbook/book.sgml, such as

<![ %chap.config;                   [ &chap.config;               ]]>

all fail, since marked sections aren't allowed in an XML document.
I suspect this is what Simon was referring to.

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 allows 
an XML build to finish (although the finished documents don't quite validate
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>).

Ceri
-- 



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030525130154.GA71089>