From owner-freebsd-doc  Wed Aug 18 17:44: 2 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 AFF9E14F51; Wed, 18 Aug 1999 17:43:20 -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 DAA18758;
	Thu, 19 Aug 1999 03:45:13 +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 DAA06280;
	Thu, 19 Aug 1999 03:36:29 +0400 (MSD)
Message-Id: <199908182336.DAA06280@scorpion.crimea.ua>
Subject: Re: Default FDP docs installation directory?
In-Reply-To: <19990819001734.A83680@catkin.nothing-going-on.org> from Nik Clayton at "Aug 19, 99 00:17:34 am"
To: nik@freebsd.org (Nik Clayton)
Date: Thu, 19 Aug 1999 03:36:28 +0400 (MSD)
Cc: doc@freebsd.org
From: "Alexey M. Zelkin" <phantom@cris.net>
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,

> > > 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/<lang>/<type>/<doc name>/
> > 
> > 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.
You want to say that doc/ was splited from src/ because -core took
decision about deintegration docs from main system ? Or maybe FreeBSD will
be distributed without doc dist ? What exactly you mean by "not integrated
into system anymore" ? Documentation is required part of FreeBSD distribution.
That's why it will be stored in /usr/share/doc. /usr/local already meant
optional staff, localy installed staff.

Isn't it ?

> > 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).

He'll have source tree to do it. Or docs now ships with Makefiles ?
Almost FreeBSD users runing with -RELEASE, I think. Such kind of
documentation - FAQ/handbook is more dedicated to newbie/non-professional
users than professionals. Therefore we'll do it so as simple for users.

> 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.

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