ARCH チュートリアル (arch Meets hello-world)

目次

1. archの導入

このマニュアルの対象

リビジョン管理とは何か?

どうしてarchを使う必要があるの?

2. 動作に必要なシステム環境

3. arch コマンドの概要

4. 例の要約

5. archに触ってみよう

どのように動作するか — あなたの arch ID

6. 新しいアーカイブの作成

場所の選択

アーカイブ名の決定

アーカイブの作成

これをデフォルトアーカイブとします

どうやって動作するのか — 新しいアーカイブ

7. 新しいプロジェクトの作成

プロジェクトカテゴリの作成

プロジェクトブランチの作成

バージョン番号の選択

なんでこんなことになっているのか

どのように動くか — カテゴリ、ブランチ、バージョンの作成

8. 新しいソースツリーの作成

最初のソース

プロジェクトツリーの初期化

ツリーの初期化は、アーカイブを変更しません

init-tree で失敗したら?

どのように動作するか — 新しいツリーの初期化

9. プロジェクトツリーの目録

名前ベースの目録という概念

inventory コマンド

arch の名前規約

名前規約の様子

名前規約のカスタマイズ

なんでこんなことに — inventory 名前規約について

10. ソースのための目録タグ

全てのファイルについての二つの名前

どうしてそんな仕組みがあるのか — 目録タグの目的

タグに関する選択 — tagging-method の導入

タグづけの方法の設定

名前によるタグづけの利用

明示的なタグづけの方法の利用

暗黙的な目録の利用

物事を単純に保つこと

hello-world プロジェクトのタグづけ

ファイルにタグづけする他の方法

tree-lint を黙らせること

11. 最初のリビジョンのインポート

最初のログファイルの作成

アーカイブ中への最初のリビジョンの保存

インポートからのリビジョン名

どのように働くか — インポートの効果

12. 修正点のチェックイン

warld != world

ログメッセージについてのいくつかのアドバイス

編集/ログ更新のサイクル

ああ、なんてこと — いったい何をしてしまったんだ?

アーカイブへの変更点の保存

どのように動作するか — 新しいリビジョンのコミット

13. 以前のリビジョンの抽出

最後のリビジョンのチェックアウト

もっと以前のリビジョンのチェックアウト

どのように動作するのか — get を使ったリビジョンの抽出

14. 共有アーカイブと、公開アーカイブ

アーカイブのネットワークアクセス登録

一度に複数のアーカイブを使った作業

アーカイブを -A オプションで選択する

完全に修飾されたプロジェクト名

読み込み専用アーカイブ

読み込み専用のアーカイブのミラー

混合アクセスモード

FTP アーカイブの作成

SFTP アーカイブの作成

WebDAV と HTTP アーカイブ

15. update/commit スタイルの共同作業

アリスとボブは main をハックします

ボブが先にコミットします

アリスはまだコミットできません

なぜアリスはコミットすることができないかということについての理解

update コマンド

どのように動作するか — update コマンド

16. チェンジセット入門

mkpatch

dopatch

不完全パッチ処理 — どのようにして衝突が扱われるか

17. チェンジセットの詳細

どのように動くか — commitはアーカイブ中にチェンジセットを保存します

get-patch はアーカイブからチェンジセットを取り出します

チェンジセットを調べるためにはpatch-reportを使います

commit をうまく使うこと — きれいなチェンジセットの概念

18. replay の導入 — update の代わりの方法

update のリフレッシュ機能

リプレイコマンド

どのように動作するか — replay ––in-place

19. 選択したファイルのコミット

すぐに修正することについての問題

ちょっとした問題の修正に対する乱暴な解決方法

commit ––filesを使った、ちょっとした修正問題の解法

20. ブランチの初歩 — プライベートな変更の保守

ブランチのシナリオ — プライベートな変更の必要

ローカルアーカイブにリモートプロジェクトのブランチを作ること

タグの役割

タグリビジョンのキャッシング

新しいブランチの調査

ローカルな変更を加えること

ブランチからのバージョンを更新すること

どのように動作するのか — タグと基本的なブランチについて

21. いくつかの利用に関するアドバイス — プライベートなミラーを作ること

リモートアーカイブのもついくつかの問題

ローカルコピーの保持

22. パッチログとプロジェクトツリー履歴

プロジェクトツリーはパッチログを持っています

どのように動作するか — whats-missing

変更履歴とツリーAncestryの概念

変更履歴

ツリー Ancestry

自動化されたチェンジログ

23. より進んだブランチ — 星型マージスタイルの共同作業

基本的なブランチから、より複雑なブランチへ

簡単な開発ブランチ

開発ブランチのマージ問題

replay は、開発ブランチマージ問題を解決しません

update は開発ブランチマージ問題を解決しません

開発ブランチマージ問題を解くための一つの方法

星型マージ — 一般的な開発ブランチマージ問題の解決

24. シンボリックタグ

25. つまみ食い的修正

26. 複数のツリーのあるプロジェクトと設定管理

27. アーカイブのキャッシュしたリビジョンによる arch の効率化

28. リビジョンツリーライブラリを使った arch の高速化

リビジョンライブラリの場所

リビジョンライブラリの形式

ライブラリへのリビジョンの追加

ライブラリ中のリビジョンの検索

ライブラリからのリビジョンの削除

ライブラリの内容の一覧表示

リビジョンライブラリ中の個々のファイル

あらかじめ必要なパッチセットの決定

29. arch の通知機能を使った処理の自動化

四つの通知設定ファイル

リポジトリ中のすべてに対する通知

通知メール

通知に関する堅牢さの問題

cron によるスケジュール通知

archコマンドからの通知のスケジュール

A. arch のチェンジセット形式

B. 目録の名前規約のカスタマイズ

名前規約をカスタマイズするとき

名前規約のカスタマイズの方法

C. The GNU Free Documentation License

D. The GNU General Public License

E. ここでちょっと・・・助けてもらえないでしょうか?"

30. Indexes :unnumbered :index (general) :index-for "arch"