From owner-freebsd-doc Wed Aug 18 17:10:19 1999 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 46D8214E49; Wed, 18 Aug 1999 17:08:28 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id AAA87199; Thu, 19 Aug 1999 00:17:34 +0100 (BST) (envelope-from nik) Date: Thu, 19 Aug 1999 00:17:34 +0100 From: Nik Clayton To: "Alexey M. Zelkin" Cc: Nik Clayton , doc@FreeBSD.ORG Subject: Re: Default FDP docs installation directory? Message-ID: <19990819001734.A83680@catkin.nothing-going-on.org> References: <19990818121931.A4266@kilt.nothing-going-on.org> <199908182104.BAA04851@scorpion.crimea.ua> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <199908182104.BAA04851@scorpion.crimea.ua>; from Alexey M. Zelkin on Thu, Aug 19, 1999 at 01:04:01AM +0400 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Aug 19, 1999 at 01:04:01AM +0400, Alexey M. Zelkin wrote: > > Historically, the documentation has been installed in to /usr/doc. This > > Maybe /usr/share/doc ? Yes, my typo. > > includes the standard BSD documentation, and the FreeBSD specific > > stuff, such as the FAQ and the Handbook. > > > The Makefile's I've committed so far install the docs in to > > > > /usr/local/share/doc/fdp//// > > Why /usr/local/share/doc ? Only ports documentation is going there as I > remember. Really I don't see any reason to install documentation to new > location, because of it's not 3rd party product docs. Isn't it? It's not tightly integrated into the system any more, and I'm wary of anything trying to install in /usr/share/ that's not part of the main src/ tree. > Next point: if we're still using /usr/share/doc we need not to > add new entity - "fdp". I sure that it's better to enter > > $ lynx file:///usr/share/doc/en/ > > than > > $ lynx file:///usr/local/share/doc/fdp/en/ > > First is more intuitive, I think. If the sysadmin wants this as local policy they can enforce it with a symlink (possibly as a selectable option in doc/Makefile, to make the link automatically). The idea is to be as precise as possible about where the docs are installed, and then let the admin pick a less precise location for a symlink as necessary. > Just idea: make something like "default" handbook, FAQ, tutorial (sure that it > should be english handbook by default) > > .../doc/en/handbook -> .../doc/handbook > .../doc/en/FAQ -> .../doc/FAQ > .../doc/en/tutorial -> .../doc/tutorial We could do that as well. It's certainly supportable under the current scheme. It's not right at the top of my todo list, but it's on there. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message