From owner-freebsd-doc  Tue Nov  3 01:16:49 1998
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Received: (from majordom@localhost)
          by hub.freebsd.org (8.8.8/8.8.8) id BAA13385
          for freebsd-doc-outgoing; Tue, 3 Nov 1998 01:16:49 -0800 (PST)
          (envelope-from owner-freebsd-doc@FreeBSD.ORG)
Received: from firewall1.lehman.com (firewall1.Lehman.COM [192.147.65.82])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id BAA13376
          for <doc@FreeBSD.ORG>; Tue, 3 Nov 1998 01:16:47 -0800 (PST)
          (envelope-from nclayton@lehman.com)
From: nclayton@lehman.com
Received: from relay.lehman.com by firewall1.lehman.com (8.8.6/8.8.6) id EAA02125; Tue, 3 Nov 1998 04:16:35 -0500 (EST)
Received: from cmgrelay1.messaging-svcs.lehman.com by relay.lehman.com (4.1/LB-0.6)
	id AA15000; Tue, 3 Nov 98 04:16:03 EST
Received: from lonmailhost.lehman.com by cmgrelay1.messaging-svcs.lehman.com (8.8.5/8.8.5) id EAA10943; Tue, 3 Nov 1998 04:16:01 -0500 (EST)
Received: from lonadminvnm.lehman.com by lonmailhost.lehman.com (SMI-8.6/Lehman Bros. V1.5)
	id JAA05426; Tue, 3 Nov 1998 09:15:58 GMT
Received: from lonadmin80.lehman.com by lonadminvnm.lehman.com (4.1/Lehman Bros. V1.6)
	id AA10435; Tue, 3 Nov 98 09:15:57 GMT
Received: by lonadmin80.lehman.com (SMI-8.6/Lehman Bros. V1.5)
	id JAA22136; Tue, 3 Nov 1998 09:15:57 GMT
Message-Id: <19981103091556.O20122@lehman.com>
Date: Tue, 3 Nov 1998 09:15:56 +0000
To: Sean Kelly <kelly@plutotech.com>,
        Nik Clayton <nik@nothing-going-on.demon.co.uk>
Cc: doc@FreeBSD.ORG
Subject: Re: DocBook markup guide for the Handbook
References: <19981102232010.63991@nothing-going-on.org> <363E4964.24A5FEDA@plutotech.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.91.1i
In-Reply-To: <363E4964.24A5FEDA@plutotech.com>; from Sean Kelly on Mon, Nov 02, 1998 at 05:08:04PM -0700
Organization: Lehman Brothers
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Mon, Nov 02, 1998 at 05:08:04PM -0700, Sean Kelly wrote:
> In the guide at <URL:http://www.freebsd.org/~nik/hb/markup-guide.html>,
> you wrote:
> 
> 	Each chapter.sgml file will not be a complete SGML
> 	document. In particular, they will not have their
> 	own DOCTYPE line at the start of the file.
> 
> 	This is unfortunate for two reasons;
> 
> Yes, it is indeed unfortunate, but not necessary either, is it?  Why
> can't each chapter be a complete SGML document with a DOCTYPE
> declaration that's later entity-included into the book?  I could've
> sworn that works.

It doesn't work. 

    % cat test.sgml
    <!DOCTYPE sect1 PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
    <!ENTITY p SYSTEM "para.sgml">
    ]>

    <sect1>
      <title>A small section</title>
  
      &p;
    </sect1>
    % cat para.sgml
    <!DOCTYPE para PUBLIC "-//Davenport//DTD DocBook V3.0//EN">

    <para>A DocBook paragraph.</para>
    % nsgmls -s test.sgml
    nsgmls:para.sgml:1:2:E: "DOCTYPE" declaration not allowed in instance
    % echo "<para>A Docbook paragraph.</para>" > para.sgml
    % nsgmls -s test.sgml
    %

Hence the work around of Emacs local variables and a driver file.

N
-- 
--+==[ Systems Administrator, Year 2000 Test Lab, Lehman Brothers, Inc. ]==+--
--+==[      1 Broadgate, London, EC2M 7HA     0171-601-0011 x6492       ]==+--

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message