名称

checknr − nroff/troffファイルをチェックする

形式

checknr [ −s ] [ −f ] [ −a.x1.y1.x2.y2. ... .xn.yn ] [ −c.x1.x2.x3 ... .xn ] [ file ...  ]

解説

checknr は、 nroff(1) または troff(1) の入力ファイルのリストに不一致になっている オープンおよびクローズのセパレータや不明のコマンドも含め、 何種類かのエラーがないかどうかをチェックします。 ファイルが指定されない場合には、 checknr は標準入力をチェックします。セパレータのチェックには次のものがあります。

(1)\fx ... \fPを使用したフォントの変更

(2)\sx ... \s0を使用したサイズの変更

(3)オープン ... クローズの形のマクロ。 例えば、.TS および .TE マクロは常に対で使用されていなければならない。

checknr は、 ms(7) および me(7) マクロパッケージについての情報を持っています。

−a オプションを使用することによって、 対になっているマクロをリストに追加することができます。 このオプションの後ろには、 1グループが 1対のマクロを定義する 6キャラクタから成る、 いくつかのグループを付けなければなりません。 この 6キャラクタは、1個のピリオド、 対を構成する第1のマクロ名、もう 1個のピリオド、 および対を構成する第2のマクロ名です。 例えば、1対の .BS と .ES を定義するためには、−a.BS.ES とします。

−c オプションは、 もし定義しなければ未定義として注意が出されるコマンドを定義します。

−f オプションは、 checknr にフォントの変更 \f を無視することを要求します。

−s オプションは、 checknr にサイズの変更 \s を無視することを要求します。

checknr は、 checknr を用いることが念頭に置かれて作成される ドキュメントに対して使用されるべきものであり、 これは lint の場合とまったく同様です。 checknr の場合、\f および \s コマンドについては、 ドキュメント内で一定のスタイルで書かれていることが期待されます。 各 \fx は \fP で終わっていなければなりませんし、 各 \sx は \s0 で終わっていなければなりません。 多くのドキュメントでは、次のフォントに直接移行したり、 あるいは元のフォントまたは ポイントサイズを明示的に指定したりしていますが、 そのようにすると checknr によって注意されることになります。 とにかく \fP と \s0 の形を使用するほうがより良いと思われるので、 そのやり方がドキュメントの作成スタイルに貢献するものと考えてください。

関連事項

nroff(1), troff(1), checkeq(1), ms(7), me(7)

診断

不一致のセパレータについて注意します。
認識されないコマンドについて注意します。
コマンドの構文に関する様々な注意が出されます。

バグ

−a を使用して 1キャラクタのマクロ名を定義する方法はありません。 条件のような構造を正しく認識しません。

NEWS-OSRelease 3.3