# CVSの使い方

CVS は共同プロジェクトによるドキュメントやプログラム・コード等の管理を行う便利なツールです。ゲーム班にまつわる全ては CVS によって管理されますので、CVSで始まりCVSで終わるといっても過言ではないでしょう。

ここでは CVSの使い方を例を挙げて説明します。ただ、CVSをコマンドから直接打ち込むと面倒なので、cvs-cr というスクリプトを作って、それを使います。練習用のプロジェクトに Game_project/Test/ 以下を用意しましたのでそちらを御利用下さい。実際のゲーム作りではGame_project/ 以下にプロジェクトを作ります。特に PS2 Linux向けのプロジェクトならば Game_project/ps2 を、GBA向けのプロジェクトならば Game_project/gba をお使い下さい。

ここでは Game_project/Test/ 以下に test_program という仮想のプロジェクトを作り、cvs-cr の使い方の例を挙げて説明することにしていきましょう。

# つーかCVSって何だば?

簡単に言えばプロジェクト運営用のツールで、データベースのような機能を提供します。

例えば、プロジェクトとして複数人で一つのプログラムのコーディング作業を行ったらどうなると思いますか? もちろん誰が何を変更したか分かりませんので、コーディングにバグが含まれていたら目も当てられませんね。バグを忍ばせた人が誰なのかは全くわかりません。よってチームの人間関係にヒビが入ります。

編集する前には cpコマンドとかでバックアップをとるのが妥当ですが、 cpでバックアップを毎回とるのですか? そいつはちと面倒です。それ以前にバックアップ自体にバグが含まれていたらチームの人間関係に莫大なダメージを与えます。

それと、よくある失敗で、

% rm -rf * (メガンテ!!)

という自爆技があり、これによりチーム全員が自爆します。ホームディレクトリでやるとその効果は絶大です。

ということを防ぐためにCVSを使いましょう。習得は楽なので恐れないで下さい。

# cvs-crの作りかた

奴はシェルスクリプトで、中身はこんな感じです。 locateかfindで探せば見付かるはずですが、まぁ取り敢えずここではcvs-crの作り方を説明します。

cvs -d game@firefly.cr.ie.u-ryukyu.ac.jp:/home/one/CVS_DB $*

こんだけです。これを毎回打ち込むのはさすがに面倒なのでシェルスクリプトにするのです。ここでは説明しませんが多分 alias でもいけますよ。

とりあえずcvs-crの作り方を説明します。取り敢えずエディタでcvs-crを書きましょう。

% vi cvs-cr
もしくは
% emacs cvs-cr

これで上記の一行を書いて終了なのです。それから忘れずに実行権を与えましょう

% chmod +x cvs-cr   (ユーザの実行許可)

でもって ~/bin ディレクトリ作って cvs-cr を放りこんで下さい。

% mkdir ~/bin
% mv cvs-cr ~/bin

次に ~/bin に実行のパスを通してあげます。パスは tcsh なら ~/.tcshrc、 bash なら ~/.bashrc に書かれてますので、こやつに ~/bin の実行パスを追加します。ここではtcshについて説明しますので適当にいじって下さい。

% emacs ~/.tcshrc  (tcshの場合)

でもって、こんな感じの行を探してみましょう。

set path = (/bin /usr/sbin /sbin ...省略(他のbinへのパス)...)

こやつに追加します

set path = (/bin /usr/sbin /sbin ...省略(他のbinへのパス)... ~/bin)

編集が終わったら忘れがちなのがコレ!

% source ~/.tcshrc
% rehash

はい終了。簡単でした。でも実はこれだけじゃまだ設定不足で、環境変数の設定が必要です。以下のcvsで用いる環境変数を読み下さい。

# cvsで用いる環境変数

PS2Linux では cvs で用いる環境変数を /etc/bashrc , /etc/csh.cshrc で設定しています。

もし, 出来んやっし! とか PS2 Linux以外の PC から CVS 使う場合は, ~/.bashrc か ~/.tcshrc あたりを以下のように設定しましょう。

こっちは bash の場合

export CVS_RSH=ssh
export CVSEDITOR=/usr/bin/emacs

んで、こっちが tcshの設定です。

# CVS で用いるログインシェル. 本学科はsshを使うことになってます
setenv CVS_RSH ssh      

# CVS で用いる エディタ. vi でなく emacs とか書くと ログの書き
# 込み時に勝手に emacs が起動します。日本語化け対策はeucで保存す
# ればOK !
setenv CVSEDITOR vi

# 新規プロジェクトを開始する

まず、cvsリポジトリの Game_project/Test/ 以下に test_program という新しいプロジェクトを作ります。新規プロジェクトを開始する場合は import を使います。そのあとにオプションとしてプロジェクト名、ユーザ名、リリースタグを指定します。インポートするとエディタが起動し、コメントを付けることができます。以下を実行すると、カレントディレクトリ以下の(. .. 以外の) ファイル・ディレクトリが Game_project/Test/test_program にリポジトリとしてに追加されます。

$ cvs-cr import Game_project/Test/test_program game start

# プロジェクトをチェックアウトする

cvsリポジトリよりプロジェクトを入手(チェックアウト)します。 checkout を使います。以下を実行すると、カレントディレクトリに Game_project/Test/test_program ができます。また、ここで Game_project/Test/ を指定すると、test_program だけではなく、 Game_project/Test/ 以下の全てのプロジェクトをチェックアウトできます。

$ cvs-cr checkout Game_project/Test/test_program

または $ cvs-cr co Game_project/Test/test_program

おまけとして、checkoutした時に上記の場合、Game_project/Test/test_program というdirectoryが作成されますが、実際作業するのにわざわざtest_programまで移動しなければならないので、これがめんどいって人は、-dオプションを使用しましょう。

$ cvs-cr co -d directory-name Game_project/Test/test_program

directory-nameの部分に任意の名前をつける。すると、test_program以下が directory-nameの中にできます。まぁ必要ない人は使わなくてもいいけど、リポジトリ階層がかなり深くなるとちょっと移動がめんどくなるので、便利かと思います。

# プロジェクトをコミットする

チェックアウトしたファイルなどに変更を加え、その変更をリポジトリにも反映させたい場合は commit を使います。ただし、新しくファイルやディレクトリを追加した場合は add を用いてからコミットしてください。コミットしたときに指定したエディタが起動して、コメントを付けることができるので、変更箇所などの情報を書くといいでしょう。作業用ディレクトリ(チェックアウトした test_program) で以下を実行すると、変更を加えたファイルだけをリポジトリに反映します。特定のファイルだけをコミットしたい場合はオプションとしてファイル名 (file_name)を指定してください。

$ cvs commit [file_name]

# リポジトリの変更を自分の作業用ディレクトリに反映させる

自分がチェックアウトした後に他の人がリポジトリに変更をコミットした場合、その変更を自分の作業用ディレクトリに反映させることができます。その場合は update を使います。

$ cvs update

# プロジェクトに新たにファイル・ディレクトリを追加する

プロジェクトに新たにファイルやディレクトリを追加する場合は作業用ディレクトリで add を用いてからコミットします。add だけではリポジトリにファイルができないので、コミットすることを忘れないで下さい。以下のコマンドは、test_program 以下に新たに add_dir というディレクトリと add_file_1.c というファイル、add_dir の下の add_file_2.c というファイルを追加します。

$ cvs-cr add add_dir add_file_1.c
$ cvs-cr add add_dir/add_file_2.c
$ cvs-cr commit

# プロジェクトにタグ(マーク)をつける

プロジェクトをcheckoutする場合、開発における一定のポイントを取り出したいということが多々あります。そのとき、日付による取得とタグによる取得があります。ここでは、タグによる取得を紹介します。 ~~ 「あ、あのときのリリースバージョンとりたい!」ということが起きたとしましょう。そのとき、日付やタグによる取得をしらないと「えーっと、file_1.cはversion1.1で、file_2.cはversion1.2でfile_3,cはーえっと..???」なんてことになってしまいます。 ~ ~ なぜそんなことがおきるのか?そう、CVSのバージョン管理はファイル別で行われているので(リポジトリ別ではない)、ファイルによって最新バージョンがバラバラになっていることがあります(例えば、file_1.cはversion1.1、file_2.cはversion1.2の様に)。 ~ その問題を解決してくれるのが、タグ機能です。ある特定のポイントでタグをつけることにより、後でタグに指されたそれぞれバージョンのファイルをcheckoutすることができます。 ~ ~ さあ、使ってみましょう。現在、Game_project/Test/test_programをcheckoutして、そのディレクトリにいるとします。

以下はタグを付けるコマンドです。tagの後ろにタグ名を付けて下さい。

1

cvs tag [tag_name]

以下はタグの付いたポイントをcheckoutするコマンドです。

1

cvs-cr checkout -r [tag_name] Game_project/Test/test_program

# プロジェクトを最新の状態にする

タグなどによって古いバージョンに戻したあと、再びプロジェクトを最新の状態にしたいとき。

1

cvs up -A

オプション"A"を忘れずに付けましょう。

# で、CVSって何よ?

そんなあたなにプレゼント

CVSの使い方

CVSについてさらに知りたければ、研究室にCVS関連の本がありますのでどうぞ。もしくは Let’s google!!