Manpages

名 称

rcs − RCS フ ァ イ ル の 属 性 を 変 更 す る

書 式

rcs options file ...

解 説

rcs は 、 RCS フ ァ イ ル の 新 規 作 成 お よ び RCS フ ァ イ ル の 属 性 変 更 を 行 い ま す 。 RCS フ ァ イ ル は 、 複 数 の リ ビ ジ ョ ン 、 ア ク セ ス リ ス ト 、 変 更 履 歴 、 内 容 記 述 、 制 御 属 性 か ら な り ま す 。 rcs コ マ ン ド が 実 行 で き る の は 、 実 行 し た ユ ー ザ が RCS フ ァ イ ル の ア ク セ ス リ ス ト に 登 録 さ れ て い る か 、 ア ク セ ス リ ス ト が 空 で あ る か 、 ユ ー ザ が RCS フ ァ イ ル の 所 有 者 で あ る か 、 ス ー パ ユ ー ザ で あ る か 、 あ る い は −i オ プ シ ョ ン が 指 定 さ れ て い る 場 合 に 限 ら れ ま す 。

RCS 拡 張 子 に マ ッ チ す る フ ァ イ ル 名 は RCS フ ァ イ ル で あ る と み な し 、 そ の 他 の フ ァ イ ル 名 は ワ ー ク フ ァ イ ル で あ る と み な し ま す 。 詳 し く は 、 ci(1) を 参 照 し て く だ さ い 。 リ ビ ジ ョ ン 番 号 は ci(1) に 記 述 さ れ て い る 形 式 を 用 い ま す 。

オ プ シ ョ ン

作 成 し ま せ ん 。 指 定 さ れ た フ ァ イ ル 名 に デ ィ レ ク ト リ 名 が 含 ま れ て い な い 場 合 、 rcs は ま ず カ レ ン ト デ ィ レ ク ト リ に あ る ./RCS デ ィ レ ク ト リ に フ ァ イ ル を 作 成 し よ う と 試 み ま す 。 こ れ に 失 敗 し た ら 、 カ レ ン ト デ ィ レ ク ト リ に 作 成 し よ う と 試 み ま す 。 も し す で に RCS フ ァ イ ル が 存 在 し た 場 合 は エ ラ ー と な り ま す 。

−alogins

RCS フ ァ イ ル の ア ク セ ス リ ス ト に logins で 指 定 し た ユ ー ザ 名 を 追 加 し ま す 。 logins は 、 コ ン マ で 区 切 っ た ユ ー ザ 名 の リ ス ト で す 。

−Aoldfile

oldfile で 指 定 し た RCS フ ァ イ ル の ア ク セ ス リ ス ト に 登 録 さ れ て い る ユ ー ザ 名 を 、 対 象 の RCS フ ァ イ ル の ア ク セ ス リ ス ト に 追 加 し ま す 。

−e[logins]

logins で 指 定 し た ユ ー ザ 名 を 、 RCS フ ァ イ ル の ア ク セ ス リ ス ト か ら 消 去 し ま す 。 logins が 省 略 さ れ た 場 合 は 、 ア ク セ ス リ ス ト 全 体 を 消 去 し ま す 。

−b[rev]

rev を デ フ ォ ル ト の 枝 と し ま す 。 rev が 省 略 さ れ た 場 合 、 デ フ ォ ル ト 枝 は 幹 上 で 最 も 大 き な 番 号 を 持 つ 枝 に な り ま す 。

−cstring コ メ ン ト 開 始 文 字 列 を string に 設 定 し ま す 。 最 初 に ci を 起 動 し た 時 、 あ る い は rcs −i に −c オ プ シ ョ ン を 指 定 し な か っ た 時 は 、 コ メ ン ト 開 始 文 字 列 は ワ ー ク フ ァ イ ル の 拡 張 子 か ら 自 動 的 に 推 測 さ れ ま す 。 通 常 、 RCS は チ ェ ッ ク ア ウ ト ( co(1) 参 照 ) 時 の 記 録 行 を 挿 入 す る 際 に 、 $Log$ 行 の 行 頭 部 を 使 用 す る の で 、 こ の オ プ シ ョ ン は 現 在 廃 止 の 方 向 に あ り ま す 。 し か し な が ら 、 RCS の 古 い バ ー ジ ョ ン で は 、 $Log$ 行 の 行 頭 部 で は な く コ メ ン ト 開 始 文 字 列 を 使 用 し て い る の で 、 RCS の 新 旧 両 方 の バ ー ジ ョ ン の フ ァ イ ル を 使 用 す る 場 合 は 、 そ の コ メ ン ト 開 始 文 字 列 が $Log$ 行 の 行 頭 部 と 一 致 す る よ う に し な け れ ば な り ま せ ん 。
−ksubst デ フ ォ ル ト の キ ー ワ ー ド 展 開 方 式 を subst に 設 定 し ま す 。 キ ー ワ ー ド 展 開 の 効 果 に つ い て は co(1) に 記 述 し て あ り ま す 。 co, rcsdiff, rcsmerge に −k オ プ シ ョ ン を 指 定 す る こ と で 、 デ フ ォ ル ト の 展 開 方 式 を 無 効 に す る こ と が で き ま す 。 rcs −kv を 用 い る と き は 注 意 し て く だ さ い 。 な ぜ な ら 、 −kv を デ フ ォ ル ト に す る と co −l あ い い れ な く な る か ら で す 。 rcs −kkv に よ っ て 、 通 常 の デ フ ォ ル ト 値 に 戻 す こ と が で き ま す 。
−l[rev] リ ビ ジ ョ ン rev を ロ ッ ク し ま す 。 rev が 枝 を 示 す 場 合 、 枝 上 の 最 新 の リ ビ ジ ョ ン が ロ ッ ク さ れ ま す 。 rev が 省 略 さ れ た 場 合 、 デ フ ォ ル ト 枝 上 の 最 新 の リ ビ ジ ョ ン が ロ ッ ク さ れ ま す 。 ロ ッ ク す る こ と に よ り 、 そ の リ ビ ジ ョ ン の フ ァ イ ル に 対 し て 複 数 の 人 が 変 更 す る こ と を 防 止 で き ま す 。 別 の 人 が 既 に ロ ッ ク し て い る 場 合 、 rcs −u に よ り 、 ロ ッ ク を 解 除 す る こ と が で き ま す (下 記 参 照 )。
−u[rev] リ ビ ジ ョ ン rev を ロ ッ ク 解 除 し ま す 。 rev が 枝 を 示 す 場 合 、 枝 上 の 最 新 の リ ビ ジ ョ ン が ロ ッ ク 解 除 さ れ ま す 。 rev が 省 略 さ れ た 場 合 、 コ マ ン ド を 実 行 し た ユ ー ザ が ロ ッ ク し た 最 新 の リ ビ ジ ョ ン が ロ ッ ク 解 除 さ れ ま す 。 通 常 、 ロ ッ ク し た ユ ー ザ の み が ロ ッ ク を 解 除 す る こ と が で き ま す 。 他 の ユ ー ザ が ロ ッ ク を 解 除 し よ う と す る と 、 ロ ッ ク し た ユ ー ザ へ メ ー ル が 送 信 さ れ ま す 。 メ ー ル に は ロ ッ ク を 解 除 す る 理 由 等 を 書 い た コ メ ン ト を 付 加 し ま す 。 コ メ ン ト は ロ ッ ク を 解 除 し よ う と し た ユ ー ザ が 入 力 し 、 フ ァ イ ル 終 端 あ る い は . の み を 含 む 行 を 入 力 す る こ と で 終 了 し ま す 。

格 ロ ッ ク を 指 定 す る と 、 RCS フ ァ イ ル の 所 有 者 で あ っ て も 、 ロ ッ ク し て い る フ ァ イ ル を チ ェ ッ ク イ ン す る こ と が で き な く な り ま す 。 複 数 の ユ ー ザ で 共 有 す る よ う な フ ァ イ ル は 本 モ ー ド で 利 用 す べ き で す 。

す 。 非 厳 格 ロ ッ ク を 指 定 す る と 、 RCS フ ァ イ ル の 所 有 者 は ロ ッ ク す る こ と な く 、 新 し い リ ビ ジ ョ ン を チ ェ ッ ク イ ン す る こ と が で き ま す 。 複 数 の ユ ー ザ で 共 有 す る フ ァ イ ル は 本 モ ー ド で 使 用 す べ き で は あ り ま せ ん 。 デ フ ォ ル ト の ロ ッ ク モ ー ド を 厳 格 に す る か 非 厳 格 に す る か は 、 RCS シ ス テ ム を イ ン ス ト ー ル し た シ ス テ ム 管 理 者 が 決 め ま す が 、 通 常 は 厳 格 モ ー ド で す 。

−mrev:msg リ ビ ジ ョ ン rev の ロ グ メ ッ セ ー ジ を msg に 置 換 し ま す 。

rcs −u を 単 に 低 い レ ベ ル の ロ ッ ク 解 除 の 目 的 で 使 用 す る よ う な 場 合 の た め に 用 意 さ れ て い ま す 。
−nname[:[rev]] 枝 ま た は リ ビ ジ ョ ン rev に シ ン ボ リ ッ ク 名 name を 関 連 付 け ま す 。 : も rev も 省 略 し た 場 合 、 シ ン ボ リ ッ ク 名 name は 削 除 さ れ ま す 。 name が す で に 別 の リ ビ ジ ョ ン に 関 連 付 け ら れ て い た 場 合 は エ ラ ー と な り ま す 。 rev が シ ン ボ リ ッ ク 名 の 場 合 も name と の 関 連 付 け は 番 号 に よ っ て 行 わ れ ま す 。 枝 番 号 に . を 付 加 し た も の は 、 そ の 枝 で の 最 新 の リ ビ ジ ョ ン を 示 し ま す 。 : だ け で rev を 省 略 し た 場 合 、 デ フ ォ ル ト 枝 (通 常 は 幹 )の 最 新 の リ ビ ジ ョ ン が 関 連 付 け ら れ ま す 。 た と え ば 、 rcs −nname: RCS/* は す べ て の RCS フ ァ イ ル の 最 新 の リ ビ ジ ョ ン に 対 し て シ ン ボ リ ッ ク 名 name を 関 連 付 け ま す 。 一 方 、 rcs −nname:$ RCS/* は 各 RCS フ ァ イ ル に 対 応 し た ワ ー ク フ ァ イ ル 中 の キ ー ワ ー ド に 含 ま れ る リ ビ ジ ョ ン 番 号 と name を 関 連 付 け ま す 。
−Nname[:[rev]]

-n と 同 様 に 動 作 し ま す 。 た だ し 、 同 じ name が 別 の リ ビ ジ ョ ン に 関 連 付 け ら れ て い て も エ ラ ー と は せ ず 、 関 連 付 け を し な お し ま す 。

−orange

range で 指 定 し た リ ビ ジ ョ ン を 削 除 し ま す 。 range が た だ 1 つ の リ ビ ジ ョ ン 番 号 な ら ば 、 そ の リ ビ ジ ョ ン を 削 除 し ま す 。 range に 枝 番 号 が 含 ま れ れ ば 、 そ の 枝 の 最 新 の リ ビ ジ ョ ン を 削 除 し ま す 。 rev1:rev2 形 式 の 範 囲 指 定 で は 、 同 じ 枝 上 の rev1 か ら rev2 ま で の す べ て の リ ビ ジ ョ ン が 削 除 さ れ ま す 。 :rev は 枝 の 開 始 か ら rev ま で の リ ビ ジ ョ ン を 、 rev: は 同 じ 枝 上 の rev 以 降 の リ ビ ジ ョ ン の す べ て を 削 除 し ま す 。 削 除 さ れ る リ ビ ジ ョ ン に ロ ッ ク や 枝 が あ っ て は い け ま せ ん 。

−sstate[:rev] リ ビ ジ ョ ン rev の 状 態 を state に し ま す 。 rev が 枝 番 号 な ら 、 そ の 枝 の 最 新 の リ ビ ジ ョ ン の 状 態 を 変 更 し ま す 。 rev が 省 略 さ れ た な ら 、 デ フ ォ ル ト 枝 の 最 新 リ ビ ジ ョ ン を 変 更 し ま す 。 state と し て は 自 由 な 識 別 子 を 指 定 で き ま す 。 一 般 に 用 い ら れ る 識 別 子 と し て は 、 Exp (experimental: 実 験 的 )、 Stab (stable: 安 定 し た )、 Rel (released: リ リ ー ス し た )が あ り ま す 。 デ フ ォ ル ト で は 、 ci(1) は 状 態 を Exp に し ま す 。
−t[file]

RCS フ ァ イ ル の 内 容 記 述 テ キ ス ト を フ ァ イ ル file の 内 容 で 置 換 し ま す 。 す で に 存 在 し て い た 内 容 記 述 は 削 除 さ れ ま す 。 フ ァ イ ル 名 は − で 始 ま っ て は い け ま せ ん 。 file が 省 略 さ れ た 場 合 、 テ キ ス ト は 標 準 入 力 か ら 読 み 込 ま れ 、 フ ァ イ ル 終 端 ま た は . の み を 含 む 行 で 終 了 し ま す 。 可 能 な ら ば 、 テ キ ス ト の 入 力 を 促 す プ ロ ン プ ト が 表 示 さ れ ま す ( −I オ プ シ ョ ン の 項 を 参 照 )。 −i オ プ シ ョ ン を 指 定 す る と 、 −t オ プ シ ョ ン が 指 定 さ れ て い な く て も 内 容 記 述 テ キ ス ト の 入 力 を 求 め ま す 。

−t−string

RCS フ ァ イ ル の 内 容 記 述 テ キ ス ト を 文 字 列 string で 置 換 し ま す 。 す で に 存 在 し て い た 内 容 記 述 は 削 除 さ れ ま す 。

す 。 こ の オ プ シ ョ ン を 使 う こ と に よ り 、 RCS フ ァ イ ル の 中 の ワ ー ク フ ァ イ ル の コ ピ ー に よ っ て 生 ず る make(1) の 依 存 関 係 に 伴 う 必 要 以 上 の 再 コ ン パ イ ル を 防 ぐ こ と が で き ま す 。 こ の オ プ シ ョ ン を 使 用 す る 際 に は 注 意 が 必 要 で す 。 本 当 に 再 コ ン パ イ ル が 必 要 な 場 合 に も 再 コ ン パ イ ル さ れ な い 場 合 が 生 じ ま す 。 つ ま り 、 RCS フ ァ イ ル へ の 変 更 が ワ ー ク フ ァ イ ル 中 の キ ー ワ ー ド の 変 更 を 意 味 す る 場 合 が あ る か ら で す 。

−xsuffixes

RCS フ ァ イ ル 拡 張 子 を suffixes に 指 定 し ま す 。 詳 し く は ci(1) を 参 照 し て く だ さ い 。

ン は 何 の 効 果 も あ り ま せ ん 。 他 の RCS コ マ ン ド と の 互 換 性 を 保 つ た め に 存 在 し ま す 。

rcs コ マ ン ド の 将 来 予 定 さ れ て い る 拡 張 と の 互 換 性 を 維 持 す る に は 、 少 な く と も ひ と つ の オ プ シ ョ ン を 明 示 的 に 指 定 す る 必 要 が あ り ま す 。

互 換 性

−brev オ プ シ ョ ン を 指 定 す る と 、 RCS バ ー ジ ョ ン 3 以 前 で は 処 理 で き な い RCS フ ァ イ ル が 生 成 さ れ ま す 。

−ksubst オ プ シ ョ ン ( −kkv を 除 く )を 指 定 す る と 、 RCS バ ー ジ ョ ン 4 以 前 で は 処 理 で き な い RCS フ ァ イ ル が 生 成 さ れ ま す 。 バ ー ジ ョ ン n の RCS で 処 理 で き る RCS フ ァ イ ル を 生 成 す る た め に rcs −Vn を 利 用 す る こ と が で き ま す 。 こ れ に よ り 、 バ ー ジ ョ ン n で 処 理 で き な い 情 報 を 削 除 す る こ と が で き ま す 。 バ ー ジ ョ ン 5.5 以 前 の RCS は −x オ プ シ ョ ン を サ ポ ー ト し ま せ ん 。 RCS フ ァ イ ル の 拡 張 子 と し て は ,v が 用 い ら れ ま す 。

関 連 フ ァ イ ル

rcs は ci(1) と ほ ぼ 同 様 の フ ァ イ ル 群 に ア ク セ ス し ま す 。 た だ し 、 ア ク セ ス は す べ て 実 効 ユ ー ザ ID に よ っ て 行 わ れ ま す 。 ま た 、 ワ ー ク フ ァ イ ル や そ の デ ィ レ ク ト リ に は 書 き 込 み を 行 い ま せ ん 。 リ ビ ジ ョ ン 番 号 と し て $ を 指 定 し た 場 合 を 除 き 、 ワ ー ク フ ァ イ ル を 読 む こ と も あ り ま せ ん 。

環 境 変 数

RCSINIT コ マ ン ド ラ イ ン 引 数 に 先 立 っ て 与 え ら れ る オ プ シ ョ ン を 指 定 し ま す 。 各 オ プ シ ョ ン は 空 白 で 区 切 っ て 指 定 し ま す 。 詳 し く は ci(1) を 参 照 し て く だ さ い 。

診 断

RCS フ ァ イ ル 名 お よ び ひ と つ 古 い (outdated)リ ビ ジ ョ ン 番 号 が 診 断 出 力 と し て 表 示 さ れ ま す 。 す べ て の 処 理 が 成 功 し た 場 合 に 限 り 終 了 ス テ ー タ ス 0 を 返 し ま す 。

作 者

Author: Walter F. Tichy.
Manual Page Revision: 1.5; Release Date: 1999/08/27.
Copyright © 1982, 1988, 1989 by Walter F. Tichy.
Copyright © 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert.

関 連 項 目

rcsintro(1), co(1), ci(1), ident(1), rcsclean(1), rcsdiff(1), rcsmerge(1), rlog(1), rcsfile(5)
Walter F. Tichy, RCS --A System for Version Control, Software--Practice & Experience 15, 7 (July 1985), 637-654.

バ グ

シ ス テ ム ク ラ ッ シ ュ 等 の 大 惨 事 が あ る と 、 RCS は セ マ フ ォ フ ァ イ ル を 残 し て し ま う た め 、 後 に RCS を 実 行 し よ う と す る と 、 RCS フ ァ イ ル が 使 用 中 で あ る と 警 告 し ま す 。 こ れ を 直 す に は セ マ フ ォ フ ァ イ ル を 消 去 す る 必 要 が あ り ま す 。 通 常 、 セ マ フ ォ フ ァ イ ル 名 前 は , で 始 ま る か 、 _ で 終 了 し ま す 。 以 前 の 版 の rcs で は -o オ プ シ ョ ン に お け る リ ビ ジ ョ ン の 区 切 り は : で は な く − で し た 。 し か し 、 こ れ は シ ン ボ リ ッ ク 名 が − を 含 ん で い る と き に 混 乱 を 生 じ ま す 。 従 来 の 版 と の 互 換 性 の た め rcs −o は − を 用 い た 記 法 も サ ポ ー ト し ま す が 、 こ の 記 法 を 用 い た 場 合 は 警 告 メ ッ セ ー ジ を 表 示 し ま す 。 シ ン ボ リ ッ ク 名 が 指 し て い る リ ビ ジ ョ ン が 存 在 す る と は 限 り ま せ ん 。 例 え ば 、 −o オ プ シ ョ ン に よ っ て リ ビ ジ ョ ン が 削 除 さ れ て も そ れ を 指 す シ ン ボ リ ッ ク 名 は 削 除 さ れ ず に 残 っ て い ま す 。 シ ン ボ リ ッ ク 名 を 削 除 す る に は −n オ プ シ ョ ン を 用 い る 必 要 が あ り ま す 。