From owner-freebsd-doc Mon Aug 30 4:18:31 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 9DE47150ED for ; Mon, 30 Aug 1999 04:18:23 -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 MAA40447; Mon, 30 Aug 1999 12:10:48 +0100 (BST) (envelope-from nik) Date: Mon, 30 Aug 1999 12:10:48 +0100 From: Nik Clayton To: Francis Jordan Cc: freebsd-doc@freebsd.org Subject: Re: Questions about docs Message-ID: <19990830121048.A38543@catkin.nothing-going-on.org> References: <37C99A41.86B7C53@netscape.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <37C99A41.86B7C53@netscape.net>; from Francis Jordan on Sun, Aug 29, 1999 at 09:38:26PM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Francis, I see that others have answered some of your questions, so I'll just answer the others. On Sun, Aug 29, 1999 at 09:38:26PM +0100, Francis Jordan wrote: > 2) make install in /usr/doc defaults to /usr/local/share/doc/fdp. > Shouldn't it instead update the docs in /usr/share/doc/{handbook,FAQ}? > The stuff that goes into /usr/share/doc is created when the system is > first installed and never gets updated. /usr/local/share/doc/fdp was a short lived experiment, and since last week the docs have installed under /usr/share/doc, and then another subdir showing the language and encoding. If you update your installed copy of the docs you should find it works as expected. > 3) The man pages. They are normally installed by making the world in > /usr/src; yet, somehow "make world" also installs the Japanese pages in > /usr/share/man/jp/{man?,cat?}. What are the Japanese man pages doing in > /usr/share/man? Historical accident, I suspect. IMHO, it should really by something like /usr/share/man.ja_JP.eucJP (and, for that matter, the English ones should be in /usr/share/man.en_US.ISO_8859-1, with /usr/share/man being a symlink to the appropriate directory). > Why Japanese? How comes there are no Russian pages in > /usr/share/man/ru or Spanish pages in /usr/share/man/es? The Japanese translation team is the only one to translate the manual pages to their language at the moment. None of the other translation teams have. In a project like this you take what you can get. > Finally, what's the story with es, ru, jp and zh? Where's French, > German and other European languages? I'm pretty sure I've heard of a > "French documentation project" - so where are the docs? The French docs will be imported into the tree 'soon'. I've had French docs ready for the tree for about 4 or 5 months, and held off importing them because of the up-coming doc/ repository changes. There was no point in importing them just before the change, only to have them move around the tree, and at the time I thought the change would take considerably less time than it eventually did. Currently, I'm liasing with Sebastian Gioria, who is my contact with the French documentation project, waiting to hear the final word back from him that my infrastructure changes to their documentation don't cause them any problems. Once I hear back from him about this doc/fr_FR.ISO_8859-1 will be imported very quickly. As for German and the other European languages, I haven't heard from the respective translation teams about importing their work in to the CVS tree. But it's a good point, and I'll be e-mailing the different teams about this now. Thanks for bringing it up. 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