ソフトウェア設計及び演習2017

svn::簡単な使い方

archive mode

!!! svn超簡易マニュアル

!! 基本的な概念，言葉の意味

* [[サブバージョンの使い方]]を参照のこと．
* リポジトリ，ワーキングコピー，リビジョン，チェックアウト，コミット，などの単語の意味を理解すること．
** 普段の作業は，リポジトリからチェックアウトしたワーキングコピーの方を使う．'''リポジトリそのものには手を触れない'''．
** ある程度の完成度まで到達したら，ワーキングコピー（中の修正したファイル群）の内容をリポジトリに反映させる．これがコミット．
** コミット時には，どのファイルを，どのように修正したか，といった内容をログに残しておく．
** 別の人間が，同じファイルを別々に修正して，それぞれでコミットしようとすると衝突（コンフリクト）する
*** コンフリクトは，手動で対処する以外に方法はない．

!! ワーキングコピーの取得

コピーしたいディレクトリに移動して'''checkout'''．
仮に，~/csd 以下に， proj という名前のワーキングコピーを展開するとすると，

8<
% cd ~/csd
% svn co https://svn.cis.iwate-u.ac.jp/svn/csd/proj
>8

!! ワーキングコピーの更新

複数の人間で開発を行なう場合，'''編集作業を行う前に必ず'''
ワーキングコピーに（リポジトリの）最新情報を反映させる必要がある．

8<
% cd ~/csd/proj
% svn update
>8

!! ワーキングコピーの状態確認

ワーキングコピーの状態を確かめるには，
（ワーキングコピーが存在するディレクトリ以下で）

8<
% svn status
>8

とする．先頭のマークで状態が分かる．

6<
:?
::どんな状態か分からない．（例えば，ワーキングコピーディレクトリ下に新たにファイルを作成したが，svn addしていない場合，とか）

:A
::追加

:D
::削除

:C
::衝突

:M
::変更

:!
::バージョン管理下で，ファイル，ディレクトリが不完全，または失われている．svn のコマンド以外でファイルを消去したりするとよく起こる．svn revertなどを使って回復できるが，revertコマンドは「変更を破棄してしまう」という意味で本質的に危険なので，多用しないこと．（!フラグが出ないように気をつけてファイル管理すること）
>9

!! ワーキングコピーに対する修正変更を，リポジトリに登録

自分が加えた修正をリポジトリに反映させるには，次のように'''svn commit'''を実行する.

8<
（proj内のxxx.cを修正して登録する場合の例）
% cd ~/csd/proj
% emacs xxx.c
% svn commit -m 'コミットメッセージ' 
>8

「コミットメッセージ」には，何を変更したかを書いておく（'''他の共同開発者にわかるように'''）
* commitする際には必ずメッセージが必要だ，と覚えておこう．

!! ファイルやディレクトリを新規に追加する

ディレクトリ（dir1）を新たに追加したい場合は，

8<
% svn mkdir dir1
>8

のように，'''svn mkdir'''とすること．また，ファイル（a.txt）を新たに追加したいときは，
リポジトリに反映させるために

8<
% svn add a.txt
>8

のように'''svn add'''とすること．ただし，'''これらが真にリポジトリに登録追加されるのはcommitした時点'''なので注意．
（commitするまではリポジトリは以前の状態のまま）

!! ファイルやディレクトリを削除する

8<
% svn remove a.txt
>8

これも，実際に削除が反映されるのはcommit時なので注意．

!! ファイルやディレクトリの名前を変更する

8<
% svn move a.txt b.txt
>8

これもcommitすると反映される．

!! 変更内容のチェック

自分が変更したファイルと，リポジトリに登録されている最新版とを比較するには，

8<
% svn diff a.txt
>8

とする．
!! 作業ログの閲覧

開発履歴は log オプションで確認できる．（ここで表示されるメッセージは，commit時に -m オプションで書きこまれたもの）

8<
% svn log a.txt
>8

Tag:

Attachment

New: append-tag

(download: 2845 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 2952 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 2741 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 2874 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3275 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3226 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3323 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3371 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3371 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3344 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3356 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3396 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3586 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3607 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3644 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3674 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3759 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 3747 bytes, at 2017/04/03 09:14:14 <frozen> )
(download: 4379 bytes, at 2017/04/03 09:14:14 <frozen> )

Syntax Help

URL Link

[text|http://example.com//] http://example.com/to{text}

Page Link

[[PageName]] [[text|PageName]] >>{PageName} >>{PageName}{text}

Image or Attachment

<<{filename} <<{filename}{text}

Text Decoration

'' Italic '' ''' Bold ''' '''' Large-font '''' `` Typewriter `` `?` Preformatted `?` __ Underline __ == Strike == == DEL =={ INS } ((br)) line feed

Special Letter

((amp)) & ((bq)) ` ((lt)) < ((gt)) > ((lp)) ( ((rp)) ) ((lb)) [ ((rb)) ] ((ll)) (( ((rr)) ))

Headline

!!!! site-name !!! section-name !! subsection-name ! subsubsectino-name << section-name >> <<< subsection-name >>> <<<< subsubsection-name >>>> >> Centering and Large-font <<

Itemize

* item1 ** item1-1 ** item1-2

Enumerate

+ item1 + item2 ++ item2-1

Table

|| 1-1 | 1-2 | 1-3 || 2-1 | 2-2 | 2-3

Description

:item ::description

Quotation

6< quotation >9

Preformatted text

8< preformatted-text >8

Edit