From owner-freebsd-doc Sat May 15 15:24:18 1999 Delivered-To: freebsd-doc@freebsd.org Received: from baerenklau.de.freebsd.org (baerenklau.de.freebsd.org [195.185.195.14]) by hub.freebsd.org (Postfix) with ESMTP id 1851914CC7; Sat, 15 May 1999 15:24:15 -0700 (PDT) (envelope-from wosch@panke.de.freebsd.org) Received: (from uucp@localhost) by baerenklau.de.freebsd.org (8.8.8/8.8.8) with UUCP id AAA11903; Sun, 16 May 1999 00:24:14 +0200 (CEST) (envelope-from wosch@panke.de.freebsd.org) Received: (from wosch@localhost) by paula.panke.de.freebsd.org (8.9.3/8.8.8) id XAA07778; Sat, 15 May 1999 23:12:41 +0200 (CEST) (envelope-from wosch) Message-ID: <19990515231241.20872@panke.de.freebsd.org> Date: Sat, 15 May 1999 23:12:41 +0200 From: Wolfram Schneider To: nclayton@lehman.com, doc@FreeBSD.ORG Cc: cvs@FreeBSD.ORG Subject: Re: doc//books/*, doc//articles/*, and docs.freebsd.org References: <19990504163533.S14492@lehman.com> <19990509011527.18124@panke.de.freebsd.org> <19990510104605.D14492@lehman.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89i In-Reply-To: <19990510104605.D14492@lehman.com>; from nclayton@lehman.com on Mon, May 10, 1999 at 10:46:05AM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 1999-05-10 10:46:05 +0100, nclayton@lehman.com wrote: > Of these, doc/FAQ needs converting to DocBook, as do almost all of > doc/en/tutorials. > > I don't think these conversions should be done "in place" as it where. > When I converted the Handbook from LinuxDoc to DocBook the converted files > were placed in doc/en/handbook, instead of sitting on a branch of > doc/handbook. I'd like to do the same thing with the DTD migration for > the FAQ and the majority of the tutorials. > > This entails no more CVS bloat than will be incurred by the DTD migration > anyway. > > Being more precise > > LinuxDoc (current) DocBook (new) > ------------------------------------------------------------------------ > doc/FAQ -> doc/en/articles/FAQ > doc/en/tutorials/ddwg -> doc/en/articles/writing-device-drivers > doc/en/tutorials/devel -> doc/en/articles/programming-tools > doc/en/tutorials/diskformat -> doc/en/articles/formatting-media > doc/en/tutorials/disklessx -> doc/en/articles/diskless-X > * doc/en/tutorials/docproj-primer -> doc/en/books/FDP-primer > doc/en/tutorials/fonts -> doc/en/articles/fonts > doc/en/tutorials/mh -> doc/en/articles/mh > doc/en/tutorials/multios -> doc/en/articles/multios > doc/en/tutorials/newuser -> doc/en/articles/newuser > doc/en/tutorials/ppp -> doc/en/books/ppp > > * = Repository copy required, because this is already in DocBook format devel, diskformat, disklessx, fonts, mh, multios and newuser are also in DocBook format. Only ddwg and ppp are still in linuxdoc. > Note: As you can see, I'm in favour of longer names to be more > explicit, in general. The *vast* majority of people are going > to click on these as URLs, so won't care how long they are. Those > of us that are actually maintaining them have TAB-completion on > our shell, so it's no big deal. IMHO filenames should be in lowercase if possible. -- Wolfram Schneider http://wolfram.schneider.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message