From owner-man-jp@jp.freebsd.org  Tue Dec 26 15:50:16 2000
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id PAA61705;
	Tue, 26 Dec 2000 15:50:16 +0900 (JST)
	(envelope-from owner-man-jp@jp.FreeBSD.org)
Received: from smtp1.interramp.com (smtp1.interramp.com [38.8.45.2])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id PAA61699
	for <man-jp@jp.freebsd.org>; Tue, 26 Dec 2000 15:50:15 +0900 (JST)
	(envelope-from horikawa@psinet.com)
Received: from [38.26.194.130] (helo=localhost)
	by smtp1.interramp.com with esmtp (Exim 1.90 #1)
	for man-jp@jp.freebsd.org
	id 14Anw3-00014h-00; Tue, 26 Dec 2000 01:50:12 -0500
To: man-jp@jp.freebsd.org
In-Reply-To: <200012122003.eBCK32702056@oasis.sharplabs.com>
References: <20001211181959Y.horikawa@psinet.com>
	<200012122003.eBCK32702056@oasis.sharplabs.com>
X-Mailer: Mew version 1.94.1 on Emacs 19.34 / Mule 2.3 (SUETSUMUHANA)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=iso-2022-jp
Content-Transfer-Encoding: 7bit
Message-Id: <20001226014958K.horikawa@psinet.com>
Date: Tue, 26 Dec 2000 01:49:58 -0500
From: Kazuo Horikawa <horikawa@psinet.com>
X-Dispatcher: imput version 20000228(IM140)
Lines: 40
Reply-To: man-jp@jp.freebsd.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+000315
X-Sequence: man-jp 2957
Subject: [man-jp 2957] mdoc(7)NG (Re: Fw: HEADS UP: manual pages
 commits are frozen in RELENG_4)
Errors-To: owner-man-jp@jp.freebsd.org
Sender: owner-man-jp@jp.freebsd.org
X-Originator: horikawa@psinet.com

 堀川です。

> おとと。「man 形式から mdoc 形式に変換した」でなく、「すでに mdoc になっ
> てるページのマクロ使い方の間違いを直した」という感じですね。
 大部分が完了したみたいです (といっても完了宣言されていないので、今後
発生するかも)。
 今回の修正は、mdoc(7)NG (NG = next generation?) 用の準備を兼ねていた
ようです。mdoc(7)NG なるものは、mdoc(7) を改良したもので、
groff-current (1.17) に付属するものとのこと。ChangeLog 見ると、Ruslan
(ru@FreeBSD.org) 自身も (が？) 開発者のようです。groff-current は 
ftp.ffii.org にあります。

 最近の FreeBSD base system の groff は 1.16.1 ベースになりましたが、
この groff とともに動作する tmac.doc にも mdoc(7)NG の新機能がマージさ
れています。

 最近マニュアルページに適用された修正で、目にとまるところでは：
 (1) .An -nosplit と .An -split が追加された。
     これまでの .An は、AUTHORS セクション中で常に改行を発生していたが、
     .An -nosplit によって改行しないように指定可能となった。
     従来の、tmac.doc で最近のマニュアルを整形すると "-nosplit" などと
     表示されてしまうことがあるので、tmac.doc の更新が必要。

 (2) SYNOPSIS で、".Nm hogehoge" と書かなくても (".Nm" と書くだけで)、
     改行されるようになった (これって既存のマニュアルを書き換えなくて
     もよかったのではと思うのですが、既に済んでしまった後だったので
     わざわざ文句は言いませんでした)。
     従来の、tmac.doc で最近のマニュアルを整形すると SYNOPSIS が改行
     されずに表示されてしまうことがある。

 (3) closing punctuation (. や ? や !) の後に幅 0 空白 \& が、追加され
     た部分がある。groff 1.17 では、closing punctuation (通常は文の終り)
     後には空白 2 個が追加されるようになるとのこと。文の終りではない 
     closing punctuation 後には \& を明示的に付けて、空白 2 個が追加さ
     れることを避けているとのこと。

 mdoc(7)NG のインパクトやメリット等の詳細は Ruslan がまたポストする
そうなので、そうなったらまたフォワードします。
--
堀川和雄
