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)