svn手册摘录

一、版本库访问URL

模式 访问方法
file:/// 直接版本库访问（本地磁盘）。
http:// 通过配置Subversion的Apache服务器的WebDAV协议。
https:// 与http://相似，但是包括SSL加密。
svn:// 通过svnserve服务自定义的协议。
svn+ssh:// 与svn://相似，但通过SSH封装。


二、修订版本关键字
HEAD
版本库中最新的版本。

BASE
工作拷贝中的“原始”修订版本。

COMMITTED
在BASE版本之前（或在Base）一个项目最后修改的版本。

PREV
一个项目最后修改版本之前的那个版本（技术上为COMMITTED -1）。

PREV、BASE、和COMMITTED指的都是本地路径而不是URL

三、修订版本日期
在任何你使用特定版本号和版本关键字的地方，你也可以在“{}”中使用日期，你也可通过日期或者版本号配合使用来访问一段时间的修改！
如下是一些Subversion能够接受的日期格式，注意在日期中有空格时需要使用引号。

$ svn checkout --revision {2002-02-17}
$ svn checkout --revision {15:30}
$ svn checkout --revision {15:30:00.200000}
$ svn checkout --revision {"2002-02-17 15:30"}
$ svn checkout --revision {"2002-02-17 15:30 +0230"}
$ svn checkout --revision {2002-02-17T15:30}
$ svn checkout --revision {2002-02-17T15:30Z}
$ svn checkout --revision {2002-02-17T15:30-04:00}
$ svn checkout --revision {20020217T1530}
$ svn checkout --revision {20020217T1530Z}
$ svn checkout --revision {20020217T1530-0500}

当你指定一个日期，Subversion会在版本库找到接近这个日期的最新版本

你可以使用时间段，Subversion会找到这段时间的所有版本
$ svn log --revision {2002-11-20}:{2002-11-29}

我们也曾经指出，你可以混合日期和修订版本号
$ svn log --revision {2002-11-20}:4040

四、初始化的checkout

大多数时候，你会使用checkout从版本库取出一个新拷贝开始使用Subversion，这样会在本机创建一个项目的本地拷贝，这个拷贝包括版本库中的HEAD（最新的）版本
$ svn checkout http://svn.collab.net/repos/svn/trunk

通过输入特定URL取出任意深度的子目录
$ svn checkout http://svn.collab.net/repos/svn/trunk/doc/book/tools

在版本库URL之后指定一个目录，这样会将你的工作目录放到你的新目录，举个例子：
$ svn checkout http://svn.collab.net/repos/svn/trunk subv
这样将把你的工作拷贝放到subv而不是和前面那样放到trunk

五、svn status可能返回的状态码

L    abc.c               # svn已经在.svn目录锁定了abc.c
M      bar.c               # bar.c的内容已经在本地修改过了
 M     baz.c               # baz.c属性有修改，但没有内容修改
X      3rd_party           # 这个目录是外部定义的一部分
      foo.o               # svn并没有管理foo.o
!      some_dir            # svn管理这个，但它可能丢失或者不完整
~      qux                 # 作为file/dir/link进行了版本控制，但类型已经改变
I      .screenrc           # svn不管理这个，配置确定要忽略它
A  +   moved_dir           # 包含历史的添加，历史记录了它的来历
M  +   moved_dir/README    # 包含历史的添加，并有了本地修改
D      stuff/fish.c        # 这个文件预定要删除
A      stuff/loot/bloo.h   # 这个文件预定要添加
C      stuff/loot/lump.c   # 这个文件在更新时发生冲突
R      xyz.c               # 这个文件预定要被替换
    S  stuff/squawk        # 这个文件已经跳转到了分支

svn status也有一个--verbose（-v）选项，它可以显示工作拷贝中的所有项目，即使没有改变过
$ svn status --verbose

上面所有的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 status、svn diff和 svn revert）都可以在没有网络的情况下工作


六、解决冲突

我们可以使用svn status -u来预测冲突
$ svn update
U  INSTALL
G  README
C  bar.c
Updated to revision 46
C表示冲突，说明服务器上的改动同你的改动冲突了，你需要自己手工去解决

如果你遇到冲突，三件事你可以选择：

1，“手动”合并冲突文本（检查和修改文件中的冲突标志）。
小于号、等于号和大于号串是冲突标记，并不是冲突的数据，你一定要确定这些内容在下次提交之前得到删除，前两组标志中间的内容是你在冲突区所做的修改
修改完毕，并去掉表示的符号
$ svn resolved sandwich.txt
$ svn commit -m "Go ahead and use my sandwich, discarding Sally's edits."

2，用某一个临时文件覆盖你的工作文件。
$ cp sandwich.txt.r2 sandwich.txt
$ svn resolved sandwich.txt

3，运行svn revert <filename>来放弃所有的修改。

七、提交修改

svn commit命令发送所有的修改到版本库，当你提交修改时，你需要提供一些描述修改的日志信息，你的信息会附到这个修订版本上，如果信息很简短，你可以在命令行中使用--message（-m）选项
$ svn commit --message "Corrected number of cheese slices."
Sending        sandwich.txt
Transmitting file data .
Committed revision 3.

如果你把写日志信息当作工作的一部分，你也许会希望通过告诉Subversion一个文件名得到日志信息，使用--file选项：
$ svn commit --file logmsg
Sending        sandwich.txt
Transmitting file data .
Committed revision 4.


八、检验历史

svn log 展示给你主要信息：附加在版本上的日志信息和所有版本的路径修改。

svn diff
1，检查本地修改
不使用任何参数调用时，svn diff将会比较你的工作文件与缓存在.svn的“原始”拷贝

2，比较工作拷贝与版本库
如果传递一个--revision（-r）参数，你的工作拷贝会与指定的版本比较。
$ svn diff --revision 3 rules.txt

3，比较版本库和版本库
如果通过--revision （-r）传递两个版本号，通过冒号分开，这两个版本会进行比较
$ svn diff --revision 2:3 rules.txt

你不仅可以用svn diff比较你工作拷贝中的文件，你甚至可以通过提供一个URL参数来比较版本库中两个文件的的区别，通常在本地机器没有工作拷贝时非常有用

svn cat 如果你只是希望检查一个过去的版本而不希望察看它们的区别，使用svn cat

svn list可以在不下载文件到本地目录的情况下来察看目录中的文件
$ svn list http://svn.collab.net/repos/svn
如果你希望察看详细信息，你可以使用--verbose （-v）参数
$ svn list --verbose http://svn.collab.net/repos/svn

九、其他命令

svn cleanup 查找工作拷贝中的所有遗留的日志文件，删除进程中的锁

svn import命令是拷贝用户的一个未被版本化的目录树到版本库最快的方法
$ svnadmin create /usr/local/svn/newrepos
$ svn import mytree file:///usr/local/svn/newrepos/some/project
Adding         mytree/foo.c
Adding         mytree/bar.c
Adding         mytree/subdir
Adding         mytree/subdir/quux.h

Committed revision 1.

将会拷贝目录mytree到版本库的some/project
$ svn list file:///usr/local/svn/newrepos/some/project
bar.c
foo.c
subdir/

===============================================================================================

分支与合并

一、建立分支

建立分支最简单的方法：svn copy可以直接对两个URL操作

$ svn copy http://svn.example.com/repos/calc/trunk \
           http://svn.example.com/repos/calc/branches/my-calc-branch \
      -m "Creating a private branch of /calc/trunk."

Committed revision 341.

二、拷贝特定的修改

查看区别
$ svn diff -r 343:344 http://svn.example.com/repos/calc/trunk

svn merge命令几乎完全相同，但不是打印区别到你的终端，它会直接作为本地修改作用到你的本地拷贝
$ svn merge -r 343:344 http://svn.example.com/repos/calc/trunk
U  integer.c

$ svn status
M  integer.c

当你提交你的修改时，确定你的日志信息中说明你是从某一版本搬运了修改
$ svn commit -m "integer.c: ported r344 (spelling fixes) from trunk."

svn merge这个命令包括三个参数：

1，初始的版本树（通常叫做比较的左边），
2，最终的版本树（通常叫做比较的右边），
3，一个接收区别的工作拷贝（通常叫做合并的目标）。

svn merge的语法允许非常灵活的指定参数
$ svn merge http://svn.example.com/repos/branch1@150 \
            http://svn.example.com/repos/branch2@212 \
            my-working-copy
$ svn merge -r 100:200 http://svn.example.com/repos/trunk my-working-copy
$ svn merge -r 100:200 http://svn.example.com/repos/trunk
第一种语法使用URL@REV的形式直接列出了所有参数，
第二种语法可以用来作为比较同一个URL的不同版本的简略写法，
最后一种语法表示工作拷贝是可选的，如果省略，默认是当前目录。

三、预览合并

$ svn merge --dry-run -r 343:344 http://svn.example.com/repos/calc/trunk
U  integer.c

$ svn status
#  nothing printed, working copy is still unchanged.

--dry-run选项实际上并不修改本地拷贝，它只是显示实际合并时的状态信息，对于得到“整体”的印象，这个命令很有用，因为svn diff包括太多细节


四、常见用例

查 找分支产生的版本（分支的“基准”）的最好方法是在svn log中使用--stop-on-copy选项，log子命令通常会显示所有关于分支的变化，包括 创建分支的过程，就好像你在主干上一样，--stop-on-copy会在svn log检测到目标拷贝或者改名时中止日志输出
$ svn log --verbose --stop-on-copy \
          http://svn.example.com/repos/calc/branches/my-calc-branch
…
------------------------------------------------------------------------
r341 | user | 2002-11-03 15:27:56 -0600 (Thu, 07 Nov 2002) | 2 lines
Changed paths:
   A /calc/branches/my-calc-branch (from /calc/trunk:340)

$
如下是最终的合并过程，然后
$ cd calc/trunk
$ svn update
At revision 405.

$ svn merge -r 341:405 http://svn.example.com/repos/calc/branches/my-calc-branch
U   integer.c
U   button.c
U   Makefile

$ svn status
M   integer.c
M   button.c
M   Makefile

# ...examine the diffs, compile, test, etc...

$ svn commit -m "Merged my-calc-branch changes r341:405 into the trunk."
Sending        integer.c
Sending        button.c
Sending        Makefile
Transmitting file data ...
Committed revision 406.

五、取消修改
svn merge另一个常用的做法是取消已经做得提交
$ svn merge -r 303:302 http://svn.example.com/repos/calc/trunk
U  integer.c

$ svn status
M  integer.c

$ svn diff
…
# verify that the change is removed
…

$ svn commit -m "Undoing change committed in r303."
Sending        integer.c
Transmitting file data .
Committed revision 350.


六、找回删除的项目

一个好的策略是使用svn log --verbose来察看你删除的项目，--verbose选项显示所有改变的项目的每一个版本 ，你只需要找出你删除文件或目录的那一个版本

svn copy命令，精确的拷贝版本和路径“坐标对”到你的工作拷贝
$ svn copy --revision 807 \
           http://svn.example.com/repos/calc/trunk/real.c ./real.c

$ svn status
A  +   real.c

$ svn commit -m "Resurrected real.c from revision 807, /calc/trunk/real.c."
Adding         real.c
Transmitting file data .
Committed revision 1390.

七、发布分支

这是版本控制可以做的帮助，典型的过程如下：

开发者提交所有的新特性到主干。 每日的修改提交到/trunk：新特性，bug修正和其他。

这个主干被拷贝到“发布”分支。 当小组认为软件已经做好发布的准备（如，版本1.0）然后/trunk会被拷贝到/branches/1.0。

项目组继续并行工作，一个小组开始对分支进行严酷的测试，同时另一个小组在/trunk继续新的工作（如，准备2.0），如果一个bug在任何一个位置被发现，错误修正需要来回运送。然而这个过程有时候也会结束，例如分支已经为发布前的最终测试“停滞”了。

分支已经作了标签并且发布，当测试结束，/branches/1.0作为引用快照已经拷贝到/tags/1.0.0，这个标签被打包发布给客户。

分支多次维护。当继续在/trunk上为版本2.0工作，bug修正继续从/trunk运送到/branches/1.0，如果积累了足够的bug修正，管理部门决定发布1.0.1版本：拷贝/branches/1.0到/tags/1.0.1，标签被打包发布。

整个过程随着软件的成熟不断重复：当2.0完成，一个新的2.0分支被创建，测试、打标签和最终发布，经过许多年，版本库结束了许多版本发布，进入了“维护”模式，许多标签代表了最终的发布版本。

八、转换工作拷贝

svn switch命令改变存在的工作拷贝到另一个分支
$ svn info | grep URL
URL: http://svn.example.com/repos/calc/trunk

$ svn switch http://svn.example.com/repos/calc/branches/my-calc-branch
U   integer.c
U   button.c
U   Makefile
Updated to revision 341.

$ svn info | grep URL
URL: http://svn.example.com/repos/calc/branches/my-calc-branch

九、版本库布局

如果一个版本库只是存放一个项目，人们会在顶级目录创建这些目录：
/trunk
/branches
/tags

如果一个版本库保存了多个项目，管理员会通过项目来布局
/paint/trunk
/paint/branches
/paint/tags
/calc/trunk
/calc/branches
/calc/tags

十、数据的生命周期

假定你最终完成了calc项目你的个人分支上的所有工作，在合并了你的所有修改到/calc/trunk后，没有必要继续保留你的私有分支目录

$ svn delete http://svn.example.com/repos/calc/branches/my-calc-branch \
             -m "Removing obsolete branch of calc project."

Committed revision 375.

如果浏览你删除的目录还不足够，你可以把它找回来，恢复数据对Subversion来说很简单，如果你希望恢复一个已经删除的目录（或文件）到HEAD，仅需要使用svn copy -r来从旧的版本拷贝出来
$ svn copy -r 374 http://svn.example.com/repos/calc/branches/my-calc-branch \
                  http://svn.example.com/repos/calc/branches/my-calc-branch