From owner-freebsd-doc@FreeBSD.ORG Mon Feb 23 23:07:39 2004 Return-Path: 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 4D57B16A4CE; Mon, 23 Feb 2004 23:07:39 -0800 (PST) Received: from smtp.des.no (flood.des.no [217.116.83.31]) by mx1.FreeBSD.org (Postfix) with ESMTP id BD03443D1F; Mon, 23 Feb 2004 23:07:38 -0800 (PST) (envelope-from des@des.no) Received: by smtp.des.no (Pony Express, from userid 666) id CBA825309; Tue, 24 Feb 2004 08:07:37 +0100 (CET) Received: from dwp.des.no (des.no [80.203.228.37]) by smtp.des.no (Pony Express) with ESMTP id ED2775308; Tue, 24 Feb 2004 08:07:28 +0100 (CET) Received: by dwp.des.no (Postfix, from userid 2602) id 78F7E33C6F; Tue, 24 Feb 2004 08:07:28 +0100 (CET) To: Chuck Swiger References: <8D03FA54-4BA6-11D8-8D97-003065ABFD92@pkix.net> <20040216130659.GC617@submonkey.net> <4031364A.2070708@pkix.net> <20040222181114.GB32524@graf.pompo.net> <40390248.1060104@pkix.net> <4039D0FE.3010905@FreeBSD.org> <403A53E1.2040305@mac.com> <403A7996.1090602@mac.com> From: des@des.no (Dag-Erling =?iso-8859-1?q?Sm=F8rgrav?=) Date: Tue, 24 Feb 2004 08:07:28 +0100 In-Reply-To: <403A7996.1090602@mac.com> (Chuck Swiger's message of "Mon, 23 Feb 2004 17:07:18 -0500") Message-ID: User-Agent: Gnus/5.090024 (Oort Gnus v0.24) Emacs/21.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Spam-Checker-Version: SpamAssassin 2.63 (2004-01-11) on flood.des.no X-Spam-Level: X-Spam-Status: No, hits=0.0 required=5.0 tests=AWL autolearn=no version=2.63 cc: freebsd-doc@FreeBSD.org cc: Thierry Thomas cc: Alex Dupre Subject: Re: Validating docbook articles... X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 24 Feb 2004 07:07:39 -0000 Chuck Swiger writes: > ...whereas not using a SystemLiteral with the DOCTYPE declaration > works fine with nsgmls but xmllint refuses to parse the document. Am > I wrong in concluding that by requiring a SystemLiteral for a document > that is valid SGML, XML fails design goal #3, aka "XML shall be > compatible with SGML"...? a well-formed XML document is also a well-formed SGML document, but the reverse need not be true; and the DTD syntax is different. > Entity: line 5: parser error : Entity 'trade' not defined > designations have been followed by the ™ or the > > Entity: line 6: parser error : Entity 'reg' not defined > ® symbol. > ^ These are HTML entities. You need to include their definitions in the DOCTYPE block: %HTMLlat1; %HTMLspecial; %HTMLsymbol; > Entity: line 6: parser error : chunk is not well balanced > ® symbol. > ^ > article.sgml:33: parser error : chunk is not well balanced > &tm-attrib.general; > ^ Probably unclosed tags. SGML allows them (depending on the DTD), XML does not. > article.sgml:210: parser error : Entity 'prompt.root' not defined > &prompt.root; sysctl net.link.ether.bridge.config= =3Dfxp0:0, > ^ > article.sgml:211: parser error : Entity 'prompt.root' not defined > &prompt.root; sysctl net.link.ether.bridge.ipfw=3D1 > ^ > article.sgml:212: parser error : Entity 'prompt.root' not defined > &prompt.root; sysctl net.link.ether.bridge.enable=3D1 ^ > article.sgml:219: parser error : Entity 'nbsp' not defined > If you have &os; 5.1-RELEASE or previous the sysctl var= iables > ^ These come from failing to declare entities > This has been interesting, but it's demonstrably non-trivial to > convert SGML docbook articles into XML. More specificly, I don't see > how to do so for a particular article without making non-local changes > to .ent files being referenced by the article in order to make the XML > version work at all, and I don't see how to make both nsgmls and > xmllint happy at the same time. The DTD syntax is slightly different, but it should be easy to convert entity declarations mechanically. Backward compatibility with the SGML toolchain is not, IMHO, required or desirable. DES --=20 Dag-Erling Sm=F8rgrav - des@des.no