REFER(1)

名称
refer - GROFF のための参考文献プリプロセッサ

書式
refer [-benvCPRS] [-a n] [-c fields] [-f n] [-i fields] [-k field] [-l m,n] [-p filename] [-s fields] [-t n] [-B field.macro] [ filename... ]

解説
本マニュアルでは、groff ドキュメントフォーマットシステムの一部である GNU バージョンの refer について記述します。 refer は、入力ファイルの .[ 行と .] 行の間を引用と解釈して処理を行い、 .R1 行と .R2 行の間を、 引用がどのように処理されるべきかを記述したコマンドであると解釈して処理を 行います。残りの部分は、そのまま標準出力へ出力します。

各引用は、参照文献を指します。引用は、対象とする参考文献を特定できるような キーワードの集合を記述することで、文献目録の中の参考文献を指定できます。また、 引用のなかにデータベースのレコードを指定することもできます。キーワードと レコードの両方を指定することもできます。

各引用に対して、 refer はマークを出力します。マークは、いろいろな方法によって、本文や 他のマークと分離されます。マクロパッケージが参照文献リストを出力するための groff コマンドも、各引用ごとに出力されます。このため、 refer の出力は適当なマクロパッケージによって後処理される必要があります。 -ms と -me は、どちらも適当なマクロセットです。参照リストのためのコマンドは、 それぞれの引用ごとの直後か、もう少し後の場所にまとめて出力されます。 まとめて出力される場合は、数回引用された参照文献に対しても、ただ 1 つの 参照文献リストコマンドが出力されます。

.R1 行と .R2 行の間を解釈するのは GNU refer の新機能です。この機能を用いたドキュメントは、 以下の数行を文章の先頭に挿入することにより、UNIX の refer によって処理することが可能になります。

    .de R1
    .ig R2
    ..
これは、 troff に .R1 から .R2 までを無視するように指示しています。 refer では .R1 から .R2 の間に記述できるコマンドの一部と同等の効果をコマンドラインオプションによって 指定することができます。しかし、これらは、主に従来の refer との互換性のため用意されたものであり、通常はコマンド を使うほうが便利です。

refer は、 refer の出力を読み込んで処理を行うコマンドが正しい入力ファイル名と行番号を 知ることができるように .lf コマンドを出力します。 refer はまた、 soelim(1) で処理されたような入力であっても、正しくファイル名や行番号が生成できるように .lf コマンドを解釈もします。

関連項目
indxbib(1), lookbib(1), lkbib(1)