多分、どのSubversionコマンドよりもsvn status コマンドはよく利用されるはずです。

自分の作業コピー最上位階層で引数なしにsvn status を実行すると、自分がツリーにしたすべての修正が検出できます。 以下の例はsvn status が返すことのできる 異なる状態コードです。 (以下で、# の後に書いてあるテキストは svn statusからのものではないのに注意してください。)

  L     some_dir            # svn left a lock in the .svn area of some_dir
M       bar.c               # the content in bar.c has local modifications
 M      baz.c               # baz.c has property but no content modifications
X       3rd_party           # dir is part of an externals definition
?       foo.o               # svn doesn't manage foo.o
!       some_dir            # svn manages this, but it's missing or incomplete
‾       qux                 # versioned as file/dir/link, but type has changed
I       .screenrc           # svn doesn't manage this, and is set to ignore it
A  +    moved_dir           # added with history of where it came from
M  +    moved_dir/README    # added with history and has local modifications
D       stuff/fish.c        # file is scheduled for deletion
A       stuff/loot/bloo.h   # file is scheduled for addition
C       stuff/loot/lump.c   # file has textual conflicts from an update
 C      stuff/loot/glub.c   # file has property conflicts from an update
R       xyz.c               # file is scheduled for replacement
    S   stuff/squawk        # file or dir has been switched to a branch
     K  dog.jpg             # file is locked locally; lock-token present 
     O  cat.jpg             # file is locked in the repository by other user
     B  bird.jpg            # file is locked locally, but lock has been broken
     T  fish.jpg            # file is locked locally, but lock has been stolen

この出力形式の中で、svn statusは 五つの文字を表示していて、その後にいくつかの空白が続き、 ファイルまたはディレクトリ名称がそのあとに続いています。 最初のコラム (左から一文字目の部分) は、ファイルまたはディレクトリの 状態をあらわしています。ここで表示されているコードは:

二番目のコラムはファイルまたはディレクトリの属性を示しています (詳しくは属性項 参照してください)。 もしM が表示されていれば 属性は修正されたことを示しています。そうでなければ空白が 表示されます。

三番目のコラムは空白か、L が 表示され、後者の場合は Subversionがそのディレクトリの .svn 作業領域をロックしていることを意味して います。svn commit が実行されている途中で svn status を実行すると L が表示されます— 多分ログメッセージを変更している最中かも知れません。 Subversionが実行されていないのなら、Subversionは多分中断され たため、ロックは、svn cleanupの実行によって 解除しなくてはなりません。(これについてはこの章の後で触れます)

四番目のコラムは空白か+ が 表示され、あとの場合はファイルまたはディレクトリは 追加または修正され、それが履歴に追加予告されていることを意味します。 これはファイルやディレクトリに対してsvn move か svn copy をしたときによく起こります。 A  +の表示がある場合 そのアイテムは履歴付きの追加予告されていることを意味します。 それはファイルか、コピーされたディレクトリのルートであるかです。 +はそのアイテムが、履歴に追加 予告されたサブツリーの一部であることを意味します。つまり、 そのアイテムのどれかの親がコピーされ、コミットを待っています。 M  + はアイテムが履歴 に追加予告されたサブツリーの一部であり、 かつ ローカルの修正も受けているという場合です。 コミットするとき、最初に親が履歴付き追加されます(コピーされます) その意味はこのファイルはコピーによって自動的に存在するということ です。次いでローカルの修正はコピーにアップロードされます。

五番目のコラムは空白か、Sに なります。これはファイルかディレクトリは作業コピーの残り パスから、ブランチに(svn switchコマンドで) 切り替わっていることを意味します。

六番目のコラムはロックに関する情報を示しています。 詳細は ロック項で説明します。

svn statusにパスを指定すると、そのアイテムに 関する情報のみを表示します:

$ svn status stuff/fish.c
D      stuff/fish.c

svn status も --verbose (-v) スイッチを とりますが、その場合作業コピー中のすべてのアイテム に対して、たとえ変更がなくてもステータスを表示するという意味になります:

$ svn status --verbose
M               44        23    sally     README
                44        30    sally     INSTALL
M               44        20    harry     bar.c
                44        18    ira       stuff
                44        35    harry     stuff/trout.c
D               44        19    ira       stuff/fish.c
                44        21    sally     stuff/things
A                0         ?     ?        stuff/things/bloo.h
                44        36    harry     stuff/things/gloo.c

これは svn statusの「長い表示形式」 の出力です。再処理コラムは同じですが、二番目はアイテムの作業リビジョン になります。三番目と四番目はそれぞれアイテムが最後に変更されたリビジョン と、誰がそれをしたかの表示です。

いままで出てきたsvn status の実行は いずれもリポジトリと通信をしません。それは単に作業コピー中の .svn ディレクトリのメタデータを比較する ことによって、ローカルマシン上だけで動作します。 最後に、--show-updates(-u) スイッチがありますが、これはリポジトリと通信して、古くなった ファイルなどの情報を追加表示します:

$ svn status --show-updates --verbose
M      *        44        23    sally     README
M               44        20    harry     bar.c
       *        44        35    harry     stuff/trout.c
D               44        19    ira       stuff/fish.c
A                0         ?     ?        stuff/things/bloo.h
Status against revision:   46

二つのアスタリスク ('*') に注意してください:この状態で svn update を実行すると READMEとtrout.c の変更点を受け取ることになります。 これは非常に役に立つ情報です—コミットする前には更新して README に関するサーバ上の変更点を取得 しなくてはなりません。さもなければ、最新でないという理由で コミットは失敗するでしょう(詳しくは後で述べます)。

自分の変更点を調べる別の方法は、svn diff コマンドを使うことです。svn diff を引数 なしに実行することで、自分がどんな変更をしたかを 正確に 知ることができます。このときの 出力形式はunified diff 形式です: ^[4]

$ svn diff
Index: bar.c
===================================================================
--- bar.c       (revision 3)
+++ bar.c	(working copy)
@@ -1,7 +1,12 @@
+#include <sys/types.h>
+#include <sys/stat.h>
+#include <unistd.h>
+
+#include <stdio.h>

 int main(void) {
-  printf("Sixty-four slices of American Cheese...¥n");
+  printf("Sixty-five slices of American Cheese...¥n");
 return 0;
 }

Index: README
===================================================================
--- README      (revision 3)
+++ README	(working copy)
@@ -193,3 +193,4 @@ 
+Note to self:  pick up laundry.

Index: stuff/fish.c
===================================================================
--- stuff/fish.c     (revision 1)
+++ stuff/fish.c     (working copy)
-Welcome to the file known as 'fish'.
-Information on fish will be here soon.

Index: stuff/things/bloo.h
===================================================================
--- stuff/things/bloo.h      (revision 8)
+++ stuff/things/bloo.h      (working copy)
+Here is a new file to describe
+things about bloo.

svn diff コマンドは.svn 領域 にある、「修正元リビジョン」 のコピーに対して作業コピー 中のファイルを比較した結果を出力します。 追加予告ファイルはすべて追加されたテキストとして表示され 削除予告されているファイルはすべて削除されたファイルとして表示 されます。

出力は、unified diff 形式で表示されます。 つまり、削除された行は先頭に - が付き、追加された 行は先頭に +がつきます。svn diff はさらにpatch に便利なようにファイル名称とオフセット 情報を表示します。このためdiffの出力をファイルにリダイレクトすることで 「パッチ」 を生成することができます:

$ svn diff > patchfile

たとえば、パッチファイルを別の開発者に送り、コミット前に再検討や テストをすることができます。

上のdiff出力を見て、README に対する修正が間違っていることがわかったとしましょう: 多分 エディタで間違ったファイルに保存してしまったりしたのでしょう。

これは、svn revertを使うことの できるとても良い機会です。

$ svn revert README
Reverted 'README'

Subversion はそのファイルを.svn 領域に ある「修正元リビジョン」のコピーを上書きすることに よって、修正以前の状態に戻します。 しかし、svn revert はどのような 予告操作も取り消すことができるのに注意してください—たとえば 最終的に新しいファイルを追加することをやめることができます:

$ svn status foo
?      foo

$ svn add foo
A         foo

$ svn revert foo
Reverted 'foo'

$ svn status foo
?      foo

あるいは間違ってバージョン管理からファイルを消して しまったのかも知れません:

$ svn status README 
       README

$ svn delete README 
D         README

$ svn revert README
Reverted 'README'

$ svn status README
       README

手で衝突をマージするのは最初とても嫌なものですが、 少し練習すればバイクから降りるのと同じくらい簡単に できるようになります。

例をあげます。コミュニケーション不足により、あなたとあなたの同僚 である Sally の両方がsandwich.txtというファイルを同時に 編集したとします。Sallyは自分の変更をコミットし、それからあなた が作業コピーを更新しようとすると、衝突を受け取ります。それで sandwich.txt を編集しなくてはなりません。 最初にファイルを見てみます:

$ cat sandwich.txt
Top piece of bread
Mayonnaise
Lettuce
Tomato
Provolone
<<<<<<< .mine
Salami
Mortadella
Prosciutto
=======
Sauerkraut
Grilled Chicken
>>>>>>> .r2
Creole Mustard
Bottom piece of bread

小なり記号の文字列、イコールサイン、そして 大なり記号の文字列を衝突マーカと呼びますが、これは実際の 衝突を起こしたデータの一部ではありません。一般的には次のコミットの 前に取り除く必要があります。最初の二つのマーカの間のテキストは衝突領域に あなた自身がした変更です:

<<<<<<< .mine
Salami
Mortadella
Prosciutto
=======

二番目と三番目の衝突マーカの間のテキストは、 Sallyのコミットからのテキストです:

=======
Sauerkraut
Grilled Chicken
>>>>>>> .r2

通常、衝突マーカとSally の変更部分を単に削除するわけには いきません—そのようなことをするとSallyはsandwichを 受け取ったときにびっくりしますし、それは彼女が望んでいる ものではないでしょう。あなたは電話をかけるか、オフィスを またいで、Sallyに、二人の変更が衝突していることを説明 します。 ^[6] ひとたびコミットする変更内容について合意がとれたら、 ファイルを編集し衝突マーカを削除します。

Top piece of bread
Mayonnaise
Lettuce
Tomato
Provolone
Salami
Mortadella
Prosciutto
Creole Mustard
Bottom piece of bread

これで、svn resolved を実行し 自分の変更をコミットする用意ができました:

$ svn resolved sandwich.txt
$ svn commit -m "Go ahead and use my sandwich, discarding Sally's edits."

衝突ファイルを編集中に混乱したら、Subversionがあなたのために作った、 作業コピーにある三つの一時ファイルを見てどうするかを考えることができます —その中には更新前にあなたが修正したバージョンのファイルもありま す。この三つのファイルを確認するためにサードパーティー製の対話的な マージツールを使うこともできます。

衝突が起こり、自分のした変更を捨てようとするときにはSubversionが作った 一時ファイルのどれかを単に作業コピー上に上書きすることができます:

$ svn update
C  sandwich.txt
Updated to revision 2.
$ ls sandwich.*
sandwich.txt  sandwich.txt.mine  sandwich.txt.r2  sandwich.txt.r1
$ cp sandwich.txt.r2 sandwich.txt
$ svn resolved sandwich.txt

衝突が起こり、調査の結果、自分の変更を捨てて編集をやり直す場合は 単に変更を revert することができます:

$ svn revert sandwich.txt
Reverted 'sandwich.txt'
$ ls sandwich.*
sandwich.txt

衝突ファイルを元に戻すときはsvn resolvedを 実行する必要はないことに注意してください。