From owner-freebsd-doc Wed Aug 18 15:11:51 1999 Delivered-To: freebsd-doc@freebsd.org Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id 5AFC314E3F; Wed, 18 Aug 1999 15:10:53 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id BAA08572; Thu, 19 Aug 1999 01:11:41 +0400 (MSD) (envelope-from phantom@scorpion.crimea.ua) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id BAA04851; Thu, 19 Aug 1999 01:04:01 +0400 (MSD) Message-Id: <199908182104.BAA04851@scorpion.crimea.ua> Subject: Re: Default FDP docs installation directory? In-Reply-To: <19990818121931.A4266@kilt.nothing-going-on.org> from Nik Clayton at "Aug 18, 99 12:19:31 pm" To: nik@FreeBSD.ORG (Nik Clayton) Date: Thu, 19 Aug 1999 01:04:01 +0400 (MSD) Cc: doc@FreeBSD.ORG From: "Alexey M. Zelkin" X-Mailer: ELM [version 2.4ME+ PL40 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org hi, > Historically, the documentation has been installed in to /usr/doc. This Maybe /usr/share/doc ? > 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. 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. > where > > en_US.ISO_8859-1 and friends > > books/, articles/, man/ > > faq/, handbook/, programming-tools/ > > In addition, a language compatability symlink is installed. So > /usr/local/share/doc/fdp/en is a symlink to > /usr/local/share/doc/fdp/en_US.ISO_8859-1, and > /usr/local/share/doc/fdp/ja_JP.eucJP is a symlink to > /usr/local/share/doc/fdp/ja (yes, Japanese team, I hadn't forgotten your > comments and concerns). 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 > This is the best scheme I could come up. It keeps the FDP stuff > away from documentation from other packages that might be installed (for > example, /usr/local/share/doc/{mutt,apache,jade,bzip2} and others all exist > on my system), and it's extendable. Looks like FreeBSD Documentaion is going to stay port. :-) > One more thing -- A mid-term goal is for the pre-built docs (HTML, PS, PDF > and so on) to be distributed as binary packages, to be managed using the > pkg_* family. I'm pretty certain this precludes putting the documentation > anywhere other than a subdirectory of /usr/local/, so the old /usr/doc/ > directory is right out. $LOCALBASE variable will help you, I hope. By default it setting in /usr/local, but it can be overridden to i.e. /usr/share. -- Sincerely Yours, | phantom@crimea.edu (primary) Alexey Zelkin | phantom@scorpion.crimea.ua (home) | ICQ: #6196584, FIDO: 2:460/12.26 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message