From owner-man-jp@jp.freebsd.org  Tue Dec 26 15:09:34 2000
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id PAA55777;
	Tue, 26 Dec 2000 15:09:34 +0900 (JST)
	(envelope-from owner-man-jp@jp.FreeBSD.org)
Received: from mailgw1.be.to (mailgw1.be.to [210.235.212.5])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id PAA55771
	for <man-jp@jp.freebsd.org>; Tue, 26 Dec 2000 15:09:34 +0900 (JST)
	(envelope-from okazaki@be.to)
Received: from mail1.be.to (mail1.be.to [210.235.212.2])
	by mailgw1.be.to (8.11.0+3.3W/8.11.0/BETO3.11-20000907025324) with ESMTP id eBQ69SO11411
	for <man-jp@jp.freebsd.org>; Tue, 26 Dec 2000 15:09:28 +0900
	(envelope-from okazaki@be.to)
Received: from REISHI (mitaka1-64.kcom.ne.jp [210.174.84.64])
	by mail1.be.to (8.9.3+3.2W/BETO.2.0-2000090621000000) with SMTP id PAA24116
	for <man-jp@jp.freebsd.org>; Tue, 26 Dec 2000 15:09:25 +0900
Received: (qmail 2697 invoked from network); 26 Dec 2000 06:07:48 -0000
Received: from localhost (HELO acidrain.localnet) (127.0.0.1)
  by localhost with SMTP; 26 Dec 2000 06:07:48 -0000
Date: Tue, 26 Dec 2000 15:07:47 +0900
Message-ID: <861yuvoguk.wl@dolphin.be.to>
From: OKAZAKI Tetsurou <okazaki@be.to>
To: Kazuo Horikawa <horikawa@psinet.com>
Cc: man-jp@jp.freebsd.org, imura@af.airnet.ne.jp, kuriyama@FreeBSD.org,
        ports-jp@jp.freebsd.org
In-Reply-To: <20001218195926X.horikawa@psinet.com>
References: <91j4dh$28en$1@vinita.tri.asanuma.co.jp>
	<80ae9u1r8t.fsf@kurishna.tri.asanuma.co.jp>
	<20001219014057.A67894@imura.af.airnet.ne.jp>
	<20001218195926X.horikawa@psinet.com>
User-Agent: Wanderlust/2.5.4 (Smooth) SEMI/1.14.1 (Kaga-Onsen) FLIM/1.14.1 (Yagi) APEL/10.2 Emacs/20.7 (i386--freebsd) MULE/4.0 (HANANOEN)
MIME-Version: 1.0 (generated by SEMI 1.14.1 - "Kaga-Onsen")
Content-Type: text/plain; charset=ISO-2022-JP
Reply-To: man-jp@jp.freebsd.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+000315
X-Sequence: man-jp 2956
Subject: [man-jp 2956] Re: ports/japanese/man
Errors-To: owner-man-jp@jp.freebsd.org
Sender: owner-man-jp@jp.freebsd.org
X-Originator: okazaki@be.to

In the message <20001218195926X.horikawa@psinet.com> 
Kazuo Horikawa <horikawa@psinet.com> wrote:

> > で、ports の ja-man とソースツリー上の変更に因果関係があるとすると
> > とても奇妙に思えるのですが、どの辺が関連してくるのでしょうか？

>  ports の ja-groff とソースツリー上の tmac.doc は、関係あるはずです 
> (多分 tmac.an も)。
>  少なくとも ja-groff-0.99 のころは、tmac.doc は GNU groff には含まれて
> いなかったので、FreeBSD ファイルシステムの tmac.doc を 
> /usr/local/share/groff/tmac にコピーしていたはずです。

mdoc 関係のファイルは、FreeBSD, NetBSD, OpenBSD のそれぞれで
bug fix やメンテナンスが行われていますが、groff の配布アーカイブ
に含まれている mdoc 関係のファイルは、機能的には groff-1.10 が
リリースされた 1995 年当時のものとほぼ変わっていません。

例えば Linux で online manual を表示させると、今でも .Os BSD 4.4
が "BSD Experimental" と表示されるはずです。当然 .Nx や .Fx は
定義されていません。ですから、ja-groff では、groff の配布に
含まれている mdoc 関係のファイルをそのまま使うことはできません。

ja-groff port が今でも /usr/share/tmac から一部のファイルを
コピーしているのはそのためです(と思います)。

この状況を解決するには、現在の各 BSD の mdoc マクロとその
関連ファイルの更新内容をまとめて、groff に同梱されている
mdoc マクロを update する作業が必要になります。この作業を
しようとしているのが、たぶん mdocNG なんだろうと思います。

>  以前は tmac.an が、mdoc(7) と man(7) のスタブ的な動作をしていましたが、
> 最近は tmac.andoc がこれを置き換えたということなのでしょうか？

ちょっと違います。今の /usr/share/tmac/tmac.andoc の中身は、
2.2.8-RELEASE の頃からほとんど変わっていません。また、
tmac.an が mdoc(7) と man(7) のスタブ的な動作をしていたのは、
*BSD 3兄弟のなかでは、たぶん FreeBSD だけだったと思います。

ここらへんの状況をまとめてみました。

groff 1.11.1 〜 1.16 
 * tmac.andoc    mdoc(7) と man(7) のスタブ的なファイル
 * tmac.doc      mdoc(7) マクロの定義ファイル
 * tmac.an       man(7) マクロの定義ファイル

つい最近までの FreeBSD
 * tmac.andoc    mdoc(7) と man(7) のスタブ的なファイル
 * tmac.an       tmac.andoc と同じ中身(hard link されている)
 * tmac.doc      mdoc(7) マクロの定義ファイル
 * tmac.groff_an man(7) マクロの定義ファイル

groff-1.16 import 後の(?) FreeBSD
 * tmac.andoc    mdoc(7) と man(7) のスタブ的なファイル
 * tmac.an       man(7) マクロの定義ファイル
 * tmac.doc      mdoc(7) マクロの定義ファイル
 * tmac.groff_an → 廃止された

-- 
岡崎哲朗
