From owner-doc-jp@jp.freebsd.org  Thu Aug 19 11:26:46 1999
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id LAA37503;
	Thu, 19 Aug 1999 11:26:46 +0900 (JST)
	(envelope-from owner-doc-jp@jp.FreeBSD.org)
Received: from mailgw.cablecom.ne.jp (ns1.cablecom.ne.jp [202.248.199.37])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id LAA37498
	for <doc-jp@jp.freebsd.org>; Thu, 19 Aug 1999 11:26:45 +0900 (JST)
	(envelope-from motoyuki@snipe.rim.or.jp)
Received: from srv2.cablecom.ne.jp by mailgw.cablecom.ne.jp (8.8.8/3.7W) id LAA02700; Thu, 19 Aug 1999 11:26:39 +0900 (JST)
Received: from asuka.snipe.rim.or.jp by srv2.cablecom.ne.jp (8.8.8/3.7W) id LAA02550; Thu, 19 Aug 1999 11:26:37 +0900 (JST)
Received: from rei.snipe.rim.or.jp (rei.snipe.rim.or.jp [192.168.11.11]) by asuka.snipe.rim.or.jp (8.9.3/3.7W) with ESMTP
	id LAA33738; Thu, 19 Aug 1999 11:26:29 +0900 (JST)
Received: from rei.snipe.rim.or.jp (localhost.snipe.rim.or.jp [127.0.0.1]) by rei.snipe.rim.or.jp (8.9.3/3.7W) with ESMTP
	id LAA05267; Thu, 19 Aug 1999 11:26:29 +0900 (JST)
Message-Id: <199908190226.LAA05267@rei.snipe.rim.or.jp>
To: asami@freebsd.org (Satoshi - Ports Wraith - Asami)
Cc: Nik Clayton <nik@freebsd.org>, "Alexey M. Zelkin" <phantom@cris.net>,
        doc@freebsd.org, doc-jp@jp.freebsd.org
X-Mailer: mh-e on Mule 2.3 / Emacs 19.34.1
References: <19990818121931.A4266@kilt.nothing-going-on.org> <199908182104.BAA04851@scorpion.crimea.ua> <19990819001734.A83680@catkin.nothing-going-on.org> 
	<vqc9078vbkf.fsf@silvia.hip.berkeley.edu> 
Mime-Version: 1.0 (generated by tm-edit 7.106)
Content-Type: text/plain; charset=US-ASCII
Date: Thu, 19 Aug 1999 11:26:29 +0900
From: Motoyuki Konno <motoyuki@snipe.rim.or.jp>
Reply-To: doc-jp@jp.freebsd.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+990727
X-Sequence: doc-jp 6500
Subject: [doc-jp 6500] Re: Default FDP docs installation directory? 
Errors-To: owner-doc-jp@jp.freebsd.org
Sender: owner-doc-jp@jp.freebsd.org
X-Originator: motoyuki@snipe.rim.or.jp

Hi,

asami@freebsd.org (Satoshi - Ports Wraith - Asami) wrote:
>  * 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 issue is not about local policy, Nik.  There are literally dozens
> of Japanese FreeBSD books and magazines out there that includes a
> variation of the first line up there as the command to read the
> handbook.  (I don't know about other countries but I suspect the
> situation is the same.)
> 
> When people buy a book, install the latest system and find out it
> doesn't work, they get pissed.  And we (on the Japanese mailing lists)
> are the ones that hear about it.

I think this is the most important.  Any directory change confused
many FreeBSD users, so WE HAVE TO VERY VERY CAREFUL TO CHANGE
THE DEFAULT INSTALL DIRECTORY.

We agreed Nik's CVS-repository-move idea because he says the location
of documents never move.  If he said he want to move the directory
at the moment (before the CVS-repository-move were done), we never
agree his idea.


When the Japanese manual directory moved from
 /usr/(share|local|X11R6)/man/ja_JP.EUC to /usr/..../ja, many many
Japanese users are confused with this problem.  For another example,
the system configuration file were /etc/sysconfig at first, then
/etc/rc.conf, now /etc/default/rc.conf for the default values and
/etc/rc.conf for the user-defined values.  This change also confused
many FreeBSD users...

Of course, these changes were written in Release Notes, but FreeBSD
beginners think their FreeBSD books are correct.

# As the Release Notes exists in the electrical media such as Web,
# Beginners feels more difficulty to refer the Release Notes.


I think there were enough reason to change the location of system
configuration file.  But what about the doc directory change?
Is there enough reason to change?  I think not.  I have never heard
the opinion like "the location of FreeBSD handbook is bad.  please
move it" from FreeBSD users.  I have heard many suggestion like
"the location change confused me much.  please do not move again."

--
------------------------------------------------------------------------
Motoyuki Konno                  mkonno@res.yamanashi-med.ac.jp   (Univ)
                                motoyuki@snipe.rim.or.jp         (Home)
                                motoyuki@FreeBSD.ORG  (FreeBSD Project)
Yamanashi Medical University    http://www.freebsd.org/~motoyuki/ (WWW)
