refer

名称

書式

解説

.de R1
.ig R2
..

オプション

-b

no-label-in-text; no-label-in-reference

-e

accumulate

-n

no-default-database

-C

compatible

-P

move-punctuation

-S

label "(A.n|Q) ', ' (D.y|D)"; bracket-label " (" ) "; "

-an

reverse An

-cfields

capitalize fields

-fn

label %n

-ifields

search-ignore fields

-k

label L~%a

-kfield

label field~%a

-l

label A.nD.y%a

-lm

label A.n+mD.y%a

-l,n

label A.nD.y-n%a

-lm,n

label A.n+mD.y-n%a

-pfilename

database filename

-sspec

sort spec

-tn

search-truncate n

-B

annotate X AP; no-label-in-reference

-Bfield.macro

annotate field macro; no-label-in-reference

-v

バージョン番号を表示します。

-R

.R1 / .R2 で始まる行を認識しません。

使用法

図書目録データベース

A

作者の名前。 名前の末尾に Jr. のような肩書が含まれる場合はコンマでラストネームと区切られていなければ なりません。 A フィールドは複数回現れても構いません。 出現する順番は意味を持ちます。 A フィールドか Q フィールドは常に指定するのが良いでしょう。

B

ある本の一部である記事において、その本のタイトルです。

C

出版社の所在地 (都市) です。

D

出版された日付です。 出版年に略称を使用してはいけません。 もし出版月を指定する場合は数字による月ではなく、月名を使わなければなり ませんが、最初の 3 文字を指定すれば十分です。 D フィールドは常に指定するのが良いでしょう。 ただし、出版の日付が分からなければ in press や unknown のような値を使うこともできます。

E

ある本の一部である記事において、その本の編集者の名前です。 出版作業が著者のない編集だけのものであった場合、編集者の名前を A フィールドで指定し、 , (ed) または , (eds) を最後の著者の後に指定しなければなりません。

G

米国政府注文番号です。

I

出版者 (発行人) です。

J

定期刊行物の記事における、その刊行物の名称です。

K

検索に使われるキーワードです。

L

ラベルです。

N

定期刊行物の発行番号です。

O

その他の情報です。 これは通常参考文献の末尾に印刷されます。

P

ページ番号です。 ページ番号の範囲は m - n で指定できます。

Q

著者が個人でない場合の著者の名称です。 これは A フィールドがない場合にのみ使用されます。 Q フィールドは 1 つのみ使うことができます。

R

技術報告書番号です。

S

シリーズの名称です。

T

タイトルです。 本や定期刊行物中の記事ではこれは記事のタイトルとなります。

V

定期刊行物もしくは本のボリューム番号です。

X

注釈です。

引用

#

これは short-label コマンドによって指定されるラベルを label コマンドで指定されるものの代わりに使用することを指示します。 もしショートラベルが指定されなければ、通常のラベルが使用されます。 普通はショートラベルは auther-date ラベルに使用され、日付とおそらくは 曖昧さが取り除かれた文字から構成されます。ここで、 # はラベルの数字によるタイプを示唆するものと考えられます。

[

bracket-label コマンドの中で指定される最初の文字列が opening-text の前に置かれます。

]

bracket-label コマンドの中で指定される 2 番目の文字列が closing-text の後に置かれます。

コマンド

abbreviate* fields string1 string2 string3 string4

fields のファーストネームを短縮形にします。 頭文字ともう 1 つの頭文字の間には string1 が挿入されます。 ラストネームとの間には string2 が挿入され、その他のもの ( von や de のようなもの) との間には string3 が挿入されます。これらのストリングのデフォルトはピリオドにスペースが続 いたものとなります。 ハイフンで区切られたファーストネームの中で、名前の最初の部分の頭文字は string4 (デフォルトはピリオド) によってハイフンと分離されます。 省略形に起因する曖昧さについては特に考慮していません。 名前はソートする前およびラベルが構築される前に省略形にされます。

abbreviate-label-ranges* string

連続した参考文献を参照する 3 つ以上の隣接するラベルは、最初のラベル string 最後のラベルの順からなる 1 つのラベルに省略されます。 これは主に数字ラベルにおいて便利です。 string が省略された場合のデフォルトは - です。

accumulate*

各参考文献を出現するたびに書き出すのではなく、参考文献を蓄積していきます。 蓄積された参考文献はすべての入力ファイルが処理され .R1 行が認識された後に、

annotate* field string

field は注釈です。注釈は参考文献の最後に

articles string...

string... は定冠詞もしくは不定冠詞であり、ソートされる時にはフィールド T の最初では無視されなければなりません。 初期状態では the と a と an が冠詞として認識されます。

bibliography filename...

図書目録データベース filename... に含まれる全ての参考文献を書き出します。

bracket-label string1 string2 string3

テキスト中で、各ラベルを string1 と string2 で囲みます。 string2 の直後に string1 が現れた場合は string3 に置き換えられます。 デフォルトでは

capitalize fields

fields を大文字とそれに続く小文字に変換します。

compatible*

スペースや改行以外の文字が次に続く場合でも .R1 と .R2 を認識します。

database filename...

図書目録データベース filename... を検索します。 各々の filename について、もし indxbib(1) によって生成されたインデックス filename.i が存在すれば、それが代わりに検索されます。各インデックスは複数のデータ ベースをカバーできます。

date-as-label* string

string はラベルを構成した後にフィールド D を置き換える文字列を指定するラベル式です。 ラベル式の説明については ラベル式 の項を参照して下さい。 このコマンドは参考文献リストの中で明示的なラベルは使いたくないが、何ら かの方法で日付を修飾することによって曖昧さを取り除きたい場合に便利です。 通常、テキスト中で使用されているラベルは作者と日付の組み合わせになります。 ほとんどの場合、 no-label-in-reference コマンドも使う必要があります。 例えば、

default-database*

デフォルトのデータベースを検索します。 これはデフォルトの動作であり、このコマンドの否定バージョンが有用です。 refer は検索を行なう必要が最初に出てきた場合、デフォルトのデータベースを 検索するべきかどうかを決定します。 そのため no-default-database コマンドを有効とするためには、それ以前に指定しておく必要があります。

discard* fields

参考文献が読み込まれた時、 fields を無効とします。 fields の文字列の定義は出力されません。 初期状態では fields は XYZ となっています。

et-al* string m n

ラベル式における式 @ の評価での et al の使い方を制御します。 著者のシーケンスを明確にするために必要な著者の数を u 、著者の合計が t とすると、最後の t-u の著者が string によって置換され、 t-u が m より小さくなく、 t が n より小さくないようになります。 デフォルトでは

include filename

filename をインクルードし、その内容をコマンドとして解釈します。

join-authors string1 string2 string3

これはどのように作者を連結するかを指定します。 ちょうど 2 人の作者がある場合、 string1 によって連結されます。 2 人より多い作者がある場合、最後の 2 人を除いた作者は string2 で連結され、最後の 2 人の作者は string3 で連結されます。 もし string3 が省略されると、デフォルトは string1 となります。 もし string2 も省略されると、デフォルトは string1 となります。 例えば、

label-in-reference*

参考文献を出力する時に、文字列 [F を参考文献のラベルに定義します。 これはデフォルトの動作です。このコマンドの否定バージョンが有用です。

label-in-text*

各参考文献においてテキスト中のラベルを出力します。 ラベルは bracket-label コマンドに記述されているようにそれを囲むテキストと分離されます。 これはデフォルトの動作です。このコマンドの否定バージョンが有用です。

label string

string はどのように各参考文献にラベルをつけるかを記述するラベル式となります。

separate-label-second-parts string

2つの部分からなるラベルをマージする時、2 番目のラベルの 2 番目の部分を string で最初のラベルと分離します。 ラベル式については <> のラベル式の説明を参照して下さい。

move-punctuation*

テキストにおいてラベルの後の行末の句読点を移動します。 ラベルに肩文字の数字を使っていなければ、このコマンドを使うといいでしょ う。

reverse* string

名前が string 中にあるフィールドを逆にします。 各フィールド名の後にはいくつのフィールドが逆にされるかを示す数が指定さ れます。 フィールドにこの数が指定されなければ、そのフィールドは全て逆になります。

search-ignore* fields

インデックスが存在しないデータベースでキーを検索している際に、 fields の内容を無視します。 初期状態ではフィールド XYZ が無視されます。

search-truncate* n

キーの最初の n 文字が与えられることのみを要求します。 実際にデータベース中で与えられたキーを検索する時には n とキーの長さの大きい方の長さに切られます。 初期状態では n は 6 です。

short-label* string

string はラベルのもう 1 つの (通常は短縮形の) スタイルを指定するラベル式です。 これは # フラグが引用で与えられている時に使われます。 author-date スタイルのラベルを使う時、作者は文脈から明らかに識別できる ことがあり、ラベルでは作者を省略したいことがあります。 通常、 short-label コマンドは日付と (多分) 明確な文字のみを含むラベルを指定するために使用 されます。

sort* string

string に従って参考文献をソートします。 参考文献は自動的に累積されます。 string はフィールド名のリストであり、各フィールド名にはソートに使われる名前に いくつのフィールドがあるかを示す数字が続きます。 + を名前のついた全てのフィールドを使うことを示すために使うことができます。 また、 . を参考文献が (一時的な) ラベルを使ってソートされることを示すために使う こともできます。 ( ラベル式 のセクションで一時的なラベルの概念について説明しています。)

sort-adjacent-labels*

参考文献リスト中での位置に従って、テキスト中の隣接しているラベルをソー トします。 このコマンドは通常は abbreviate-label-ranges コマンドが与えられている時か、ラベル式に <> 式が含まれている時に使用するべきです。 これは参考文献が累積されていないと影響がありません。

ラベル式

field

 

field n

field の n 番めの部分です。 n が省略された場合はデフォルトは 1 となります。

'string'

string 中の文字は文字通り解釈されます。

@

全ての作者を join-authors コマンドで指定された通りに連結します。 各々の作者名の全体が使用されます。 しかし参考文献が作者でソートされると (すなわち A+ で始まるソート仕様)、 作者のラストネームが代わりに使用され (これは曖昧さを持ち込みません)、 また作者の頭文字のシーケンスが全ての作者の代わりに使用されます (これも 曖昧さを持ち込みません)。 いくつかの参考文献の i番目 の作者にラストネームだけを使うのは他に参考文献がある時には曖昧であると 考えられます。すなわち参考文献の最初の i-1 人の作者が同じで、 i番目 の作者は同じでないが、 i番目 の作者のラストネームが同じであるような場合です。 いくつかの参考文献の作者のシーケンスの適切な頭文字のサブシーケンスは、 適切な頭文字のサブシーケンスとしてのサブシーケンスをもつ作者の別のシー ケンスをとる参考文献がある場合には、曖昧であると考えられます。 作者の頭文字のサブシーケンスが使われる場合、残りの作者は et-al コマンドで指定された文字列で置き換えられます。 このコマンドは頭文字のシーケンスを使うことができる以前に満たされる追加 の要求も指定できます。 @ は一時的に作者の正式の表現に評価され、ソートのために同等かどうかを比較 する作者は同じ表現となります。

%n

 

%a

 

%A

 

%i

 

%I

参考文献のシリアル番号は % が続く文字に従ってフォーマットされます。 参考文献のシリアル番号はこの参考文献として同じ一時的ラベルをもつ先に現 れた参考文献の番号に 1 を加えたものとなります。 これらの式は一時的に空の文字列に評価されます。

expr*

この参考文献としての同じ一時的ラベルを持つもう 1 つの参考文献がある場合、 空の文字列でなければ expr となります。 これは一時的に評価され、空の文字列になります。

expr+n

 

expr-n

expr の最初 (+) または末尾 (-) の n 文字の大文字か小文字か数字です。 troff の ( \('a のような) 特別文字は 1 文字としてカウントされます。 アクセント文字列は保持されますが、合計にはカウントされません。

expr.l

expr を小文字に変換したものです。

expr.u

expr を大文字に変換したものです。

expr.c

expr を大文字とそれに続く小文字に変換したものです。

expr.r

expr をラストネームが最初に来るように逆にしたものです。

expr.a

ファーストネームが略称になった expr です。 abbreviate コマンドによって指定されたフィールドはラベルが評価される前に略称にされ ます。 このため、 .a は参考文献の中ではなくラベルの中でのみフィールドを略称にしたい時のみ有 用です。

expr.y

expr の年の部分です。

expr.+y

expr の年の前の部分、もしくはそれが年を含んでいなければ expr の全体となります。

expr.-y

expr の年の後の部分、もしくは expr が年を含んでいなければ空の文字列となります。

expr.n

expr のラストネームの部分となります。

expr1~expr2

expr1 となります。ただし、 expr1 の最後の文字が - である場合は expr2 に置き換えられます。

expr1 expr2

expr1 と expr2 の結合です。

expr1|expr2

expr1 が空でなければ expr1 となり、それ以外では expr2 となります。

expr1&expr2

expr1 が空でなければ expr2 となり、それ以外では空の文字列となります。

expr1?expr2:expr3

expr1 が空でなければ expr2 となりそれ以外では expr3 となります。

<expr>

このラベルには 2 つの部分があり、 expr によって分離されています。 2 つの部分からなり、最初の部分が同じである 2 つの連続したラベルは最初 のラベルに次のラベルの 2 番目の部分を追加し、 separate-label-second-parts コマンド (初期値ではスペースが続くコンマ) によって指定された文字列によっ て分離することによってマージされます。その結果のラベルもまた 2 つの部 分からなるラベルとなり、最初の部分がマージ前の最初の部分となります。さ らに追加されるラベルはこれにマージされます。 最初の部分が空であっても差し支えありません。これは short-label コマンドで使う式で使うことができます。

(expr)

expr と同様です。 グルーピングを行なうために使われます。

マクロインタフェース

関連ファイル

/usr/share/dict/papers/Ind

デフォルトのデータベースです。

file.i

インデックスファイルです。

関連項目

バグ