From owner-freebsd-doc Tue Jan 30 21:53: 4 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 0C26E37B4EC for ; Tue, 30 Jan 2001 21:52:40 -0800 (PST) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.1/8.11.1) id f0V5ihZ13487 for doc@freebsd.org; Wed, 31 Jan 2001 05:44:43 GMT (envelope-from nik) Date: Wed, 31 Jan 2001 05:44:43 +0000 From: Nik Clayton To: doc@freebsd.org Subject: Basing freebsd.dtd on DocBook 4.1 Message-ID: <20010131054443.A13461@canyon.nothing-going-on.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="pf9I7BMVVzbSWLtt" Content-Disposition: inline User-Agent: Mutt/1.2.5i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --pf9I7BMVVzbSWLtt Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Hi folks, I think it's time to consider basing the FreeBSD Docbook customisation layer on DocBook 4.1, rather than 3.1. Rather than suggest that we cut all documentation over at once, I'm planning on 1. Committing doc/share/sgml/freebsd41.dtd. This will be based on the existing freebsd.dtd, but with a couple of minor changes. The first patch attached to this message contains those changes. 2. Update doc/share/sgml/catalog to list the new FPI. The second patch contains that change. 3. Work through the documentation set, changing them from using 3.1 to 4.1, changing some of the markup as necessary (where elements were renamed, removed, or the content model was altered). I've attached a patch to the Committer's Guide document, which shows the sorts of changes that will be necessary. Any thoughts, or objections? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery --pf9I7BMVVzbSWLtt Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename=diff41 --- freebsd.dtd Sun Jan 14 17:13:33 2001 +++ freebsd41.dtd Wed Jan 31 05:40:31 2001 @@ -1,11 +1,11 @@ @@ -30,9 +30,6 @@ - - - - + %orig-docbook; @@ -111,6 +110,14 @@ + + + --pf9I7BMVVzbSWLtt Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="catalog.patch" Index: catalog =================================================================== RCS file: /home/ncvs/doc/share/sgml/catalog,v retrieving revision 1.13 diff -u -r1.13 catalog --- catalog 2001/01/06 18:39:27 1.13 +++ catalog 2001/01/14 17:14:25 @@ -14,6 +14,9 @@ PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN" "freebsd.dtd" +PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" + "freebsd41.dtd" + PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN" "man-refs.ent" --pf9I7BMVVzbSWLtt Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="article.patch" Index: article.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO_8859-1/articles/committers-guide/article.sgml,v retrieving revision 1.49 diff -u -r1.49 article.sgml --- article.sgml 2001/01/25 00:09:15 1.49 +++ article.sgml 2001/01/31 05:29:54 @@ -1,4 +1,4 @@ - %man; @@ -10,7 +10,7 @@ ]>
- + Committer Guide @@ -34,7 +34,7 @@ start, and existing committers are strongly encouraged to review it from time to time. - + Administrative Details @@ -1968,6 +1968,9 @@ file. + Revision number + Change + 1.1.1.1 vendor import --pf9I7BMVVzbSWLtt-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message