doc build with .OBJDIR

Ceri Davies setantae at
Sun May 25 13:01:58 UTC 2003

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


More information about the freebsd-doc mailing list