From owner-freebsd-doc Tue Jan 16 5: 9:44 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 6C90337B404 for ; Tue, 16 Jan 2001 05:09:24 -0800 (PST) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.1/8.11.1) id f0G9YCt03317; Tue, 16 Jan 2001 09:34:12 GMT (envelope-from nik) Date: Tue, 16 Jan 2001 09:34:12 +0000 From: Nik Clayton To: Chris Costello Cc: doc@FreeBSD.org Subject: Re: Reorganizing entities in doc/. Message-ID: <20010116093412.A3294@canyon.nothing-going-on.org> References: <20010113160051.B4539@holly.calldei.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010113160051.B4539@holly.calldei.com>; from chris@calldei.com on Sat, Jan 13, 2001 at 04:00:51PM -0600 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sat, Jan 13, 2001 at 04:00:51PM -0600, Chris Costello wrote: > As I worked on the mailing-lists.ent move, a thought occured > to me--how far should I go? There are other language-specific > general entities that are mostly lumped into the Handbook. There > are language-specific authors.ent files to overload the stock > authors.ent from the Handbook, there's newsgroups.ent files, and > of course mailing-lists.ent. > > I propose the following reorganization: Looks pretty OK from here. The only thing I might change is the location of the mailing-lists.ent file. I'd be tempted to put the English version in doc/share/sgml, and probably split the entities out in to something like The translations can override the .comment and .descr entities in their own directories. This allows a new translation to bootstrap with buildable documentation much faster (although, of course, we could keep the file in en*/share/, and then a new translation just has to copy it out of there instead). My basic aim has always been that documentation should be buildable after doing co doc/share co doc//share co doc/// 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 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message