Man page - groff(7)

Packages contains this manual

Available languages:

en ja

Manual

GROFF

名 称
解 説
groff 要 素
制 御 文 字
数 式
条 件 式
リ ク エ ス ト
リ ク エ ス ト の 簡 易 リ フ ァ レ ン ス
エ ス ケ ー プ シ ー ケ ン ス
1 文 字 の エ ス ケ ー プ シ ー ケ ン ス
特 殊 文 字
レ ジ ス タ
読 み 込 み 専 用 レ ジ ス タ
書 き 込 み 可 能 な レ ジ ス タ
警 告
互 換 性
バ グ
作 者
関 連 項 目

名 称

groff - GNU roff 言 語 の 簡 易 リ フ ァ レ ン ス

解 説

groff と は 、 GNU roff を 表 し て お り 、 roff 清 書 シ ス テ ム を フ リ ー で 実 装 し た も の で す 。 groff シ ス テ ム の 概 観 な ら び に 背 景 に つ い て は roff (7) を 参 照 し て く だ さ い 。

こ の ド キ ュ メ ン ト で は 、 groff 内 で 使 用 さ れ る 、 あ ら か じ め 定 義 さ れ た roff 言 語 要 素 を 簡 潔 に 説 明 し て い る だ け で す 。 古 く か ら あ る 機 能 と groff 拡 張 機 能 に つ い て の 両 方 と も 扱 っ て い ま す 。

歴 史 的 に 、 roff 言 語 は troff と 呼 ば れ て い ま す 。 groff は 、 古 く か ら あ る シ ス テ ム と 互 換 性 を 持 ち つ つ 、 独 自 の 拡 張 機 能 も 提 供 し て い ま す 。 そ の た め GNU 版 で は 、 roff , troff , groff 言 語 と い う 術 語 は 同 義 と し て 使 う こ と も で き る で し ょ う 。 し か し 、 troff は 、 ど ち ら か と 言 え ば 古 く か ら の 機 能 に 対 し て 適 用 さ れ る と い う 傾 向 が あ り 、 そ れ に 対 し て 、 groff は GNU 拡 張 に 重 き を 置 い て い ま す 。 そ し て 、 roff は 、 こ の 言 語 の 一 般 的 な 術 語 に な っ て い ま す 。

こ の フ ァ イ ル は 、 groff info (1) フ ァ イ ル に あ る 完 全 な ド キ ュ メ ン ト の 簡 易 版 に 過 ぎ ま せ ん 。 info フ ァ イ ル の 方 が よ り 詳 細 で 実 情 に 近 く 、 正 確 な 情 報 を 含 ん で い ま す 。

groff ド キ ュ メ ン ト を 書 く た め に 使 う 一 般 的 な 文 法 は 比 較 的 や さ し い の で す が 、 roff 言 語 の 拡 張 機 能 を 書 く の は 少 々 骨 が 折 れ る か も し れ ま せ ん 。

roff 言 語 は 、 行 指 向 の 言 語 で す 。 行 に は 、 制 御 行 と テ キ ス ト 行 の 2 種 類 し か あ り ま せ ん 。 制 御 行 は 制 御 文 字 で 始 ま り ま す 。 制 御 文 字 は 、 デ フ ォ ル ト で は ピ リ オ ド “ . ” あ る い は シ ン グ ル ク ォ ー ト “ ’ ” で す 。 そ の ほ か の 文 字 で 始 ま る 行 は す べ て テ キ ス ト 行 で す 。

制 御 行 は 、 コ マ ン ド を 表 し 、 オ プ シ ョ ン で 引 数 を 取 る こ と も あ り ま す 。 制 御 行 は 、 次 の よ う な 文 法 に な り ま す 。 先 頭 の 制 御 文 字 の 後 に は 、 コ マ ン ド 名 を 続 け る こ と が で き ま す 。 引 数 は 、 も し あ れ ば 、 コ マ ン ド 名 や 他 の 引 数 と 空 白 で 分 け ら れ ま す 。 例 え ば 、 次 の よ う に し ま す 。

.command_name arg1 arg2

イ ン デ ン ト 用 に 、 先 頭 の 制 御 文 字 と コ マ ン ド 名 と の 間 に は ス ペ ー ス や タ ブ 文 字 を い く つ 入 れ て も 良 い で す が 、 制 御 文 字 は 行 の 先 頭 に な く て は な り ま せ ん 。

テ キ ス ト 行 は 、 表 示 さ れ る 部 分 の こ と で す 。 テ キ ス ト 行 は エ ス ケ ー プ シ ー ケ ン ス で 変 更 す る こ と が で き ま す 。 エ ス ケ ー プ シ ー ケ ン ス は 先 頭 に バ ッ ク ス ラ ッ シ ュ ‘ \ ’ を 置 く こ と で 認 識 さ れ ま す 。 こ れ ら は 、 行 や 単 語 の 一 部 に 含 ま れ 、 整 形 要 素 と な っ た り 関 数 と な っ た り し ま す 。 エ ス ケ ー プ シ ー ケ ン ス に は 、 シ ン グ ル ク ォ ー ト “ ’ ” で 区 切 ら れ た 引 数 を 取 る も の も あ り ま す し 、 開 き 括 弧 ‘ ( ’ に 続 い て 符 合 化 さ れ 長 さ の 一 定 な も の や 、 角 括 弧 ‘ [ ’ と ‘ ] ’ で 括 ら れ て い る も の も あ り ま す 。

roff 言 語 は 、 マ ク ロ な ど 、 言 語 拡 張 機 能 を 書 く た め の 柔 軟 な 手 段 を 提 供 し て い ま す 。 マ ク ロ 定 義 を 解 釈 す る 際 に 、 roff シ ス テ ム は コ ピ ー モ ー ド と 呼 ば れ る 特 別 な モ ー ド に 入 り ま す 。

コ ピ ー モ ー ド の 振 る 舞 い は と て も 扱 い に く い も の で も あ り ま す が 、 確 実 に 安 全 に 使 え る よ う に す る ル ー ル が い く つ か あ り ま す 。

1.

表 示 可 能 な バ ッ ク ス ラ ッ シ ュ は \e と 記 述 し な く て は な り ま せ ん 。 も っ と 正 確 に 言 え ば 、 \e は 現 在 の エ ス ケ ー プ 文 字 を 表 し ま す 。 バ ッ ク ス ラ ッ シ ュ の グ リ フ を 得 る に は \(rs を 使 用 し て く だ さ い 。

2.

バ ッ ク ス ラ ッ シ ュ は す べ て 2 重 に し て く だ さ い 。

3.

テ キ ス ト 行 は す べ て 、 ス ペ ー ス を と ら な い 特 殊 文 字 \& で 始 め て く だ さ い 。

こ の や り 方 は 、 一 番 効 率 の 良 い コ ー ド が 生 成 で き る と い う わ け で は あ り ま せ ん が 、 最 初 の 一 歩 と し て は 使 え る は ず で す 。 さ ら に 良 い や り 方 に つ い て は groff info フ ァ イ ル お よ び groff_tmac (5) を 参 照 し て く だ さ い 。

roff ソ ー ス フ ァ イ ル を 読 む の は こ れ よ り は 簡 単 で す 。 す べ て の マ ク ロ 定 義 部 分 で 2 重 に な っ て い る バ ッ ク ス ラ ッ シ ュ を 1 つ に 置 き 換 え れ ば よ い だ け で す 。

groff 要 素

roff 言 語 の 要 素 は 、 テ キ ス ト フ ァ イ ル に 整 形 用 情 報 を 付 加 す る も の で す 。 基 本 的 な 要 素 は 、 あ ら か じ め 定 義 さ れ た コ マ ン ド お よ び 変 数 で あ り 、 こ の 要 素 の お か げ で roff は 本 格 的 な プ ロ グ ラ ミ ン グ 言 語 に な っ て い る の で す 。

roff コ マ ン ド に は 2 種 類 あ り ま す 。 コ マ ン ド は 引 数 を 取 る こ と も あ り ま す 。 リ ク エ ス ト は 、 ド ッ ト ‘ . ’ あ る い は “ ’ ” で 始 ま る 行 に 書 か れ る も の で す 。 こ れ に 対 し て エ ス ケ ー プ シ ー ケ ン ス は 、 バ ッ ク ス ラ ッ シ ュ ‘ \ ’ で 始 ま る 、 行 埋 め 込 み 式 の 関 数 や 単 語 中 の 整 形 要 素 で す 。

ユ ー ザ は 独 自 の 整 形 コ マ ン ド を .de リ ク エ ス ト を 使 っ て 定 義 す る こ と が で き ま す 。 こ れ ら の コ マ ン ド は マ ク ロ と 呼 ば れ て い ま す が 、 実 際 に は リ ク エ ス ト と ま っ た く 同 様 に 使 わ れ ま す 。 マ ク ロ パ ッ ケ ー ジ は groff 言 語 で 書 か れ た 定 義 済 み の マ ク ロ セ ッ ト で す 。 ユ ー ザ が 独 自 に エ ス ケ ー プ シ ー ケ ン ス を 作 成 で き る 場 合 と い う の は 非 常 に 限 ら れ て お り 、 特 殊 文 字 の み マ ッ プ す る こ と が で き ま す 。

groff 言 語 は 、 異 な る イ ン タ フ ェ ー ス を 持 つ い く つ か の 種 類 の 変 数 を 提 供 し て い ま す 。 定 義 済 み の 変 数 も あ り ま す が 、 ユ ー ザ も 同 様 に 自 分 で 変 数 を 定 義 で き ま す 。

文 字 列 変 数 は 文 字 列 を 格 納 し ま す 。 こ の 変 数 は .ds リ ク エ ス ト で 設 定 さ れ 、 値 は \* エ ス ケ ー プ シ ー ケ ン ス を 使 っ て 取 り 出 し ま す 。

レ ジ ス タ 変 数 は 数 値 、 ス ケ ー ル フ ァ ク タ つ き 数 字 、 場 合 に よ っ て は 文 字 列 に 似 た オ ブ ジ ェ ク ト を 格 納 で き ま す 。 .nr リ ク エ ス ト で 設 定 さ れ 、 値 は \n エ ス ケ ー プ シ ー ケ ン ス を 使 っ て 取 り 出 し ま す 。

環 境 を 使 う こ と に よ っ て 、 行 の 長 さ や フ ォ ン ト サ イ ズ な ど の よ う な グ ロ ー バ ル な 整 形 パ ラ メ ー タ を 、 後 の 再 利 用 の た め に ユ ー ザ が 一 時 的 に 格 納 す る こ と が で き ま す 。 こ れ は .ev リ ク エ ス ト に よ っ て 行 わ れ ま す 。

フ ォ ン ト は 、 名 前 も し く は 内 部 番 号 の ど ち ら か で 判 別 さ れ ま す 。 現 在 の フ ォ ン ト は .ft リ ク エ ス ト も し く は \f エ ス ケ ー プ シ ー ケ ン ス で 選 択 さ れ ま す 。 デ バ イ ス ご と に 特 別 フ ォ ン ト が あ り ま す が 、 次 の フ ォ ン ト は す べ て の デ バ イ ス で 利 用 可 能 で す 。 R は 標 準 フ ォ ン ト 、 ロ ー マ ン 体 で す 。 B は そ の ボ ー ル ド 体 で す 。 イ タ リ ッ ク 体 フ ォ ン ト は I と 呼 ば れ て お り ど こ で で も 利 用 可 能 で す が 、 テ キ ス ト デ バ イ ス で は ロ ー マ ン 体 フ ォ ン ト に 下 線 が つ い た も の と し て 表 示 さ れ ま す 。 グ ラ フ ィ カ ル の 出 力 デ バ イ ス に 対 し て は 、 次 の フ ォ ン ト の 固 定 幅 の 修 飾 文 字 が 存 在 し ま す 。 CR , CI , お よ び CB で す 。 テ キ ス ト デ バ イ ス で は 、 い ず れ に し て も 文 字 は す べ て 固 定 幅 で す 。

さ ら に 、 roff の 拡 張 要 素 が い く つ か あ り ま す 。 デ ィ バ ー ジ ョ ン は 、 後 で 利 用 で き る よ う に 情 報 を マ ク ロ に 格 納 し ま す 。 ト ラ ッ プ は 、 ペ ー ジ の 先 頭 か ら 何 行 目 と か 、 デ ィ バ ー ジ ョ ン や 入 力 に お い て 何 行 目 と い う よ う な 位 置 条 件 で す 。 ア ク シ ョ ン の 中 に は 、 条 件 が 揃 っ た と き に 自 動 的 に 起 動 す る よ う に 指 示 で き る も の が あ り ま す 。

こ れ よ り 詳 細 な 情 報 に つ い て は 、 groff info フ ァ イ ル に 示 さ れ て い ま す 。

制 御 文 字

あ る 条 件 下 で 特 別 な 制 御 タ ス ク を も つ 文 字 が い く つ か あ り ま す 。

.

ド ッ ト は 、 行 の 先 頭 あ る い は .if , .ie , .el , お よ び .while リ ク エ ス ト 中 の 条 件 の 後 に あ る 場 合 の み 特 別 で す 。 そ の 位 置 で は 、 リ ク エ ス ト (あ る い は マ ク ロ ) を 導 入 す る 制 御 文 字 に な り ま す 。 \. エ ス ケ ー プ を 使 う と 、 こ の 特 別 な 動 作 を 遅 ら せ る こ と が で き ま す 。 .cc リ ク エ ス ト を 使 う こ と で 、 こ の 制 御 文 字 を 別 の 文 字 に 設 定 し て 、 ド ッ ト ‘ . ’ を 特 殊 文 字 で な く す る こ と が で き ま す 。

他 の 位 置 に ド ッ ト が あ る と き は 、 た だ の ド ッ ト 文 字 以 上 の 意 味 は あ り ま せ ん 。 テ キ ス ト 段 落 の 中 で は 、 文 は そ れ ぞ れ 新 し い 行 で 始 め る ほ う が 有 利 で す 。

’

シ ン グ ル ク ォ ー ト に は 2 つ の 制 御 機 能 が あ り ま す 。 行 の 先 頭 お よ び 条 件 リ ク エ ス ト 内 で は 、 シ ン グ ル ク ォ ー ト は 非 ブ レ ー ク 制 御 文 字 に な り ま す 。 こ れ は 、 ド ッ ト の よ う に リ ク エ ス ト を 導 入 し ま す が 、 リ ク エ ス ト が 行 を 折 り 返 さ な い よ う な 追 加 の プ ロ パ テ ィ を つ け る も の で す 。 .c2 リ ク エ ス ト を 用 い る と 、 非 ブ レ ー ク 制 御 文 字 を 別 の 文 字 に 設 定 す る こ と が で き ま す 。

2 つ め の タ ス ク と し て 、 シ ン グ ル ク ォ ー ト は 、 い く つ か の 関 数 エ ス ケ ー プ シ ー ケ ン ス の 中 で 引 数 の 区 切 り 文 字 と し て よ く 使 用 さ れ ま す (引 数 に 含 ま れ な い 文 字 の ペ ア な ら ど れ で も 良 い の で す が )。 そ の 他 の 場 所 に あ れ ば 、 シ ン グ ル ク ォ ー ト 文 字 あ る い は ア ポ ス ト ロ フ ィ 文 字 に な り ま す 。 groff は 、 表 示 用 の 表 記 と し て エ ス ケ ー プ シ ー ケ ン ス \(cq を 提 供 し て い ま す 。

"

ダ ブ ル ク ォ ー ト は リ ク エ ス ト お よ び マ ク ロ 中 の 引 数 を 括 る と き に 使 用 さ れ ま す 。 .ds お よ び .as リ ク エ ス ト 内 で は 、 引 数 の 先 頭 に く る ダ ブ ル ク ォ ー ト は 取 り 除 か れ 、 そ の 後 に 続 く ダ ブ ル ク ォ ー ト 以 外 の 文 字 を 定 義 文 字 列 と し ま す (先 頭 に 空 白 が 来 る の を 有 効 に し ま す )。 エ ス ケ ー プ さ れ た ダ ブ ル ク ォ ー ト \" は コ メ ン ト の 開 始 に な り ま す 。 そ れ 以 外 は 、 ダ ブ ル ク ォ ー ト に は 特 別 な 機 能 は あ り ま せ ん 。 groff は 、 表 示 用 の 表 記 と し て エ ス ケ ー プ シ ー ケ ン ス \(dq を 提 供 し て い ま す 。

\

バ ッ ク ス ラ ッ シ ュ は 、 通 常 エ ス ケ ー プ シ ー ケ ン ス の 開 始 を 意 味 し て い ま す (こ の 文 字 は 、 ec リ ク エ ス ト に よ っ て 変 更 で き ま す )。 表 示 用 の エ ス ケ ー プ 文 字 は 、 エ ス ケ ー プ シ ー ケ ン ス \e で 、 バ ッ ク ス ラ ッ シ ュ の グ リ フ は \(rs で 得 ら れ ま す 。

(

開 き 括 弧 は 、 エ ス ケ ー プ シ ー ケ ン ス 内 で 、 ち ょ う ど 2 文 字 で で き た エ ス ケ ー プ 名 あ る い は 引 数 を 導 入 し た と き の み 特 別 な 意 味 を 持 ち ま す 。 groff で は 、 こ の 動 作 は [] の 組 で 置 き 換 え る こ と が で き ま す 。

[

開 き 角 括 弧 は 、 groff の エ ス ケ ー プ シ ー ケ ン ス 内 で の み 特 別 な 意 味 を 持 ち ま す 。 こ れ は 、 長 い エ ス ケ ー プ シ ー ケ ン ス 名 や エ ス ケ ー プ シ ー ケ ン ス の 引 数 を 導 入 す る と き に 使 用 し ま す 。 そ れ 以 外 の 場 合 は 、 例 え ば マ ク ロ 呼 び 出 し な ど で も 特 別 な 意 味 は あ り ま せ ん 。

]

閉 じ 角 括 弧 は 、 groff の エ ス ケ ー プ シ ー ケ ン ス 内 で の み 特 別 な 意 味 を 持 ち ま す 。 こ れ は 、 長 い エ ス ケ ー プ シ ー ケ ン ス 名 や エ ス ケ ー プ シ ー ケ ン ス の 引 数 を 終 わ ら せ ま す 。 そ れ 以 外 の 場 合 は 、 特 別 な 意 味 は あ り ま せ ん 。

space

空 白 文 字 は 、 機 能 的 な 働 き し か 持 た な い 文 字 で す 。 こ れ は 、 リ ク エ ス ト や マ ク ロ の 引 数 の 区 切 り 文 字 、 お よ び テ キ ス ト 行 に お け る 単 語 の 区 切 り 文 字 で す 。 ま た 、 空 白 文 字 は groff の 単 語 間 の 水 平 方 向 の 空 白 計 算 に 作 用 し ま す 。 定 義 さ れ た 空 白 幅 を 得 た い 場 合 は 、 ‘ \ ’ (エ ス ケ ー プ 文 字 と そ れ に 続 い た 空 白 文 字 )、 \| , \ˆ , あ る い は \h の よ う な エ ス ケ ー プ シ ー ケ ン ス を 使 う 必 要 が あ り ま す 。

newline

テ キ ス ト の 段 落 に お い て は 、 改 行 は 空 白 文 字 と ほ ぼ 同 じ よ う な 作 用 を し ま す 。 連 結 さ れ た 行 は 、 エ ス ケ ー プ し た 改 行 で 指 定 で き ま す 。 つ ま り 、 行 の 最 後 の 文 字 に ‘ \ ’ を 指 定 す る の で す 。

tab

テ キ ス ト 中 に タ ブ 文 字 が あ れ ば 、 イ ン タ プ リ タ は 次 の 定 義 済 み の タ ブ 位 置 へ 水 平 方 向 に イ ン デ ン ト を 作 り ま す 。 タ ブ 位 置 の 調 整 に は 洗 練 さ れ た イ ン タ フ ェ ー ス が 存 在 し ま す 。

数 式

数 値 は 、 符 号 つ き 整 数 、 符 号 な し 整 数 、 浮 動 小 数 点 実 数 の い ず れ か 、 お よ び そ れ に 単 位 指 定 子 を 付 加 し た も の で す 。 単 位 指 定 子 は 、 計 測 単 位 を 表 す 1 文 字 の 略 語 で す 。 単 位 指 定 子 が 後 に つ い た 数 字 は 、 サ イ ズ に 関 す る 値 を 意 味 し て い ま す 。 デ フ ォ ル ト で は 、 数 値 は 単 位 指 定 を 持 ち ま せ ん 。 つ ま り 、 単 な る 数 字 に す ぎ ま せ ん 。

roff 言 語 で は 、 次 の 単 位 指 定 子 を 定 義 し て い ま す 。

Image grohtml-4190714-1.png

数 式 は 、 先 で 定 義 さ れ た 数 値 と 算 術 演 算 子 ‘ + ’, ‘ - ’, ‘ * ’, ‘ / ’, ‘ % ’ ( 剰 余 ), 比 較 演 算 子 ‘ == ’ ( ‘ = ’ と 同 じ ), ‘ <= ’, ‘ >= ’, ‘ < ’, ‘ > ’, 論 理 演 算 子 ‘ & ’ ( 論 理 積 ), ‘ : ’ ( 論 理 和 ), ‘ ! ’ ( 否 定 ), お よ び 括 弧 ‘ ( ’ と ‘ ) ’ と の 組 み 合 わ せ で す 。

さ ら に 、 groff は 、 数 式 に 対 し て 次 の 演 算 子 を 追 加 し ま し た 。

Image grohtml-4190714-2.png

詳 細 は groff info フ ァ イ ル を 参 照 し て く だ さ い 。

条 件 式

条 件 式 は 、 リ ク エ ス ト .if , .ie , お よ び .while で の 判 定 文 で 出 て き ま す 。 次 の 表 に い ろ い ろ な 種 類 の 条 件 式 を 示 し ま す 。

Image grohtml-4190714-3.png

リ ク エ ス ト

こ の セ ク シ ョ ン で は 、 定 義 済 み の リ ク エ ス ト に つ い て 短 い リ フ ァ レ ン ス を 与 え ま す 。 groff で は 、 リ ク エ ス ト と マ ク ロ の 名 前 を 任 意 の 長 さ に す る こ と が で き ま す 。 長 い 名 前 に 対 し て 括 弧 で 括 っ た り マ ー ク を つ け る 必 要 は あ り ま せ ん 。

た い て い の リ ク エ ス ト は 1 つ 、 な い し は 複 数 の 引 数 を と り ま す 。 引 数 は 空 白 文 字 で 区 切 ら れ ま す (タ ブ で は あ り ま せ ん !)。 引 数 の 長 さ や 数 に つ い て 、 固 有 の 制 限 は あ り ま せ ん 。 引 数 は ダ ブ ル ク ォ ー ト で 括 る こ と が で き ま す 。 引 数 に 空 白 文 字 が 含 ま れ る 場 合 に と て も 便 利 で す 。 例 え ば 、 "arg with space" は 1 つ の 引 数 を 表 し て い ま す 。

リ ク エ ス ト の 中 に は 、 引 数 を 与 え る と 、 引 数 な し の 場 合 と 異 な っ た 動 き を す る も の が あ り ま す 。 そ の 詳 細 す べ て に つ い て は 、 こ こ で は 説 明 し ま せ ん 。 詳 細 は 、 groff info フ ァ イ ル を 参 照 し て く だ さ い 。

後 に 述 べ る リ ク エ ス ト の 説 明 で は 、 引 数 の 名 前 の 多 く は そ の 意 味 を 表 す よ う に 選 ば れ て い ま す 。 次 に あ げ る 表 記 に つ い て だ け は 、 意 味 を 明 ら か に す る 必 要 が あ る で し ょ う 。

Image grohtml-4190714-4.png

±N で 定 義 さ れ た 式 が ‘ + ’ 符 号 で 始 ま る 場 合 、 こ の 式 の 結 果 の 値 は 、 関 連 す る リ ク エ ス ト が す で に 持 っ て い る 固 有 値 に 加 算 さ れ ま す 。 例 え ば 、 数 値 レ ジ ス タ に 加 算 さ れ ま す 。 式 が ‘ - ’ で 始 ま る 場 合 、 こ の 式 の 結 果 の 値 は 、 リ ク エ ス ト の 値 か ら 減 算 さ れ ま す 。

符 号 が な い 場 合 は 、 既 存 の 値 を N で 直 接 置 き 換 え ま す 。 負 の 値 を 指 定 す る 場 合 は 、 0 を 前 に 置 く か あ る い は 負 の 値 を 括 弧 で 括 っ て く だ さ い 。

リ ク エ ス ト の 簡 易 リ フ ァ レ ン ス

.

空 行 (無 視 さ れ ま す )。 ド キ ュ メ ン ト の 整 形 に 便 利 で す 。

.\" anything

行 全 体 が コ メ ン ト と な り ま す 。

.ab string

string を 標 準 エ ラ ー 出 力 に 出 力 し 、 プ ロ グ ラ ム を 終 了 し ま す 。

.ad

現 在 の 位 置 揃 え モ ー ド で 出 力 行 の 位 置 揃 え を 開 始 し ま す 。

.ad c

位 置 揃 え モ ー ド c で 行 の 位 置 揃 え を 開 始 し ま す ( c =l,r,b,n)。

.af register c

フ ォ ー マ ッ ト c を レ ジ ス タ register に 割 り 当 て ま す ( c =l,i,I,a,A)。

.aln alias register

レ ジ ス タ register の 別 名 alias を 作 成 し ま す 。

.als alias object

リ ク エ ス ト 、 文 字 列 、 マ ク ロ 、 デ ィ バ ー ジ ョ ン object の 別 名 alias を 作 成 し ま す 。

.am macro

.. が 呼 ば れ る ま で の も の を マ ク ロ macro に 追 加 し ま す 。

.am macro end

.end が 呼 ば れ る ま で の も の を マ ク ロ macro に 追 加 し ま す 。

.am1 macro

リ ク エ ス ト .am と 同 じ で す が 、 マ ク ロ 展 開 の 時 に 互 換 モ ー ド が 無 効 に な り ま す 。

.am1 macro end

リ ク エ ス ト .am と 同 じ で す が 、 マ ク ロ 展 開 の 時 に 互 換 モ ー ド が 無 効 に な り ま す 。

.as stringvar anything

文 字 列 anything を 文 字 列 変 数 stringvar に 追 加 し ま す 。

.asciify diversion

デ ィ バ ー ジ ョ ン diversion に 含 ま れ る ASCII 文 字 、 ス ペ ー ス 、 お よ び エ ス ケ ー プ シ ー ケ ン ス の い く つ か を ア ン フ ォ ー マ ッ ト し ま す 。

.backtrace

入 力 の バ ッ ク ト レ ー ス を 標 準 エ ラ ー 出 力 に 出 力 し ま す 。

.bd font N

フ ォ ン ト font を N -1 単 位 分 強 調 し ま す 。

.bd S font N

現 在 の フ ォ ン ト が font の と き に 特 別 フ ォ ン ト S で 強 調 し ま す 。

.blm

空 行 マ ク ロ を 解 除 し ま す 。

.blm macro

空 白 行 マ ク ロ を マ ク ロ macro に 設 定 し ま す 。

.box

現 在 の デ ィ バ ー ジ ョ ン を 終 了 し ま す 。

.box macro

macro へ 転 換 し ま す 。 そ の 際 、 部 分 的 に 行 詰 め さ れ た 行 は 取 り 除 き ま す 。

.boxa

現 在 の デ ィ バ ー ジ ョ ン を 終 了 し ま す 。

.boxa macro

macro へ 転 換 し 、 追 加 し ま す 。 そ の 際 、 部 分 的 に 行 詰 め さ れ た 行 は 取 り 除 き ま す 。

.bp

現 在 の ペ ー ジ を 終 了 し て 新 し い ペ ー ジ を 開 始 し ま す 。

.bp ±N

現 在 の ペ ー ジ を 終 了 し ま す 。 次 の ペ ー ジ 番 号 を ±N に し ま す 。

.br

改 行 で す 。

.brp

改 行 し 、 出 力 行 を 引 き 延 ば し ま す 。 \p と 同 じ で す 。

.break

while ル ー プ を 終 了 し ま す 。

.c2

非 改 行 制 御 文 字 を “ ’ ” に 戻 し ま す 。

.c2 c

非 改 行 制 御 文 字 を c に 設 定 し ま す 。

.cc

制 御 文 字 を ‘ . ’ に 戻 し ま す 。

.cc c

制 御 文 字 を c に 設 定 し ま す 。

.ce

次 の 入 力 行 を セ ン タ リ ン グ し ま す 。

.ce N

次 に 来 る N 行 の 入 力 行 を セ ン タ リ ン グ し ま す 。

.cf filename

フ ァ イ ル filename の 内 容 を そ の ま ま 標 準 出 力 ま た は デ ィ バ ー ジ ョ ン へ コ ピ ー し ま す 。

.cflags mode c1 c2 ...

mode 番 号 に 従 っ て 、 文 字 c1 , c2 , ... を 扱 い ま す 。

.ch trap N

trap の 場 所 を N に 変 更 し ま す 。

.char c anything

文 字 c を 文 字 列 anything と 定 義 し ま す 。

.chop object

マ ク ロ 、 文 字 列 、 デ ィ バ ー ジ ョ ン object の 最 後 の 1 文 字 を と り 除 き ま す 。

.close stream

ス ト リ ー ム stream を ク ロ ー ズ し ま す 。

.continue

while ル ー プ に お け る 現 在 の 繰 り 返 し 処 理 を 終 了 し ま す 。

.cp

互 換 モ ー ド を 有 効 に し ま す 。

.cp N

N が 0 な ら 互 換 モ ー ド を 無 効 に し ま す 。 そ れ 以 外 な ら 有 効 に し ま す 。

.cs font N M

フ ォ ン ト font の 固 定 文 字 幅 モ ー ド を N /36 em に 設 定 し ま す (em は 値 M )。

.cu N

nroff の 場 合 の 連 続 ア ン ダ ー ラ イ ン 。 troff の リ ク エ ス ト .ul に 相 当 し ま す 。

.da

現 在 の デ ィ バ ー ジ ョ ン を 終 了 し ま す 。

.da macro

マ ク ロ macro に 転 換 ・ 追 加 し ま す 。

.de macro

リ ク エ ス ト .. が 呼 ば れ る ま で マ ク ロ macro を 定 義 (再 定 義 ) し ま す 。

.de macro end

リ ク エ ス ト .end が 呼 ば れ る ま で マ ク ロ macro を 定 義 (再 定 義 ) し ま す 。

.de1 macro

リ ク エ ス ト .de と 同 じ で す が 、 マ ク ロ 展 開 の 時 に 互 換 モ ー ド が 無 効 に な り ま す 。

.de1 macro end

リ ク エ ス ト .de と 同 じ で す が 、 マ ク ロ 展 開 の 時 に 互 換 モ ー ド が 無 効 に な り ま す 。

.dei macro

文 字 列 レ ジ ス タ macro に 名 前 が 含 ま れ る マ ク ロ を 、 .. が 呼 ば れ る ま で 定 義 (再 定 義 ) し ま す 。

.dei macro end

間 接 的 に マ ク ロ を 定 義 (再 定 義 ) し ま す 。 macro お よ び end は 文 字 列 レ ジ ス タ で あ り 、 こ の 内 容 が そ れ ぞ れ マ ク ロ 名 と 終 了 マ ク ロ に 挿 入 さ れ ま す 。

.di

現 在 の デ ィ バ ー ジ ョ ン を 終 了 し ま す 。

.di macro

マ ク ロ macro に 転 換 し ま す 。

.do name

リ ク エ ス ト .name を 、 互 換 モ ー ド を 無 効 に し て 解 釈 し ま す 。

.ds stringvar anything

文 字 列 変 数 stringvar に 文 字 列 anything を 設 定 し ま す 。

.dt N trap

デ ィ バ ー ジ ョ ン の ト ラ ッ プ 位 置 を N に 設 定 し ま す (デ フ ォ ル ト の 単 位 指 定 子 は v で す )。

.ec

エ ス ケ ー プ 文 字 を ‘ \ ’ に 戻 し ま す 。

.ec c

エ ス ケ ー プ 文 字 を c に 設 定 し ま す 。

.ecr

.ecs を 用 い て 保 存 さ れ て い る エ ス ケ ー プ 文 字 を 復 元 し ま す 。

.ecs

現 在 の エ ス ケ ー プ 文 字 を 保 存 し ま す 。

.el anything

if-else リ ク エ ス ト ( .ie ) の else ブ ロ ッ ク で す 。

.em macro

入 力 が 終 わ っ た 後 に マ ク ロ macro を 実 行 し ま す 。

.eo

エ ス ケ ー プ 文 字 の 処 理 を 抑 制 し ま す 。

.ev

直 前 の 環 境 に 変 更 し ま す 。

.ev env

環 境 env (番 号 ま た は 名 前 で 指 定 ) を プ ッ シ ュ し て 切 り 替 え ま す 。

.evc env

環 境 env の 内 容 を 現 在 の 環 境 に コ ピ ー し ま す 。 環 境 の プ ッ シ ュ ま た は ポ ッ プ は 行 い ま せ ん 。

.ex

roff の 処 理 を 終 了 し ま す 。

.fam

以 前 の フ ォ ン ト フ ァ ミ リ を 返 し ま す 。

.fam name

現 在 の フ ォ ン ト フ ァ ミ リ を name に 設 定 し ま す 。

.fc

フ ィ ー ル ド 機 構 を 無 効 に し ま す 。

.fc a

フ ィ ー ル ド 区 切 り を a に 設 定 し 、 パ デ ィ ン グ 文 字 を 空 白 に し ま す 。

.fc a b

フ ィ ー ル ド 区 切 り を a に 、 パ デ ィ ン グ 文 字 を b に 設 定 し ま す 。

.fi

出 力 行 を 埋 め ま す 。

.fl

出 力 バ ッ フ ァ を フ ラ ッ シ ュ し ま す 。

.fp n font

位 置 n に フ ォ ン ト font を マ ウ ン ト し ま す 。

.fp n internal external

長 い 名 前 external の フ ォ ン ト を 短 い 名 前 internal の フ ォ ン ト と し 、 位 置 n に マ ウ ン ト し ま す 。

.fspecial font s1 s2...

現 在 の フ ォ ン ト が font の 場 合 に 、 s1 , s2 , ... を 特 別 フ ォ ン ト に し ま す 。

.ft

直 前 の フ ォ ン ト に 戻 し ま す 。 リ ク エ ス ト \fP と 同 じ で す 。

.ft font

フ ォ ン ト 名 ま た は 番 号 font に 変 更 し ま す 。 エ ス ケ ー プ シ ー ケ ン ス \f[ font ] と 同 じ で す 。

.ftr font1 font2

フ ォ ン ト font1 を フ ォ ン ト font2 に 変 換 し ま す 。

.hc

追 加 ハ イ フ ネ ー シ ョ ン 指 定 文 字 を 削 除 し ま す 。

.hc c

追 加 ハ イ フ ネ ー シ ョ ン 指 定 文 字 と し て c を 設 定 し ま す 。

.hcode c1 code1 c2 code2 ...

文 字 c1 の ハ イ フ ネ ー シ ョ ン コ ー ド を code1 に 、 文 字 c2 の コ ー ド を code2 の よ う に 設 定 し ま す 。

.hla lang

現 在 の ハ イ フ ネ ー シ ョ ン 言 語 を lang に 設 定 し ま す 。

.hlm n

ハ イ フ ン さ れ た 行 の 最 大 連 続 数 を n に 設 定 し ま す 。

.hpf file

ハ イ フ ネ ー シ ョ ン の パ タ ー ン を フ ァ イ ル file か ら 読 み 込 み ま す 。

.hw words

例 外 的 な ハ イ フ ネ ー シ ョ ン を す る 単 語 の リ ス ト を words で 指 定 し ま す 。

.hy N

ハ イ フ ネ ー シ ョ ン モ ー ド を N に 変 更 し ま す 。

.hym n

ハ イ フ ネ ー シ ョ ン の 余 白 を n に 設 定 し ま す (デ フ ォ ル ト の 単 位 指 定 子 は m で す )。

.hys n

ハ イ フ ネ ー シ ョ ン の 空 白 を n に 設 定 し ま す 。

.ie cond anything

条 件 式 cond が 真 な ら ば anything を 処 理 し ま す 。 偽 の 場 合 は リ ク エ ス ト .el へ 移 動 し ま す 。

.if cond anything

条 件 式 cond が 真 な ら ば anything を 処 理 し ま す 。 偽 の 場 合 は 何 も し ま せ ん 。

.ig

リ ク エ ス ト .. が 呼 ば れ る ま で テ キ ス ト を 無 視 し ま す 。

.ig end

リ ク エ ス ト .end が 呼 ば れ る ま で テ キ ス ト を 無 視 し ま す 。

.in

イ ン デ ン ト 量 を 直 前 の 値 に 戻 し ま す 。

.in ±N

引 数 ±N に 従 っ て イ ン デ ン ト 量 を 変 更 し ま す (デ フ ォ ル ト の 単 位 指 定 子 は m で す )。

.it N trap

入 力 行 の カ ウ ン ト ト ラ ッ プ を 位 置 N に 設 定 し ま す 。

.kern

ペ ア ワ イ ズ カ ー ニ ン グ を 有 効 に し ま す 。

.kern n

n が 0 な ら ば ペ ア ワ イ ズ カ ー ニ ン グ を 無 効 に し ま す 。 0 で な け れ ば 有 効 に し ま す 。

.lc

リ ー ダ 繰 り 返 し 文 字 の 定 義 を 削 除 し ま す 。

.lc c

リ ー ダ 繰 り 返 し 文 字 を c に 設 定 し ま す 。

.length register anything

文 字 列 anything の 文 字 列 長 を レ ジ ス タ register に 書 き 込 み ま す 。

.linetabs

行 タ ブ モ ー ド を 有 効 に し ま す (つ ま り 、 出 力 行 に 比 例 し た タ ブ 位 置 を 計 算 し ま す )。

.linetabs n

n が 0 の 場 合 、 行 タ ブ モ ー ド を 無 効 に し ま す 。 そ れ 以 外 の 場 合 は 、 行 タ ブ モ ー ド を 有 効 に し ま す 。

.lf N file

入 力 す る 行 数 を N に 、 フ ァ イ ル 名 を file に 設 定 し ま す 。

.lg N

引 数 N が 0 よ り 大 き け れ ば リ ガ チ ャ (合 字 ) モ ー ド に し ま す 。

.ll

行 幅 を 直 前 の 値 に 戻 し ま す 。

.ll ±N

行 幅 を 引 数 ±N に 従 っ て 設 定 し ま す (デ フ ォ ル ト の 設 定 は 6.5 i で 、 単 位 指 定 子 は m で す )。

.ls

追 加 の 行 間 ス キ ッ プ 量 を 直 前 の 値 に 戻 し ま す 。

.ls N

追 加 の 行 間 ス キ ッ プ 量 を N に 設 定 し ま す 。 つ ま り 、 テ キ ス ト の 出 力 行 そ れ ぞ れ の 後 に N -1 行 の 空 白 行 を 挿 入 し ま す 。

.lt ±N

タ イ ト ル の 長 さ で す (デ フ ォ ル ト の 単 位 指 定 子 は m で す )。

.mc

余 白 文 字 を 無 効 に し ま す 。

.mc c

そ れ ぞ れ の テ キ ス ト 行 の 後 、 右 側 余 白 か ら 現 在 設 定 さ れ て い る 距 離 に 文 字 c を 出 力 し ま す 。

.mc c N

余 白 文 字 を c に 、 右 側 余 白 か ら の 距 離 を N に 設 定 し ま す (デ フ ォ ル ト の 単 位 指 定 子 は m で す )。

.mk register

現 在 の 垂 直 位 置 を register に マ ー ク し ま す 。

.mso file

リ ク エ ス ト .so と 同 じ で す が 、 tmac デ ィ レ ク ト リ に あ る file が 検 索 さ れ る 点 が 違 い ま す 。

.na

出 力 行 の 位 置 揃 え を 行 い ま せ ん 。

.ne

1 行 分 の 行 送 り が 必 要 で あ る こ と を 指 定 し ま す 。

.ne N

N 行 分 の 行 送 り が 必 要 で あ る こ と を 指 定 し ま す (デ フ ォ ル ト の 単 位 指 定 子 は v で す )。

.nf

出 力 行 に 行 詰 め や 位 置 揃 え を 行 い ま せ ん 。

.nh

ハ イ フ ネ ー シ ョ ン を し ま せ ん 。

.nm

行 番 号 モ ー ド を 無 効 に し ま す 。

.nm ±N M S I

行 番 号 モ ー ド の 、 行 番 号 、 行 番 号 出 力 間 隔 、 空 白 、 イ ン デ ン ト を 設 定 し ま す 。

.nn

次 の 行 に 行 番 号 を つ け ま せ ん 。

.nn N

次 の N 行 に 行 番 号 を つ け ま せ ん 。

.nop anything

anything を 常 に 実 行 し ま す 。

.nr register ±N M

レ ジ ス タ の 値 を 、 イ ン ク リ メ ン ト 値 M で ±N に 設 定 ・ 変 更 し ま す 。

.nroff

組 み 込 み 条 件 式 n を 真 に 、 t を 偽 に し ま す 。

.ns

空 白 な し モ ー ド に し ま す 。

.nx filename

次 の フ ァ イ ル へ 処 理 を 移 し ま す 。

.open stream filename

フ ァ イ ル filename を 書 き 込 み モ ー ド で オ ー プ ン し 、 名 前 stream を 持 つ ス ト リ ー ム に 関 連 づ け ま す 。

.opena stream filename

リ ク エ ス ト .open と 同 じ で す が 、 追 加 モ ー ド で フ ァ イ ル を オ ー プ ン し ま す 。

.os

リ ク エ ス ト .sv で 指 定 さ れ た 行 送 り 量 を 出 力 し ま す 。

.pc

ペ ー ジ 番 号 文 字 を ‘ % ’ に 戻 し ま す 。

.pc c

ペ ー ジ 番 号 文 字 を 設 定 し ま す 。

.pi program

プ ロ グ ラ ム program に 出 力 を パ イ プ し ま す (nroff の み )。

.pl

ペ ー ジ 長 を デ フ ォ ル ト の 11 i に 設 定 し ま す 。 現 在 の ペ ー ジ 長 は レ ジ ス タ .p に 格 納 さ れ て い ま す 。

.pl ±N

ペ ー ジ 長 を ±N に 変 更 し ま す (デ フ ォ ル ト の 単 位 指 定 子 は v で す )。

.pm

マ ク ロ 名 と サ イ ズ を 出 力 し ま す (サ イ ズ は 1 ブ ロ ッ ク 128 バ イ ト の ブ ロ ッ ク 数 で す )。

.pm t

マ ク ロ 全 体 の サ イ ズ の み を 出 力 し ま す (サ イ ズ は 1 ブ ロ ッ ク 128 バ イ ト の ブ ロ ッ ク 数 で す )。

.pn ±N

次 の ペ ー ジ 番 号 を N に 設 定 し ま す 。

.pnr

現 在 定 義 さ れ て い る 数 値 レ ジ ス タ の 名 前 と 内 容 を 標 準 エ ラ ー 出 力 に 出 力 し ま す 。

.po

ペ ー ジ オ フ セ ッ ト を 直 前 の 値 に 戻 し ま す 。 現 在 の ペ ー ジ オ フ セ ッ ト は レ ジ ス タ .o に 格 納 さ れ て い ま す 。

.po ±N

ペ ー ジ オ フ セ ッ ト を N に 設 定 し ま す 。

.ps

ポ イ ン ト サ イ ズ を 直 前 の 値 に 戻 し ま す 。

.ps ±N

ポ イ ン ト サ イ ズ を 指 定 し ま す 。 エ ス ケ ー プ シ ー ケ ン ス \s[ ±N ] と 同 じ で す 。

.psbb filename

PostScript 画 像 filename の た め の 矩 形 領 域 を 確 保 し ま す 。

.pso command

リ ク エ ス ト .so と 同 様 で す が 、 command の 標 準 出 力 か ら 入 力 し ま す 。

.ptr

す べ て の ト ラ ッ プ の 名 前 と 位 置 を 標 準 エ ラ ー 出 力 に 出 力 し ま す (入 力 行 の ト ラ ッ プ と デ ィ バ ー ジ ョ ン の ト ラ ッ プ は 含 ま れ ま せ ん )。

.rchar c1 c2...

文 字 定 義 c1 , c2 , ... を 削 除 し ま す 。

.rd prompt

標 準 入 力 か ら の 入 力 を 読 み 込 み ま す 。

.return

マ ク ロ か ら 戻 り ま す 。

.rj n

次 の n 行 の 入 力 行 を 右 寄 せ し ま す 。

.rm name

name で 指 定 さ れ た リ ク エ ス ト 、 マ ク ロ 、 文 字 列 を 削 除 し ま す 。

.rn old new

old で 指 定 さ れ た リ ク エ ス ト 、 マ ク ロ 、 文 字 列 の 名 前 を new に 変 更 し ま す 。

.rnn reg1 reg2

レ ジ ス タ 名 reg1 を reg2 に 変 更 し ま す 。

.rr register

レ ジ ス タ register を 削 除 し ま す 。

.rs

空 白 を 復 活 さ せ ま す 。 つ ま り 空 白 な し モ ー ド を 無 効 に し ま す 。

.rt ±N

(上 方 向 の み 、 ) マ ー ク し て お い た 垂 直 位 置 ま で 戻 し ま す (デ フ ォ ル ト の 単 位 指 定 子 は v で す )。

.shc

ソ フ ト ハ イ フ ン 文 字 を \(hy に 戻 し ま す 。

.shc c

ソ フ ト ハ イ フ ン 文 字 を c に 設 定 し ま す 。

.shift n

マ ク ロ に お い て 、 引 数 を 位 置 n に シ フ ト し ま す 。

.so filename

ソ ー ス フ ァ イ ル を イ ン ク ル ー ド し ま す 。

.sp

1 行 ス キ ッ プ し ま す 。

.sp N

N の 行 送 り を 挿 入 し ま す 。 N の 符 号 に よ っ て 上 下 方 向 が 決 ま り ま す (デ フ ォ ル ト の 単 位 指 定 子 は v で す )。

.special s1 s2 ...

フ ォ ン ト s1 , s2 , な ど を 特 別 フ ォ ン ト と し ま す 。 現 在 の フ ォ ン ト に な い 文 字 を こ れ ら か ら 検 索 し ま す 。

.ss N

空 白 文 字 の サ イ ズ を N /12 に 設 定 し ま す 。 単 位 は 現 在 の フ ォ ン ト の 空 白 幅 で す 。

.ss N M

空 白 文 字 の サ イ ズ を N /12 に 、 文 の 空 白 サ イ ズ を M /12 に 設 定 し ま す 。 単 位 は 現 在 の フ ォ ン ト の 空 白 幅 (=1/3 em) で す 。

.sty n style

位 置 n の フ ォ ン ト を ス タ イ ル style に 関 連 づ け ま す 。

.substring register n1 n2

レ ジ ス タ register の 文 字 列 の 中 の 部 分 文 字 列 n1 を n2 に 置 き 換 え ま す 。

.sv

行 送 り 量 を 1 v に 設 定 し ま す 。

.sv N

リ ク エ ス ト .os で 出 力 さ れ る 空 白 行 の 送 り 量 を N に 設 定 し ま す 。

.sy command-line

プ ロ グ ラ ム command-line を 実 行 し ま す 。

.ta T N

タ ブ 位 置 を N の 倍 数 に 設 定 し ま す (デ フ ォ ル ト の 単 位 指 定 子 は m で す )。

.ta n1 n2 ... nn T r1 r2 ... rn

位 置 n1 , n2 , ... , nn の タ ブ 位 置 を そ れ ぞ れ nn + r1 , nn + r2 , ... nn + rn に 、 さ ら に そ れ 以 降 を nn + rn + r1 , nn + rn + r2 , ... nn + rn + rn の よ う に 設 定 し ま す 。

.tc

タ ブ 繰 り 返 し 文 字 を 削 除 し ま す 。

.tc c

タ ブ 繰 り 返 し 文 字 を c に 設 定 し ま す 。

.ti ±N

次 の 行 を 一 時 的 に イ ン デ ン ト し ま す (デ フ ォ ル ト の 単 位 指 定 子 は m で す )。

.tkf font s1 n1 s2 n2

フ ォ ン ト font の ト ラ ッ ク カ ー ニ ン グ を 有 効 に し ま す 。

.tl ’ left ’ center ’ right ’

3 つ の 部 位 を も つ タ イ ト ル で す 。

.tm anything

anything を 端 末 (UNIX の 標 準 的 な メ ッ セ ー ジ 出 力 先 ) に 出 力 し ま す 。

.tm1 anything

anything を 端 末 (UNIX の 標 準 的 な メ ッ セ ー ジ 出 力 先 ) に 出 力 し ま す 。 そ の 際 、 anything が " で 始 ま っ て い る 場 合 は 、 先 頭 を 空 白 で 始 め る こ と が で き ま す ( " 自 体 は 取 り 除 か れ ま す )。

.tmc anything

.tm1 と 似 て い ま す が 、 末 尾 の 改 行 を 出 力 し ま せ ん 。

.tr abcd....

出 力 で a を b に 、 c を d の よ う に 変 換 し ま す 。

.trf filename

フ ァ イ ル filename の 内 容 を そ の ま ま 出 力 し ま す 。

.trnt abcd....

リ ク エ ス ト .tr と 同 じ で す が 、 \! に よ っ て デ ィ バ ー ジ ョ ン へ と 出 力 さ れ る テ キ ス ト は 変 換 さ れ ま せ ん 。

.troff

組 み 込 み 条 件 式 t を 真 に 、 n を 偽 に 設 定 し ま す 。

.uf font

ア ン ダ ー ラ イ ン フ ォ ン ト セ ッ ト を font に 設 定 し ま す (リ ク エ ス ト .ul で 切 り 替 わ り ま す )。

.ul N

入 力 行 を N 行 、 ア ン ダ ー ラ イ ン 付 き に し ま す (troff で は イ タ リ ッ ク 体 に な り ま す )。

.unformat diversion

diversion 内 の フ ォ ン ト 情 報 を 保 存 し つ つ 、 空 白 文 字 お よ び タ ブ 文 字 を ア ン フ ォ ー マ ッ ト し ま す 。

.vpt n

n が 0 で な け れ ば 垂 直 位 置 の ト ラ ッ プ を 有 効 に し ま す 。 0 な ら ば 無 効 に し ま す 。

.vs

行 送 り の 基 準 線 間 隔 を 直 前 の 値 に 戻 し ま す 。

.vs N

行 送 り の 基 準 線 間 隔 を N に 設 定 し ま す 。 デ フ ォ ル ト 値 は 12 p で す 。

.warn n

警 告 コ ー ド を n に 設 定 し ま す 。

.wh N trap

位 置 に よ る ト ラ ッ プ を 設 定 し ま す 。 負 の 値 の 場 合 は ペ ー ジ 末 尾 か ら に な り ま す 。

.while cond anything

条 件 式 cond が 真 な ら ば anything を 入 力 と し て 受 理 し ま す 。

.write stream anything

ス ト リ ー ム stream へ anything を 書 き 込 み ま す 。

こ れ ら の 基 本 的 な groff リ ク エ ス ト の 他 に も 、 マ ク ロ の 呼 び 出 し が あ り ま す 。 こ れ ら は マ ク ロ パ ッ ケ ー ジ (概 要 は roff (7) を 参 照 ) や プ リ プ ロ セ ッ サ に 由 来 す る も の で す 。

プ リ プ ロ セ ッ サ マ ク ロ を 認 識 す る の は 容 易 で す 。 こ れ ら は 独 特 の マ ク ロ の 対 で 括 ら れ て い ま す 。

Image grohtml-4190714-5.png

エ ス ケ ー プ シ ー ケ ン ス

エ ス ケ ー プ シ ー ケ ン ス は 、 行 中 の 要 素 で あ り 、 通 常 は バ ッ ク ス ラ ッ シ ュ ‘ \ ’ で 開 始 さ れ 、 エ ス ケ ー プ 名 が そ れ に 続 き ま す 。 場 合 に よ っ て は 、 必 要 な 引 数 を つ け る こ と も あ り ま す 。 入 力 処 理 は 、 エ ス ケ ー プ 文 字 あ る い は そ の 引 数 の 直 後 か ら 再 開 さ れ ま す 。 引 数 に は 区 切 り 文 字 が は さ ま っ て い る わ け で は あ り ま せ ん 。 そ の た め 、 エ ス ケ ー プ 名 や 引 数 の 終 わ り を 決 定 す る 方 法 が 必 要 で す 。

こ れ は 、 名 前 (エ ス ケ ー プ 名 、 お よ び 変 数 名 か ら な る 引 数 ) を 角 括 弧 \[ name ] で 囲 い 、 定 数 引 数 (数 式 お よ び 文 字 ) を ア ポ ス ト ロ フ ィ (ASCII 0x27) で ’constant’ の よ う に 囲 う こ と に よ っ て 実 現 し ま す 。

エ ス ケ ー プ 名 に は 短 い 名 前 の 省 略 形 が あ り ま す 。 2 文 字 の エ ス ケ ー プ 名 は 開 き 括 弧 で \( xy の よ う に 指 定 さ れ 、 閉 じ 括 弧 は 必 要 あ り ま せ ん 。 そ し て 、 特 殊 文 字 で あ る ‘ [ ’ と ‘ ( ’ 以 外 の 1 文 字 の 名 前 は す べ て \ c の よ う に マ ー カ な し で 指 定 す る こ と が で き ま す 。

長 さ 1 の 定 数 の 引 数 も ア ポ ス ト ロ フ ィ の マ ー カ を 省 略 で き ま す が 、 2 文 字 の 名 前 の と き に は 省 略 で き ま せ ん 。

1 文 字 の エ ス ケ ー プ シ ー ケ ン ス は 主 に 行 中 で の 関 数 と シ ス テ ム に 関 連 し た タ ス ク 用 に 使 わ れ る の に 対 し て 、 \( が 続 い た 2 文 字 の 名 前 は roff シ ス テ ム で 定 義 済 み の 特 殊 文 字 用 に 使 わ れ ま す 。 2 文 字 よ り 多 い 文 字 を 持 っ た 名 前 \[ name ] は 、 ほ と ん ど ユ ー ザ 定 義 の 文 字 を 表 し て い ま す ( リ ク エ ス ト .char を 参 照 し て く だ さ い )。

1 文 字 の エ ス ケ ー プ シ ー ケ ン ス

\"

コ メ ン ト の 開 始 で す 。 行 末 ま で の も の す べ て が 無 視 さ れ ま す 。

\#

次 の 改 行 文 字 ま で の も の す べ て が 無 視 さ れ ま す 。 こ れ は 、 コ ピ ー モ ー ド で 解 釈 さ れ ま す 。 \" と 似 て い ま す が 、 終 端 と な る 改 行 を 無 視 す る 点 が 異 な り ま す 。

\* s

1 文 字 の 名 前 s を 持 っ た 文 字 列 変 数 に 格 納 さ れ て い る 文 字 列 で す 。

\*( st

2 文 字 の 名 前 st を 持 っ た 文 字 列 変 数 に 格 納 さ れ て い る 文 字 列 で す 。

\*[ stringvar ]

任 意 の 長 さ の 名 前 stringvar を 持 っ た 文 字 列 変 数 に 格 納 さ れ て い る 文 字 列 で す 。

\$0

現 在 の マ ク ロ が 呼 び 出 さ れ て い る 名 前 。 リ ク エ ス ト .als は 、 1 つ の マ ク ロ に 複 数 の 名 前 を つ け る こ と が で き ま す 。

\$ x

x 番 目 の マ ク ロ の 引 数 。 こ こ で 、 x は 、 1 か ら 9 ま で の 数 値 で す 。

\$( xy

2 桁 の 番 号 xy 番 目 の マ ク ロ の 引 数 。

\$[ nexp ]

nexp 番 目 の マ ク ロ の 引 数 。 こ こ で 、 nexp は 1 以 上 の 整 数 に 評 価 さ れ る 数 値 表 現 で す 。

\$*

マ ク ロ に お い て 、 引 数 す べ て を 空 白 文 字 区 切 り で 連 結 し た も の 。

\$@

マ ク ロ に お い て 、 引 数 す べ て を そ れ ぞ れ ダ ブ ル ク ォ ー ト で 囲 い 、 空 白 文 字 で 区 切 っ て 連 結 し た も の 。

\\

バ ッ ク ス ラ ッ シ ュ 1 個 に 縮 退 し ま す 。 コ ピ ー モ ー ド で エ ス ケ ー プ 文 字 と し て 解 釈 さ れ る の を 遅 ら せ る と き に 便 利 で す 。 表 示 可 能 な バ ッ ク ス ラ ッ シ ュ に は 、 \e を 使 用 し て く だ さ い 。

\’

揚 音 ア ク セ ン ト 符 号 ´ 。 \( aa と 同 じ で す 。 エ ス ケ ー プ な し : ア ポ ス ト ロ フ ィ 、 右 ク ォ ー テ ー シ ョ ン 記 号 、 シ ン グ ル ク ォ ー ト (ASCII 0x27)。

\‘

抑 音 ア ク セ ン ト 符 号 ` 。 \( ga と 同 じ で す 。 エ ス ケ ー プ な し : 左 ク ォ ー ト 、 バ ッ ク ク ォ ー ト (ASCII 0x60)。

\-

現 在 の フ ォ ン ト で の - 符 号 。

\.

解 釈 さ れ な い ド ッ ト (ピ リ オ ド )。 行 頭 に あ っ て も そ う な り ま す 。

\%

デ フ ォ ル ト で の オ プ シ ョ ン の ハ イ フ ン 文 字 。

\!

透 過 行 指 定 子 。

\? anything ?

デ ィ バ ー ジ ョ ン に お い て 、 そ の ま ま anything を 組 み 込 み ま す 。 コ ピ ー モ ー ド で anything は 読 み 込 ま れ ま す 。 エ ス ケ ー プ シ ー ケ ン ス \! お よ び \? も 参 照 し て く だ さ い 。

\ space

パ デ ィ ン グ さ れ な い 、 空 白 の 大 き さ を 持 っ た 空 白 文 字 (改 行 も さ れ ま せ ん )。

\0

数 字 の 幅 の 空 白 。

\|

1/6 em の 狭 い 空 白 文 字 。 nroff で は 幅 0 で す 。

\ˆ

1/12 em の さ ら に 狭 い 空 白 文 字 。 nroff で は 幅 0 で す 。

\&

表 示 さ れ な い 、 幅 0 の 文 字 。

\)

\& と 同 様 で す が 、 文 の 終 わ り を 認 識 す る 目 的 で 、 cflags リ ク エ ス ト を 用 い て 透 過 に な る よ う に 宣 言 さ れ た 文 字 の よ う に 振 る 舞 う と い う 点 で 異 な り ま す 。

\/

次 の 文 字 が ロ ー マ ン 体 で あ る と き に は 、 そ れ の 前 の 文 字 の 幅 を 増 や し て 次 の 文 字 と の 間 の 空 白 が 修 正 さ れ る よ う に し ま す 。

\,

前 の 文 字 が ロ ー マ ン 体 で あ る と き に は 、 次 の 文 字 の 空 白 を 変 更 し て 前 の 文 字 と の 間 の 空 白 が 修 正 さ れ る よ う に し ま す 。

\˜

改 行 さ れ な い 空 白 。 行 を 調 整 す る と き 、 通 常 の 単 語 間 の 空 白 の よ う に 引 き 延 ば さ れ ま す 。

\:

幅 0 の ブ レ ー ク ポ イ ン ト ( \% と 似 て い ま す が 、 ソ フ ト ハ イ フ ン 文 字 は 使 い ま せ ん )。

\ newline

無 視 さ れ る 改 行 。 行 を 連 続 さ せ る と き の た め で す 。

\{

条 件 入 力 の 開 始 。

\}

条 件 入 力 の 終 了 。

\( st

2 文 字 の 名 前 を 持 っ た 特 殊 文 字 。 セ ク シ ョ ン 特 殊 文 字 を 参 照 し て く だ さ い 。

\[ name ]

任 意 の 長 さ の 名 前 name を 持 っ た 文 字

\a

解 釈 さ れ な い リ ー ダ 文 字 。

\A’ anything ’

anything が 文 字 列 、 マ ク ロ 、 デ ィ バ ー ジ ョ ン 、 レ ジ ス タ 、 環 境 、 あ る い は フ ォ ン ト 名 と し て 受 け 付 け ら れ る も の の 場 合 、 1 に 展 開 し ま す 。 そ う で な い 場 合 0 に な り ま す 。

\b’ abc... ’

角 括 弧 を 作 る 関 数 。

\B’ anything ’

anything が 正 し い 数 値 表 現 と し て 受 け 付 け ら れ る も の の 場 合 、 1 に 展 開 し ま す 。 そ う で な い 場 合 、 0 に な り ま す 。

\c

テ キ ス ト 処 理 を 中 断 し ま す 。

\C’ char ’

char と 呼 ば れ る 文 字 。 \[ char ] と 同 じ で す が 、 他 の roff バ ー ジ ョ ン と 互 換 性 が あ り ま す 。

\d

垂 直 単 位 で 1/2 em だ け 前 方 (下 ) に 移 動 し ま す (nroff で は 1/2 行 で す )。

\D’ charseq ’

charseq 中 の 文 字 で 定 義 さ れ た グ ラ フ ィ カ ル な 要 素 を 描 き ま す 。 詳 細 は groff info フ ァ イ ル を 参 照 し て く だ さ い 。

\e

現 在 の エ ス ケ ー プ 文 字 を 表 示 す る 時 の 表 記 。

\E

エ ス ケ ー プ 文 字 と 等 価 で す が 、 コ ピ ー モ ー ド で は 評 価 さ れ ま せ ん 。

\f F

1 文 字 の 名 前 も し く は 1 個 の 数 字 F を 持 つ フ ォ ン ト に 変 更 し ま す 。

\f( fo

2 文 字 の 名 前 も し く は 2 個 の 数 字 fo を 持 つ フ ォ ン ト に 変 更 し ま す 。

\f[ font ]

任 意 の 長 さ の 名 前 も し く は 数 式 font で 表 さ れ る フ ォ ン ト に 変 更 し ま す 。

\g[ reg ]

リ ク エ ス ト .af に 適 し た 、 名 前 reg を 持 っ た レ ジ ス タ の フ ォ ー マ ッ ト を 返 し ま す 。 別 の 形 式 と し て \g( xy お よ び \g x が あ り ま す 。

\h’ N ’

局 所 的 な 水 平 移 動 。 右 側 へ N だ け 移 動 し ま す (負 の 値 の と き は 左 側 へ 移 動 し ま す )。

\H’ N ’

現 在 の フ ォ ン ト の 高 さ を N に 設 定 し ま す 。

\k[ reg ]

任 意 の 長 さ の 名 前 reg を 持 つ レ ジ ス タ 中 の 水 平 入 力 位 置 を マ ー ク し ま す 。 別 の 形 式 で は \k( xy と \k x で す 。

\l’ Nc ’

水 平 線 描 画 関 数 (文 字 c を 用 い る こ と も 可 能 で す )。

\L’ Nc ’

垂 直 線 描 画 関 数 (文 字 c を 用 い る こ と も 可 能 で す )。

\n r

1 文 字 の 名 前 r を 持 つ レ ジ ス タ 変 数 に 格 納 さ れ て い る 数 値 。

\n( re

2 文 字 の 名 前 re を 持 つ レ ジ ス タ 変 数 に 格 納 さ れ て い る 数 値 。

\n[ reg ]

任 意 の 長 さ の 名 前 reg を 持 つ レ ジ ス タ 変 数 に 格 納 さ れ て い る 数 値 。

\N’ n ’

現 在 の フ ォ ン ト で 、 コ ー ド n で 指 定 さ れ た 文 字 を 出 力 し ま す 。 特 別 フ ォ ン ト は 検 索 さ れ ま せ ん 。 リ ク エ ス ト .char を 用 い て 文 字 に フ ォ ン ト を 追 加 す る と き に 便 利 で す 。

\o’ abc... ’

文 字 a , b , c , な ど を 2 度 打 ち し ま す 。

\p

改 行 し 、 そ の 出 力 行 を 引 き 延 ば し ま す 。

\r

垂 直 方 向 に 1 em 逆 戻 り し ま す (nroff で は 1 行 逆 戻 り し ま す )。

\R’ name ±n ’

リ ク エ ス ト .nr name ±n と 同 じ で す 。

\s[ ±N ]

ポ イ ン ト サ イ ズ を N ス ケ ー ル ポ イ ン ト に 設 定 し ま す 。 別 の 書 式 と し て \s ± [ N ] , \s’ ±N ’ , \s ± ’ N ’ , \s( ±xy , \s ± ( xy , \s ±x が 使 え る こ と に 注 意 し て く だ さ い 。 こ れ は 、 リ ク エ ス ト .ps と 同 じ で す 。

\S’ N ’

出 力 を N 度 傾 け ま す 。

\t

解 釈 さ れ な い 水 平 タ ブ 。

\u

垂 直 方 向 に 1/2 em 逆 戻 り し ま す (nroff で は 1/2 行 逆 戻 り し ま す )。

\v’ N ’

局 所 的 な 垂 直 移 動 。 N だ け 下 が り ま す (負 の 値 の と き は 上 が り ま す )。

\V[ env ]

環 境 変 数 env の 内 容 。 別 の 書 式 で は 、 \V( xy と \V x が 使 え ま す 。

\w’ string ’

文 字 列 string の 幅 。

\x’ N ’

さ ら に 行 送 り す る 関 数 (負 の 値 な ら 前 へ 、 正 の 値 な ら 後 ろ へ 行 送 り し ま す )。

\X’ string ’

string を デ バ イ ス 制 御 関 数 と し て 出 力 し ま す 。

\Y[ name ]

文 字 列 変 数 あ る い は マ ク ロ name を デ バ イ ス 制 御 関 数 と し て 解 釈 し な い よ う に 出 力 し ま す 。 別 の 書 式 で は 、 \Y( xy と \Y x に な り ま す 。

\z c

幅 0 (空 白 な し ) で c を 出 力 し ま す 。

\Z’ anything ’

anything を 出 力 し 、 水 平 ・ 垂 直 位 置 を 元 に 戻 し ま す 。 anything に は タ ブ や 先 頭 文 字 は 含 ま れ ま せ ん 。

エ ス ケ ー プ シ ー ケ ン ス \e , \. , \" , \$ , \* , \a , \n , \t , \g , お よ び \ newline は コ ピ ー モ ー ド で 解 釈 さ れ ま す 。

\( あ る い は \[ で 始 ま る エ ス ケ ー プ シ ー ケ ン ス は 1 文 字 の エ ス ケ ー プ シ ー ケ ン ス を 表 す も の で は な く 、 2 つ 以 上 の 文 字 を 持 っ た エ ス ケ ー プ 名 の 開 始 を 示 し ま す 。

バ ッ ク ス ラ ッ シ ュ の 後 に 定 義 済 み の エ ス ケ ー プ シ ー ケ ン ス を 形 成 し な い 文 字 が 続 く 場 合 は 、 バ ッ ク ス ラ ッ シ ュ は 黙 っ て 無 視 さ れ 、 文 字 そ の も の が マ ッ プ さ れ ま す 。

特 殊 文 字

よ く 使 わ れ る 特 殊 文 字 は 、 文 字 x と y を 用 い た \( xy の 形 式 の エ ス ケ ー プ シ ー ケ ン ス で あ ら か じ め 定 義 さ れ て い ま す 。 特 殊 文 字 の 中 に は 通 常 の フ ォ ン ト に 含 ま れ て い る も の も 一 部 あ り ま す が 、 ほ と ん ど は 特 別 フ ォ ン ト で し か 利 用 で き ま せ ん 。 最 も 重 要 な グ リ フ を 抜 き 出 し た も の を 次 に 示 し ま す 。 完 全 な リ ス ト は 、 groff_char (7) に あ り ま す 。

\(bu •

中 黒 .

\(co ©

著 作 権 記 号 .

\(ct ¢

セ ン ト 記 号 (通 貨 ).

\(dd ‡

2 重 ダ ガ ー .

\(de °

度 記 号 .

\(dg †

ダ ガ ー .

\(em —

全 角 ダ ッ シ ュ .

\(hy -

ハ イ フ ン .

\(rg ®

登 録 記 号 .

\(sc §

セ ク シ ョ ン 記 号 .

\(ul _

ア ン ダ ー ラ イ ン 文 字 .

\(== ≡

等 号 .

\(>= ≥

以 上 .

\(<= ≤

以 下 .

\(!= ≠

不 等 号 .

\(-> →

右 矢 印 .

\(<- ←

左 矢 印 .

\(+- ±

プ ラ ス マ イ ナ ス 記 号 .

レ ジ ス タ

レ ジ ス タ は 値 を 格 納 す る 変 数 で す 。 groff で は 、 ほ と ん ど の レ ジ ス タ は 数 値 を 格 納 し ま す が (前 述 セ ク シ ョ ン 数 式 を 参 照 し て く だ さ い )、 な か に は 文 字 列 値 を 保 持 で き る も の も あ り ま す 。

各 レ ジ ス タ に は 名 前 が 与 え ら れ て い ま す 。 任 意 の レ ジ ス タ を 定 義 で き 、 リ ク エ ス ト .nr register で 定 義 ・ 設 定 で き ま す 。

レ ジ ス タ に 格 納 さ れ た 値 は 、 エ ス ケ ー プ シ ー ケ ン ス \n を 用 い て 取 り 出 す こ と が で き ま す 。

最 も 有 用 な の は 、 定 義 済 み の レ ジ ス タ で す 。 次 か ら は 、 レ ジ ス タ の こ と を 話 し て い る の だ と い う こ と を 明 確 に す る た め 、 name と い う 表 記 を 用 い て name レ ジ ス タ の こ と を 示 し ま す 。 \en[] 修 飾 は レ ジ ス タ 名 の 一 部 で は な い こ と を 気 に と め て お い て く だ さ い 。

読 み 込 み 専 用 レ ジ ス タ

次 の レ ジ ス タ は 、 ユ ー ザ が 書 き 換 え ら れ な い 定 義 済 み の 値 を 持 っ た レ ジ ス タ で す (通 常 、 ド ッ ト で 始 ま る レ ジ ス タ は 読 み 込 み 専 用 で す )。 ほ と ん ど は 、 現 在 の 設 定 に つ い て の 情 報 を 提 供 し た り 、 リ ク エ ス ト 呼 び 出 し か ら の 結 果 を 保 存 し た り す る も の で す 。

\n[ .$ ]

現 在 の マ ク ロ の 引 数 の 個 数 。

\n[ .a ]

最 後 に \x ’N’ を 用 い て 指 定 し た 行 送 り 幅 。

\n[ .A ]

オ プ シ ョ ン -A が 使 用 さ れ て い る と き に troff 内 で 1 が 設 定 さ れ ま す 。 nroff 内 で は 常 に 1 で す 。

\n[ .c ]

現 在 の 入 力 行 番 号 。

\n[ .C ]

互 換 モ ー ド が 有 効 に な っ て い る 場 合 は 1 で 、 そ う で な い 場 合 0 で す 。

\n[ .cdp ]

現 在 の 環 境 に 追 加 さ れ た 最 後 の 文 字 の 深 さ 。 最 後 の 文 字 が 基 準 線 か ら 下 に 突 き 出 て い る 場 合 に 正 に な り ま す 。

\n[ .ce ]

リ ク エ ス ト .ce で 設 定 さ れ た 、 セ ン タ リ ン グ さ れ る 行 の 残 数 。

\n[ .cht ]

現 在 の 環 境 に 追 加 さ れ た 最 後 の 文 字 の 高 さ 。 基 準 線 よ り も 上 に 文 字 が 突 き 出 て い る 場 合 に 正 に な り ま す 。

\n[ .csk ]

現 在 の 環 境 に 追 加 さ れ た 最 後 の 文 字 の 傾 き 。 文 字 の 傾 き と は 、 文 字 の 上 に つ い た ア ク セ ン ト 記 号 が 文 字 の 中 央 か ら ど れ だ け 右 に 離 れ て 置 か れ る か と い う こ と で す 。

\n[ .d ]

現 在 の デ ィ バ ー ジ ョ ン で の 垂 直 方 向 の 位 置 で す 。 レ ジ ス タ nl と 同 じ で す 。

\n[ .ev ]

現 在 の 環 境 の 名 前 も し く は 番 号 で す (文 字 列 の 値 で す )。

\n[ .f ]

現 在 の フ ォ ン ト 番 号 で す 。

\n[ .fam ]

現 在 の フ ォ ン ト フ ァ ミ リ で す (文 字 列 の 値 で す )。

\n[ .fp ]

次 に 空 い て い る フ ォ ン ト 位 置 番 号 。

\n[ .g ]

GNU troff で は 常 に 1 で す 。 マ ク ロ 中 で groff で 動 作 し て い る か ど う か を テ ス ト す る 場 合 、 こ の レ ジ ス タ を 使 用 す べ き で し ょ う 。

\n[ .h ]

現 在 の ペ ー ジ あ る い は デ ィ バ ー ジ ョ ン で の テ キ ス ト 基 準 線 の 最 高 点 で す 。

\n[ .H ]

利 用 可 能 な 水 平 方 向 の 解 像 度 (基 本 単 位 で す )。

\n[ .hla ]

リ ク エ ス ト .hla で 設 定 さ れ た 現 在 の ハ イ フ ネ ー シ ョ ン 言 語 。

\n[ .hlc ]

直 前 で 連 続 し た ハ イ フ ネ ー シ ョ ン 行 数 。

\n[ .hlm ]

連 続 し た ハ イ フ ネ ー シ ョ ン 行 数 の 許 さ れ る 最 大 値 。 こ れ は 、 リ ク エ ス ト .hlm で 設 定 さ れ ま す 。

\n[ .hy ]

現 在 の ハ イ フ ネ ー シ ョ ン フ ラ グ ( リ ク エ ス ト .hy で 設 定 さ れ ま す )。

\n[ .hym ]

現 在 の ハ イ フ ネ ー シ ョ ン の 余 白 ( リ ク エ ス ト .hym で 設 定 さ れ ま す )。

\n[ .hys ]

現 在 の ハ イ フ ネ ー シ ョ ン の 空 白 ( リ ク エ ス ト .hys で 設 定 さ れ ま す )。

\n[ .i ]

現 在 の イ ン デ ン ト 。

\n[ .in ]

現 在 の 出 力 行 に 対 し て 適 用 さ れ る イ ン デ ン ト 。

\n[ .int ]

最 後 に 出 力 し た 行 に \c が 含 ま れ て い れ ば 正 で す 。

\n[ .kern ]

ペ ア ワ イ ズ カ ー ニ ン グ が 有 効 に な っ て い る 場 合 1 で 、 無 効 に な っ て い れ ば 0 で す 。

\n[ .l ]

現 在 行 の 長 さ で す 。

\n[ .lg ]

現 在 の 合 字 モ ー ド ( リ ク エ ス ト .lg で 設 定 さ れ ま す )。

\n[ .linetabs ]

現 在 の 行 タ ブ モ ー ド ( .linetabs リ ク エ ス ト に よ っ て 設 定 さ れ ま す )。

\n[ .ll ]

現 在 の 出 力 行 に 対 し て 適 用 さ れ る 行 の 長 さ 。

\n[ .lt ]

タ イ ト ル の 長 さ ( リ ク エ ス ト .lt で 設 定 さ れ ま す )。

\n[ .n ]

直 前 の 出 力 行 で の テ キ ス ト 部 分 の 長 さ 。

\n[ .ne ]

ト ラ ッ プ を 生 起 さ せ る 原 因 と な っ た 最 後 の リ ク エ ス ト .ne が 必 要 と し た 空 白 の 量 。 こ の レ ジ ス タ は 、 .trunc と 一 緒 に 使 用 す る と 便 利 で す 。

\n[ .ns ]

空 白 な し モ ー ド で あ れ ば 1 で 、 そ う で な け れ ば 0 が 設 定 さ れ ま す 。

\n[ .o ]

現 在 の ペ ー ジ の オ フ セ ッ ト 。

\n[ .p ]

現 在 の ペ ー ジ の 長 さ 。

\n[ .pn ]

次 ペ ー ジ の 番 号 。 こ れ は 、 リ ク エ ス ト .pn で 定 義 さ れ た 値 も し く は 現 在 ペ ー ジ に 1 を 足 し た 番 号 の い ず れ か で す 。

\n[ .ps ]

ス ケ ー ル ポ イ ン ト で 表 し た 現 在 の ポ イ ン ト サ イ ズ 。

\n[ .psr ]

最 後 に 要 求 さ れ た 、 ス ケ ー ル ポ イ ン ト で 表 し た ポ イ ン ト サ イ ズ 。

\n[ .rj ]

リ ク エ ス ト rj に よ っ て 設 定 さ れ た 右 寄 せ さ れ る 行 の 数 。

\n[ .s ]

10 進 小 数 で の 現 在 の ポ イ ン ト サ イ ズ 。

\n[ .sr ]

10 進 小 数 で の 最 後 に 要 求 さ れ た ポ イ ン ト サ イ ズ (文 字 列 値 )。

\n[ .t ]

次 の ト ラ ッ プ ま で の 距 離 。

\n[ .T ]

オ プ シ ョ ン -T が 使 わ れ て い る 場 合 1 に 設 定 さ れ ま す 。

\n[ .tabs ]

現 在 の タ ブ 設 定 の 文 字 列 表 現 。 リ ク エ ス ト .ta に 対 す る 引 数 と し て 使 用 す る の に 適 し て い ま す 。

\n[ .trunc ]

最 近 の 垂 直 位 置 ト ラ ッ プ に よ っ て 切 り 詰 め ら れ た 垂 直 ス ペ ー ス の 量 。 リ ク エ ス ト .ne に よ る ト ラ ッ プ が 引 き 起 こ さ れ た 場 合 は 、 そ の リ ク エ ス ト に よ っ て 生 じ た 垂 直 移 動 量 を さ ら に マ イ ナ ス し た 値 に な り ま す 。 別 の 言 い 方 を す れ ば 、 ト ラ ッ プ が 発 生 し た 時 点 で の 、 ト ラ ッ プ が 起 き な か っ た 場 合 の 垂 直 位 置 と 現 在 の 垂 直 位 置 と の 差 を 表 し て い ま す 。 リ ク エ ス ト .ne と 一 緒 に 使 用 す る と 便 利 で す 。

\n[ .ss ]

リ ク エ ス ト .ss の 第 1 引 数 に よ っ て 設 定 さ れ た パ ラ メ ー タ の 値 。

\n[ .sss ]

リ ク エ ス ト .ss の 第 2 引 数 に よ っ て 設 定 さ れ た パ ラ メ ー タ の 値 。

\n[ .u ]

行 連 結 モ ー ド の と き は 1 で 、 そ う で な け れ ば 0 で す 。

\n[ .v ]

現 在 の 垂 直 方 向 の 行 送 り 量 。

\n[ .V ]

利 用 可 能 な 垂 直 方 向 の 解 像 度 (基 本 単 位 で す )。

\n[ .vpt ]

垂 直 位 置 ト ラ ッ プ が 有 効 な ら 1 で 、 無 効 な ら 0 で す 。

\n[ .w ]

直 前 の 文 字 の 幅 。

\n[ .warn ]

現 在 有 効 に な っ て い る 警 告 の 番 号 コ ー ド の 和 。

\n[ .x ]

メ ジ ャ ー バ ー ジ ョ ン 番 号 。

\n[ .y ]

マ イ ナ バ ー ジ ョ ン 番 号 。

\n[ .Y ]

groff の リ ビ ジ ョ ン 番 号 。

\n[ .z ]

現 在 の デ ィ バ ー ジ ョ ン 名 。

書 き 込 み 可 能 な レ ジ ス タ

次 の レ ジ ス タ は 、 ユ ー ザ に よ っ て 読 み 書 き 可 能 で す 。 定 義 済 み の デ フ ォ ル ト 値 を 持 っ て い ま す が 、 ド キ ュ メ ン ト を カ ス タ マ イ ズ す る た め に 変 更 で き ま す 。

\n[ % ]

現 在 の ペ ー ジ 番 号 。

\n[ c. ]

現 在 の 入 力 行 番 号 。

\n[ ct ]

文 字 の 種 類 (幅 関 数 \w で 指 定 さ れ ま す )。

\n[ dl ]

最 後 に 行 わ れ た デ ィ バ ー ジ ョ ン の 最 大 幅 。

\n[ dn ]

最 後 に 行 わ れ た デ ィ バ ー ジ ョ ン の 高 さ 。

\n[ dw ]

現 在 の 曜 日 (1-7)。

\n[ dy ]

現 在 の 日 (1-31)。

\n[ hp ]

現 在 の 入 力 行 に お け る 水 平 位 置 。

\n[ llx ]

与 え ら れ た PostScript 画 像 ( .psbb で 設 定 さ れ ま す ) の 左 下 x 座 標 (PostScript 単 位 )。

\n[ lly ]

与 え ら れ た PostScript 画 像 ( .psbb で 設 定 さ れ ま す ) の 左 下 y 座 標 (PostScript 単 位 )。

\n[ ln ]

出 力 行 番 号 。

\n[ mo ]

現 在 の 月 (1-12)。

\n[ nl ]

最 後 に 表 示 さ れ た テ キ ス ト の 基 準 線 の 垂 直 方 向 の 位 置 。

\n[ rsb ]

sb と 同 様 で す が 、 文 字 の 高 さ お よ び 深 さ を 勘 定 に 含 め て い ま す 。

\n[ rst ]

st と 同 様 で す が 、 文 字 の 高 さ お よ び 深 さ を 勘 定 に 含 め て い ま す 。

\n[ sb ]

文 字 列 の 、 基 準 線 の 下 側 の 深 さ (幅 関 数 \w で 生 成 さ れ ま す )。

\n[ skw ]

\w 引 数 の 最 後 の 文 字 の 中 央 か ら の 右 ス キ ッ プ 幅 。

\n[ slimit ]

0 よ り も 大 き け れ ば 、 入 力 ス タ ッ ク 上 の オ ブ ジ ェ ク ト の 最 大 数 。 0 以 下 で あ れ ば 、 制 限 は あ り ま せ ん 。 つ ま り 、 仮 想 メ モ リ を 使 い 果 た す ま で 再 帰 呼 び 出 し し 続 け る こ と が で き ま す 。

\n[ ssc ]

添 字 の 直 前 に あ る 文 字 に 追 加 す べ き 水 平 方 向 の 空 白 量 (幅 関 数 \w で 生 成 さ れ ま す ) (負 の 値 に な る 可 能 性 も あ り ま す )。

\n[ st ]

文 字 列 の 、 基 準 線 の 上 の 高 さ (幅 関 数 \w で 生 成 さ れ ま す )。

\n[ systat ]

最 後 の .sy リ ク エ ス ト に よ っ て 実 行 さ れ た system() 関 数 の 戻 り 値 。

\n[ urx ]

与 え ら れ た PostScript 画 像 ( .psbb で 設 定 さ れ ま す ) の 右 上 x 座 標 (PostScript 単 位 )。

\n[ ury ]

与 え ら れ た PostScript 画 像 ( .psbb で 設 定 さ れ ま す ) の 右 上 y 座 標 (PostScript 単 位 )。

\n[ year ]

現 在 の 年 (2000 年 問 題 対 応 で す )。

\n[ yr ]

現 在 の 年 か ら 1900 を 引 い た も の で す 。 2000 年 問 題 対 応 に す る に は レ ジ ス タ year を 代 わ り に 使 用 し て く だ さ い 。

警 告

groff が 生 成 す る 警 告 は 各 々 名 前 お よ び コ ー ド 番 号 で 識 別 さ れ ま す 。 コ ー ド は 2 の 累 乗 に な っ て い て 、 1 つ の 整 数 の 上 に ビ ッ ト エ ン コ ー ド で き る よ う に な っ て い ま す 。 ま た 警 告 の グ ル ー プ を 参 照 す る の に 使 用 す る こ と の で き る 名 前 も あ り ま す 。

警 告 と 関 連 の あ る 名 前 は 、 -w お よ び -W オ プ シ ョ ン で 使 用 さ れ ま す 。 コ ー ド 番 号 は リ ク エ ス ト .warn お よ び \n[ warn ] レ ジ ス タ で 使 用 さ れ ま す 。

all

group

di , mac お よ び reg を 除 い た す べ て の 警 告 で す 。 伝 統 的 な マ ク ロ パ ッ ケ ー ジ で の 警 告 を す べ て 網 羅 し て い ま す 。

break

4

行 連 結 モ ー ド 時 に 、 1 行 の 長 さ よ り も 短 く な る よ う に 行 を 分 割 で き ま せ ん で し た 。 デ フ ォ ル ト で は 有 効 で す 。

char

1

存 在 し な い 文 字 で す 。 デ フ ォ ル ト で は 有 効 で す 。

delim

8

閉 じ 区 切 り 記 号 が な い か 、 も し く は 対 応 が 取 れ ま せ ん 。

di

256

現 在 デ ィ バ ー ジ ョ ン が 存 在 し な い の に 、 引 数 な し で .di あ る い は .da を 使 っ て い ま す 。

el

16

対 応 す る リ ク エ ス ト .ie が 存 在 し な い の に 、 .el リ ク エ ス ト を 使 っ て い ま す 。

escape

32768

認 識 さ れ な い エ ス ケ ー プ シ ー ケ ン ス で す 。 そ の た め エ ス ケ ー プ 文 字 は 無 視 さ れ ま す 。

font

131072

存 在 し な い フ ォ ン ト で す 。 デ フ ォ ル ト で は 有 効 で す 。

ig

262144

リ ク エ ス ト .ig を 使 っ て 無 視 さ れ て い る テ キ ス ト 中 で 不 正 な エ ス ケ ー プ が あ り ま す 。 無 視 さ れ る テ キ ス ト の 外 側 で こ の 警 告 が 発 生 す る 場 合 、 エ ラ ー と な る 状 態 で す 。

mac

512

定 義 さ れ て い な い 文 字 列 、 マ ク ロ 、 お よ び デ ィ バ ー ジ ョ ン が 使 わ れ ま し た 。 自 動 的 に 空 文 字 と し て 扱 わ れ ま す 。 通 常 は 、 名 前 ご と に 1 つ し か 警 告 は 出 ま せ ん 。

missing

8192

オ プ シ ョ ン で は な い 引 数 が 指 定 さ れ て い な い リ ク エ ス ト で す 。

input

16384

不 正 な 入 力 文 字 で す 。

number

2

不 正 な 数 式 で す 。 デ フ ォ ル ト で は 有 効 で す 。

range

64

引 数 が 範 囲 外 で す 。

reg

1024

定 義 さ れ て い な い 番 号 レ ジ ス タ を 使 っ て い ま す 。 自 動 的 に 値 0 を も つ レ ジ ス タ と し て 扱 わ れ ま す 。 通 常 は 、 名 前 ご と に 1 つ し か 警 告 は 出 ま せ ん 。

right-brace

4096

数 字 を 指 定 す べ き 場 所 で \} が 使 わ れ ま し た 。

scale

32

意 味 の な い 単 位 指 定 子 で す 。

space

65536

リ ク エ ス ト あ る い は マ ク ロ と そ の 引 数 と の 間 に 空 白 が あ り ま せ ん 。 そ の た め 、 自 動 的 に マ ク ロ は 定 義 さ れ ま せ ん 。 デ フ ォ ル ト で は 有 効 で す 。 こ の 警 告 は 互 換 モ ー ド で は 絶 対 に 発 生 し ま せ ん 。

syntax

128

数 式 中 の 構 文 が 曖 昧 で す 。

tab

2048

タ ブ 文 字 の 使 い 方 が 適 切 で は あ り ま せ ん (ク ォ ー ト さ れ て い な い マ ク ロ 引 数 中 や 数 字 を 指 定 す べ き と こ ろ に タ ブ 文 字 が あ る )。

w

group

す べ て の 警 告 で す 。

Image grohtml-4190714-6.png

互 換 性

groff は 、 古 典 的 な troff 用 に 書 か れ た roff コ ー ド や 他 の roff 実 装 用 の roff コ ー ド を 同 じ 方 法 で 処 理 で き る よ う に す る 互 換 モ ー ド を 提 供 し ま す 。

互 換 モ ー ド は コ マ ン ド ラ イ ン オ プ シ ョ ン -C を 用 い て 有 効 に で き 、 リ ク エ ス ト .cp で 有 効 に し た り 無 効 に し た り で き ま す 。 番 号 レ ジ ス タ \n( .C は 、 互 換 モ ー ド が 有 効 で あ る と き 1 で 、 無 効 で あ る と き 0 で す 。

長 い 名 前 に 対 す る GNU の 考 え 方 に よ っ て あ る 種 の 非 互 換 性 が 生 ま れ て し ま う の で こ れ が 必 要 に な り ま し た 。 古 典 的 な troff は 、

.dsabcd

を cd と い う 中 身 を 持 っ た 文 字 列 ab を 定 義 し て い る も の と し て 解 釈 し ま す 。 groff は 、 通 常 こ れ を dsabcd と い う 名 前 の マ ク ロ 呼 び 出 し と し て 解 釈 し ま す 。

さ ら に 、 古 典 的 な troff で は \*[ ま た は \n[ を [ と 呼 ば れ る 文 字 列 レ ジ ス タ あ る い は 番 号 レ ジ ス タ へ の リ フ ァ レ ン ス と し て 解 釈 し ま す 。 し か し 、 GNU 独 自 の モ ー ド で は 通 常 こ れ を 長 い 名 前 の 始 ま り と し て 解 釈 し て し ま い ま す 。

互 換 性 モ ー ド で は 、 groff は こ れ ら を 古 典 的 な 方 法 で 解 釈 す る よ う に な り ま す が 、 長 い 名 前 は 認 識 さ れ な く な り ま す 。

こ れ に 対 し て 、 GNU 独 自 モ ー ド で の groff は 、 文 字 列 や マ ク ロ 、 変 換 、 番 号 レ ジ ス タ 、 フ ォ ン ト あ る い は 環 境 名 に エ ス ケ ー プ シ ー ケ ン ス \e , \| , \ˆ , \& , \} , \{ , \ (ス ペ ー ス ), \’ , \‘ , \- , \_ , \! , \% , \c を 使 う こ と は で き ま せ ん 。 こ れ に 対 し て 古 典 的 な troff で は こ れ ら の エ ス ケ ー プ シ ー ケ ン ス を 使 え ま す 。 エ ス ケ ー プ シ ー ケ ン ス \A は 、 名 前 の 中 で こ れ ら の エ ス ケ ー プ シ ー ケ ン ス を 使 わ な い よ う に す る と き 役 に 立 ち ま す 。

小 数 の ポ イ ン ト サ イ ズ は 、 顕 著 な 非 互 換 性 を 生 み 出 し ま す 。 古 典 的 な troff で は 、 .ps リ ク エ ス ト は 単 位 指 定 子 を 無 視 し ま す の で 、

.ps 10u

と す る と ポ イ ン ト サ イ ズ を 10 ポ イ ン ト に 設 定 し ま す 。 こ れ に 対 し て groff 独 自 の モ ー ド で は 、 ポ イ ン ト サ イ ズ は ス ケ ー ル ポ イ ン ト で 10 ポ イ ン ト に 設 定 し ま す 。

groff モ ー ド で は 、 整 形 さ れ て い な い 入 力 と 整 形 さ れ た 出 力 文 字 と の 間 に 基 本 的 な 違 い が あ り ま す 。 出 力 文 字 が ど の よ う に 出 力 さ れ る か に 影 響 を 与 え る も の は 、 す べ て そ の 文 字 と 一 緒 に 格 納 さ れ ま す 。 一 度 出 力 文 字 が 作 ら れ れ ば 、 そ の 後 で ど の よ う な リ ク エ ス ト が 実 行 さ れ て も 出 力 文 字 は 影 響 を 受 け ま せ ん 。 .bd , .cs , .tkf , .tr , .fp の い ず れ の リ ク エ ス ト で も 同 様 で す 。

通 常 、 出 力 文 字 は 、 入 力 文 字 を 現 在 の 出 力 行 に 追 加 す る 直 前 に 作 ら れ ま す 。 マ ク ロ 、 デ ィ バ ー ジ ョ ン 、 文 字 列 は 、 実 は す べ て 同 じ オ ブ ジ ェ ク ト タ イ プ で す 。 こ れ ら は 、 ど の よ う な 組 み 合 わ せ で も 入 力 文 字 の リ ス ト な ら び に 出 力 文 字 の リ ス ト を 持 っ て い ま す 。

マ ク ロ を 処 理 す る 目 的 で は 、 出 力 文 字 は 入 力 文 字 と 同 じ よ う な 振 る 舞 い は し ま せ ん 。 出 力 文 字 は 、 自 分 の 構 築 元 と な っ た 入 力 文 字 な ら ば 持 っ て い た で あ ろ う 特 別 な 属 性 を 一 切 引 き 継 ぎ ま せ ん 。 次 の 例 は 、 こ れ ら の こ と を も っ と 明 解 に 示 し て い ま す 。

.di x
\\\\
.br
.di
.x

GNU モ ー ド で は 、 こ れ は \\ と し て 表 示 さ れ ま す 。 つ ま り 、 入 力 さ れ た バ ッ ク ス ラ ッ シ ュ の 対 ‘ \\ ’ は そ れ ぞ れ 1 つ の バ ッ ク ス ラ ッ シ ュ ‘ \ ’ に 変 換 さ れ ま す 。 そ し て 、 結 果 と し て 出 力 さ れ る バ ッ ク ス ラ ッ シ ュ は 、 再 度 読 み 込 ま れ る と き に は エ ス ケ ー プ 文 字 と し て は 解 釈 さ れ ま せ ん 。

古 典 的 な troff で は 、 こ う し た バ ッ ク ス ラ ッ シ ュ は 再 度 読 み 込 ま れ る と き に は エ ス ケ ー プ 文 字 と し て 解 釈 さ れ る の で 、 最 終 的 に は 1 つ の バ ッ ク ス ラ ッ シ ュ ‘ \ ’ と し て 出 力 さ れ る で し ょ う 。

出 力 可 能 な ‘ \ ’ を 得 る 正 し い 方 法 は エ ス ケ ー プ シ ー ケ ン ス \e を 使 う こ と で し ょ う 。 こ れ は 、 デ ィ バ ー ジ ョ ン 内 で 使 用 さ れ て い る か ど う か に 関 わ ら ず 、 現 在 の エ ス ケ ー プ 文 字 を 常 に 1 つ だ け 出 力 し ま す 。 さ ら に こ れ は GNU モ ー ド で も 互 換 モ ー ド で も 動 作 し ま す 。

デ ィ バ ー ジ ョ ン 内 に 、 再 度 読 み 込 ま れ た と き に 解 釈 し た い エ ス ケ ー プ シ ー ケ ン ス を 格 納 す る に は 、 伝 統 的 な 透 過 出 力 フ ァ シ リ テ ィ \! あ る い は 新 し い エ ス ケ ー プ シ ー ケ ン ス \? の ど ち ら か が 使 用 で き ま す 。

バ グ

現 在 、 groff シ ス テ ム の ド キ ュ メ ン ト は 変 更 ・ 刷 新 途 上 に あ り ま す 。 そ れ ぞ れ の マ ニ ュ ア ル に は 小 さ な 不 一 致 が あ る 可 能 性 が あ り ま す 。

警 告 セ ク シ ョ ン は troff (1) に 属 し て い ま す 。

作 者

こ の ド キ ュ メ ン ト は groff、 す な わ ち GNU roff 配 布 物 の 一 部 で す 。 Bernd Warken <bwarken@mayn.de> が 書 き ま し た 。

こ の ド キ ュ メ ン ト は 、 FDL (GNU Free Documentation License) バ ー ジ ョ ン 1.1 以 降 の 条 項 の も と に 配 布 さ れ て い ま す 。 シ ス テ ム に FDL の コ ピ ー が あ る は ず で す し 、 オ ン ラ イ ン

http://www.gnu.org/copyleft/fdl.html

で も 入 手 で き ま す 。

も と も と 、 groff 言 語 拡 張 に つ い て は troff (1) マ ニ ュ ア ル ペ ー ジ で 管 理 さ れ て い ま し た 。 こ の ド キ ュ メ ン ト は groff 言 語 拡 張 の 不 可 欠 な 部 分 を 含 ん で は い ま す が 、 詳 し い 説 明 に つ い て は 、 groff info フ ァ イ ル の 中 に あ り ま す 。

関 連 項 目

groff 言 語 の 主 な 情 報 源 は groff info (1) フ ァ イ ル で す 。

roff お よ び groff シ ス テ ム を 調 べ た り 、 さ ら な る ド キ ュ メ ン ト へ の ポ イ ン タ を 得 る に は 、 roff (7) を 参 照 し て く だ さ い 。

フ ォ ー マ ッ タ プ ロ グ ラ ム に つ い て は groff (1) お よ び troff (1) で 説 明 さ れ て お り 、 前 も っ て 定 義 さ れ て い る グ リ フ 名 の す べ て は groff_char (7) で 説 明 さ れ て い ま す 。

古 く か ら あ る troff の ド キ ュ メ ン ト は オ ン ラ イ ン

http://cm.bell-labs.com/cm/cs/cstr.html

お よ び

http://www.kohala.com/start/troff/

に あ り ま す 。