From owner-freebsd-doc Tue May 11 2:34:52 1999 Delivered-To: freebsd-doc@freebsd.org Received: from firewall1.lehman.com (firewall.Lehman.COM [192.147.65.66]) by hub.freebsd.org (Postfix) with ESMTP id A4FDF14DE5 for ; Tue, 11 May 1999 02:34:50 -0700 (PDT) (envelope-from nclayton@lehman.com) Received: from relay.messaging-svcs2.lehman.com by firewall1.lehman.com (8.8.6/8.8.6) id FAA29856; Tue, 11 May 1999 05:31:19 -0400 (EDT) Received: from lonmailhost.lehman.com by relay.messaging-svcs2.lehman.com (8.9.3/8.8.5) id FAA23585; Tue, 11 May 1999 05:30:47 -0400 (EDT) Received: by lonmailhost.lehman.com (SMI-8.6/Lehman Bros. V1.5) id KAA06608; Tue, 11 May 1999 10:30:45 +0100 Message-ID: <19990511103045.P14492@lehman.com> Date: Tue, 11 May 1999 10:30:45 +0100 From: nclayton@lehman.com To: John Baldwin , Nik Clayton Cc: freebsd-doc@FreeBSD.ORG, Kevin Lo Subject: Re: FAQ team. References: <19990510194453.A41076@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.91.1i In-Reply-To: ; from John Baldwin on Mon, May 10, 1999 at 06:59:56PM -0400 Organization: Lehman Brothers Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, May 10, 1999 at 06:59:56PM -0400, John Baldwin wrote: > On 10-May-99 Nik Clayton wrote: > > Not yet. I haven't looked seriously at DocBook 3.1 yet, which is what > > we'll do the FAQ in. 3.1 has a new qandaset element (and subelements) > > for marking up FAQs. > > Do we want to change /usr/doc/share/sgml/freebsd.dtd to use 3.1 and get rid of > the FAQ* entries from it or would you rather move the FreeBSD specifics out > into another file that freebsd.dtd and freebsd-faq.dtd (or > freebsd-31.dtd or something) include? I'm not quite sure I understand. I'm going to get a repository copy done of freebsd.dtd to freebsd-docbook-300.dtd. Then I'll update the catalog file to point to that for the FPI "-//FreeBSD//DTD DocBook V3.0-Based Extension//EN". Then I'll create freebsd-docbook-310.dtd, based on DocBook 3.1, and create an FPI for that, which will probably be "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN" That way we can have 3.0 and 3.1 based documents co-existing in the tree. As soon as that's done we can then use both DTDs without fear of them clashing. I will strip the FAQ* elements out of both DTDs. > > If anyone wants to experiment with this, here's a very quick sample of > > how it might be used. Make sure you've got the docbook-310 port > > installed for this. Notice how one question can have several answers > > attached to it. This could be very useful for including multiple answers > > depending on the FreeBSD version in use; you could use the "os" attribute > > to differentiate between them. > > Spiffy. Would we be better off doing it by hand or by using the > linuxdoc-to-handbook script you referred to earlier? I wouldn't recommend doing it by hand. Look at http://www.freebsd.org/cgi/cvsweb.cgi/doc/en/handbook/Attic/README?rev=1.66 for an idea of how I did the Handbook. Note that I've not (yet) finalised the directory tree I want to use for doc/*, because I hadn't considered character encoding in my last message. I'll be writing a message to -doc about this soon, inviting further comment. N -- --+==[ Systems Administrator, Year 2000 Test Lab, Lehman Brothers, Inc. ]==+-- --+==[ 1 Broadgate, London, EC2M 7HA 0171-601-0011 x5514 ]==+-- --+==[ Year 2000 Testing: It's about time. . . ]==+-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message