Date: Thu, 20 May 1999 23:25:10 +0100 From: Nik Clayton <nik@nothing-going-on.demon.co.uk> To: Greg Black <gjb@acm.org> Cc: Nik Clayton <nik@nothing-going-on.demon.co.uk>, doc@FreeBSD.ORG, freebsd-translate@ngo.org.uk Subject: Re: FDP Directory Reorganisation Message-ID: <19990520232510.A54603@catkin.nothing-going-on.org> In-Reply-To: <19990520095342.18541.qmail@alice.gba.oz.au>; from Greg Black on Thu, May 20, 1999 at 07:53:41PM %2B1000 References: <19990513211458.B70767@catkin.nothing-going-on.org> <19990519214022.D60921@catkin.nothing-going-on.org> <19990520095342.18541.qmail@alice.gba.oz.au>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, May 20, 1999 at 07:53:41PM +1000, Greg Black wrote:
> > The main change is replacing lang/encoding with lang.encoding, based on
> > the contents of /usr/share/locale. The articles/books/man split is
> > still there, and will remain unless someone can come up with something
> > better.
>
> I'm really disappointed to see books and articles still there,
> especially since all the feedback that I saw was in favour of
> eliminating the arbitrary distinction.
Two replies, both of which said "Yeah", without proposing an alternative.
> > I am prepared to replace this with just one directory if someone can
> > come up with a good name for it.
>
> Just because it's a bit difficult to dream up the best name for
> this directory is a poor reason to impose an arbitrary division
> of similar documents based purely in their length.
It's not based on their length.
The documentation will exist as documents marked up according to the
DocBook DTD. The precise distinction is based upon the element describing
the entire document. This will be one of either <article> or <book>. If
it's marked up as an article then it goes in articles/, as a book in
books/, and as a manual page in man/.
An alternative way of expressing this, without getting in to the SGML,
is that if it has more than one chapter then it's a book, otherwise it's
an article.
> The other comment I'd make is that it's time to stop using names
> with upper case in them. If there is a strong historical reason
> why lots of people will be seriously inconvenienced if names
> like "FDP-primer" and "FAQ" are replaced by "fdp-primer" and
> "faq", then this can be solved for the time being with symlinks
> and a note that the symlinks are going to disappear when 4.x
> comes out.
I'm agnostic on this issue. Unless anyone's strenuously in favour of
mixed-case directory names they can all be smashed to lower case.
N
--
There's some milk in the fridge about to go off. . . and there it goes.
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990520232510.A54603>