利用可能な名前は?

Subversion はバージョン管理するデータ型に できる限り制約を置かないように動作します。ファイルの内容と 属性値はバイナリデータとして保存されたり転送され、 項VII.2.3.2. 「svn:mime-type」 は どのファイルが 「テキスト的な」 処理を受け付けないかについての情報を Subversion に与えます。 しかし Subversion が保存情報に対して制約を置かなくてはならない 場合もいくつかあります。

Subversion は内部的には UTF-8 エンコードされた Unicode としてテキストを処理するので、属性値、パス名、ログメッセージ、などの ような本来「テキスト的な」 性質を持ったアイテムは、 正しい UTF-8 文字だけを含むことができます。また svn:mime-type 属性の利用についても最低限度の決まりがあります — ファイルの内容が UTF-8 互換でなければ、バイナリファイルの設定をすべきです。そうしないと Subversion は UTF-8 を使った差分のマージを実行しようとするので、おそらく ファイルにはゴミが残ってしまうでしょう。

さらにパス名は Subversion のいくつかの管理ファイル中だけではなく WebDAV データ交換での XML 属性値としても使われます。これはパス名は 正しい XML (1.0) 文字だけを含まなければならないことを意味します。 Subversion はまた、ファイル名に TAB, CR, LF 文字を使うことも禁止していますが、 これによって diff コマンドや、svn log や svn status などのコマンド出力中で問題が起こらなく なります。

こう聞くと何かたくさんのことを覚えておく必要があるかの ようですが、実際にはこのような制約が問題となることはほとんどありません。 ロケールの設定が UTF-8 と互換になっていて、パス名で制御文字を使わなければ Subversion を利用する上で何の問題も起こらないはずです。 コマンドライン・クライアントの場合にはもう少し便利です—内部的な 利用での「構文的に正しい」バージョンを作るために入力した パス名を、URL 中で必要となる形式に自動的にエスケープしてくれます。

Subversion の利用に経験を積んだユーザは リポジトリ中のディレクトリ配置について、もっとも便利な決まりを見つけて います。そのような規約は、上で説明したような構文的に厳密な要求ではありませんが 通常のよくおこなう処理を楽にしてくれるものです。 この本全体を通じてあらわれる URL の/trunk の部分は そのような規約のひとつです: これについては関連情報とともに 章 IV. ブランチとマージでより詳しく説明します。

.svn ディレクトリって何?

作業コピー中のどのディレクトリにも .svnという名前の管理領域があります。 普通のディレクトリ一覧表示コマンドはこのディレクトリを表示しませんが、 にもかかわらずこれは非常に重要なディレクトリです。 どんなことをするときでも、管理領域を消したり変更したりしないでください! Subversionは作業コピーを管理するのにこのディレクトリを使います。