doc build with .OBJDIR

[Ceri Davies]

On Sat, May 24, 2003 at 01:01:55PM +0200, Dag-Erling Smorgrav wrote:
> "Simon L. Nielsen" <simon at 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 at submonkey.net>).

Ceri
--