Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 23 Dec 2000 15:36:37 -0800
From:      Rich Morin <rdm@cfcl.com>
To:        freebsd-doc@freebsd.org
Subject:   Re: /usr/share/doc/{en*,fr*,ja*,ru*}
Message-ID:  <p0500192ab66ae5cbeebd@[192.168.168.205]>
In-Reply-To: <20001223141015.A78788@peorth.iteration.net>
References:  <p0500191db668b6c488a3@> <20001222153135.A35560@mithrandr.moria.org> <7msnnf8pbp.wl@waterblue.imgsrc.co.jp> <p05001926b66a8dd442a6@[192.168.168.205]> <20001223204328.A57711@mithrandr.moria.org> <p05001928b66aaa18e755@[192.168.168.205]> <20001223141015.A78788@peorth.iteration.net>

next in thread | previous in thread | raw e-mail | index | archive | help
At 2:10 PM -0600 12/23/00, Michael C . Wu wrote:
>I think you understand my point.  Changing this structure requires
>needless and a large effort for three major branches, many src/ hackers,
>many translation teams.  Not that I am saying change is a bad thing,
>but I see no real reason to violate POLA as well as POSIX.
>
>Would you care to explain why you want /usr/share this way?

Well, it may simply be a matter of taste, but it violates _my_ POLA
when unrelated things are jumbled together.  Although it is possible
for experienced users (and determined beginners) to find their way
through the current jumble, it isn't all that easy.  I know that I'm
asking for more than I'm likely to get, but if the point of docs is
to make things clearer, making the docs themselves navigable seems
like a good start.

More to the point, the current mess will only get messier over time,
as new annotation files, languages, and other ingredients are added.
By organizing things now, we can avoid a far worse mess down the road.

-r
-- 
--
Rich Morin:          rdm@cfcl.com, +1 650-873-7841, http://www.cfcl.com/rdm
Prime Time Freeware: info@ptf.com, +1 408-433-9662, http://www.ptf.com
MacPerl: http://www.macperl.com, http://www.ptf.com/ptf/products/MPPE
MkLinux: http://www.mklinux.org, http://www.ptf.com/ptf/products/MKLP


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?p0500192ab66ae5cbeebd>