From owner-freebsd-doc Mon Feb 16 20:38:33 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id UAA24901 for freebsd-doc-outgoing; Mon, 16 Feb 1998 20:38:33 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from hitiij.hitachi.co.jp (root@hitiij.hitachi.co.jp [133.145.224.3]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id UAA24888 for ; Mon, 16 Feb 1998 20:38:24 -0800 (PST) (envelope-from horikawa@isrd.hitachi.co.jp) Received: from isrdgw.isrd.hitachi.co.jp by hitiij.hitachi.co.jp (8.8.5+2.7Wbeta5/3.5W-hitiij) id NAA27324; Tue, 17 Feb 1998 13:26:58 +0900 (JST) Received: from [133.144.95.172] by isrdgw.isrd.hitachi.co.jp (8.6.9+2.4W/2.7W-ISRD) id NAA20286; Tue, 17 Feb 1998 13:37:52 +0900 Message-Id: <199802170437.NAA20286@isrdgw.isrd.hitachi.co.jp> To: John Fieber Cc: freebsd-doc@FreeBSD.ORG, man-jp-core@jp.freebsd.org Subject: Re: Proposal to put Japanese online manuals into freefall CVS repository In-reply-to: Your message of "Mon, 16 Feb 1998 16:15:18 JST." Date: Tue, 17 Feb 1998 13:38:07 +0900 From: Kazuo HORIKAWA Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > On Tue, 17 Feb 1998 k-horik@yk.rim.or.jp wrote: > Now doc/ja_JP.EUC have been moved to doc/ja (thanks Peter Wemm!) and > I heard www/data/ja_JP.EUC will be moved to www/data/ja, so I think > there is no barrier to import Japanese online manuals into doc/ja/man. > If there is no problem, I would like to ask Satoshi Asami and > Hiroyuki Hanai to do so. Is it OK? >>>>> John Fieber writes: > If I may raise one small point that I just thought of...the > primary reason for moving things into a doc tree separate from > the main src tree was that the handbook and FAQ cover multiple > FreeBSD releases. Tracking changes on three separate CVS > branches was just all hassle with no benefit. The related issue > was maintaining the doc tools in all three branches. > So, to what degree do these Japanese docs cover all FreeBSD > versions? If they document details of specific tools, then it > might actually be a good thing for them to follow branches of the > main src tree. As it stands, the doc tree doesn't take branches. Japanese online manuals follow only FreeBSD RELEASE version. This is because we do not have enough human resource, and we believe Japanese online manuals' users are mainly RELEASE users. Because we follow only RELEASE version, importing Japanese online manuals into doc does not make branches. Because we do not follow -current (HEAD), for Japanese online manuals, appropriate tree is not src tree but doc tree, we think. > Would it work to put them right in src/share/man? How disruptive > would it be to add Japanese capabilities to the groff and man in > the main source tree? For Japanese manual formatting, `man', `groff', `col', and `more' should have Japanese capabilities. Ports ja-man-1.1, ja-groff-0.99 and ja-less-332 have Japanese capabilities. But these tools (at least ja-man-1.1 and ja-groff-0.99) do not have koi-8 capabilities. We think that adding koi-8 capabilities to the ja-* tools or adding Japanese capabilities to the tools in the src tree requires long time. And if we think about adding Japanese capabilities to `col', we should think about other text formatting related commands (fmt, expand, fold, etc.). This is big impact on the src tree. So we think that adding Japanese capabilities to tools in the src tree is not good idea. This is the second reason why we think that doc tree is appropriate for Japanese online manuals. -- Kazuo Horikawa To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message