From owner-freebsd-doc@FreeBSD.ORG  Sun May 25 06:01:58 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 6BC4F37B401
	for <doc@freebsd.org>; Sun, 25 May 2003 06:01:58 -0700 (PDT)
Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com
	[81.101.150.38])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 6CEEF43F75
	for <doc@freebsd.org>; Sun, 25 May 2003 06:01:57 -0700 (PDT)
	(envelope-from setantae@submonkey.net)
Received: from setantae by shrike.submonkey.net with local (Exim 4.20)
	id 19Jv8M-000IWu-NP; Sun, 25 May 2003 14:01:54 +0100
Date: Sun, 25 May 2003 14:01:54 +0100
From: Ceri Davies <setantae@submonkey.net>
To: Dag-Erling Smorgrav <des@ofug.org>
Message-ID: <20030525130154.GA71089@submonkey.net>
Mail-Followup-To: Ceri Davies <setantae@submonkey.net>,
	Dag-Erling Smorgrav <des@ofug.org>,
	"Simon L. Nielsen" <simon@nitro.dk>, doc@freebsd.org
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>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <xzpd6i8txp8.fsf@flood.ping.uio.no>
User-Agent: Mutt/1.5.4i
Sender: Ceri Davies <setantae@submonkey.net>
cc: "Simon L. Nielsen" <simon@nitro.dk>
cc: doc@freebsd.org
Subject: Re: doc build with .OBJDIR
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 25 May 2003 13:01:58 -0000

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
--