本手册旨在描述 Subversion 1.5。如果您正在运行更新版本的 Subversion，我们强烈建议您访问 https://svnbooks.subversion.org.cn/ 并查阅适合您 Subversion 版本的本手册版本。

使用 Subversion 进行版本控制
   下一页

使用 Subversion 进行版本控制

适用于 Subversion 1.5

(从 r3305 编译)

Ben Collins-Sussman

Brian W. Fitzpatrick

C. Michael Pilato

版权所有 © 2002, 2003, 2004, 2005, 2006, 2007, 2008 Ben Collins-Sussman、Brian W. Fitzpatrick 和 C. Michael Pilato

本作品根据知识共享署名许可发布。要查看此许可的副本，请访问 http://creativecommons.org/licenses/by/2.0/ 或给知识共享组织写信，地址：559 Nathan Abbott Way, Stanford, California 94305, USA。

(待定)

目录

前言
序言
读者对象
如何阅读本书
本书中使用的约定
本书的组织
本书是免费的
鸣谢
来自 Ben Collins-Sussman
来自 Brian W. Fitzpatrick
来自 C. Michael Pilato
什么是 Subversion？
Subversion 是正确的工具吗？
Subversion 的历史
Subversion 的架构
Subversion 的组件
Subversion 中的新功能
1. 基本概念
仓库
版本控制模型
文件共享问题
锁定-修改-解锁解决方案
复制-修改-合并解决方案
Subversion 的实际操作
Subversion 仓库 URL
工作副本
版本
工作副本如何跟踪仓库
混合版本工作副本
更新和提交是分开的
混合版本是正常的
混合版本是有用的
混合版本有局限性
总结
2. 基本用法
帮助！
将数据导入您的仓库
svn import
推荐的仓库布局
初始检出
禁用密码缓存
以不同用户身份进行身份验证
基本工作周期
更新您的工作副本
修改您的工作副本
检查您的更改
查看您的更改概述
检查您本地修改的详细信息
撤销工作更改
解决冲突（合并他人的更改）
交互式地查看冲突差异
交互式地解决冲突差异
推迟冲突解决
手动合并冲突
丢弃您的更改，转而使用新获取的版本
推迟：使用 svn revert
提交您的更改
检查历史记录
生成历史更改列表
检查历史更改的详细信息
检查本地更改
比较工作副本和仓库
比较仓库版本
浏览仓库
svn cat
svn list
获取旧的仓库快照
有时您只需要清理
丢弃工作副本
从中断中恢复
总结
3. 高级主题
版本说明符
版本关键字
版本日期
属性
为什么使用属性？
操作属性
属性和 Subversion 工作流程
自动属性设置
文件可移植性
文件内容类型
文件可执行性
行尾字符序列
忽略未版本化的项目
关键字替换
稀疏目录
锁定
创建锁定
发现锁定
解除锁定和窃取锁定
锁定通信
外部定义
锚定版本和操作版本
变更列表
创建和修改变更列表
变更列表作为操作过滤器
变更列表限制
网络模型
请求和响应
客户端凭据缓存
总结
4. 分支和合并
什么是分支？
使用分支
创建分支
使用您的分支
分支背后的关键概念
基本合并
变更集
保持分支同步
mergeinfo 和预览
撤销更改
恢复已删除的项目
高级合并
挑选
合并语法：完整披露
没有 mergeinfo 的合并
更多关于合并冲突的信息
阻止更改
合并敏感的日志和注释
注意或忽略祖先
合并和移动
阻止合并感知客户端
关于合并跟踪的最后一句话
遍历分支
标签
创建简单的标签
创建复杂的标签
分支维护
仓库布局
数据生命周期
常见的分支模式
发布分支
功能分支
供应商分支
一般的供应商分支管理流程
svn_load_dirs.pl
总结
5. 仓库管理
Subversion 仓库，定义
仓库部署策略
规划您的仓库组织
决定在何处以及如何托管您的仓库
选择数据存储
Berkeley DB
FSFS
创建和配置您的仓库
创建仓库
实现仓库钩子
Berkeley DB 配置
仓库维护
管理员工具包
svnadmin
svnlook
svndumpfilter
svnsync
fsfs-reshard.py
Berkeley DB 实用程序
提交日志消息校正
管理磁盘空间
Subversion 如何节省磁盘空间
删除无效事务
清除未使用的 Berkeley DB 日志文件
Berkeley DB 恢复
将仓库数据迁移到其他位置
过滤仓库历史记录
仓库复制
仓库备份
管理仓库 UUID
移动和删除仓库
总结
6. 服务器配置
概述
选择服务器配置
svnserve 服务器
通过 SSH 使用 svnserve
Apache HTTP 服务器
建议
svnserve，自定义服务器
调用服务器
svnserve 作为守护进程
通过 inetd 使用 svnserve
通过隧道使用 svnserve
svnserve 作为 Windows 服务
内置身份验证和授权
创建用户文件和域
设置访问控制
使用 svnserve 和 SASL
使用 SASL 进行身份验证
SASL 加密
通过 SSH 建立隧道
SSH 配置技巧
初始设置
控制调用的命令
httpd，Apache HTTP 服务器
先决条件
基本 Apache 配置
身份验证选项
设置 HTTP 身份验证
SSL 证书管理
授权选项
整体访问控制
每个目录的访问控制
禁用基于路径的检查
额外的好东西
仓库浏览
Apache 日志记录
直写代理
其他 Apache 功能
基于路径的授权
支持多种仓库访问方法
7. 自定义 Subversion 体验
运行时配置区域
配置区域布局
配置和 Windows 注册表
配置选项
服务器
配置
本地化
了解区域设置
Subversion 的区域设置使用
使用外部编辑器
使用外部差异和合并工具
外部 diff
外部 diff3
总结
8. 嵌入 Subversion
分层库设计
仓库层
仓库访问层
客户端层
工作副本管理区域内部
条目文件
原始副本和属性文件
使用 API
Apache 可移植运行时库
URL 和路径要求
使用除 C 和 C++ 之外的其他语言
代码示例
总结
9. Subversion 完整参考
Subversion 命令行客户端：svn
svn 选项
svn 子命令
svn add
svn blame
svn cat
svn changelist
svn checkout
svn cleanup
svn commit
svn copy
svn delete
svn diff
svn export
svn help
svn import
svn info
svn list
svn lock
svn log
svn merge
svn mergeinfo
svn mkdir
svn move
svn propdel
svn propedit
svn propget
svn proplist
svn propset
svn resolve
svn resolved
svn revert
svn status
svn switch
svn unlock
svn update
svnadmin
svnadmin 选项
svnadmin 子命令
svnadmin crashtest
svnadmin create
svnadmin deltify
svnadmin dump
svnadmin help
svnadmin hotcopy
svnadmin list-dblogs
svnadmin list-unused-dblogs
svnadmin load
svnadmin lslocks
svnadmin lstxns
svnadmin recover
svnadmin rmlocks
svnadmin rmtxns
svnadmin setlog
svnadmin setrevprop
svnadmin setuuid
svnadmin upgrade
svnadmin verify
svnlook
svnlook 选项
svnlook 子命令
svnlook author
svnlook cat
svnlook changed
svnlook date
svnlook diff
svnlook dirs-changed
svnlook help
svnlook history
svnlook info
svnlook lock
svnlook log
svnlook propget
svnlook proplist
svnlook tree
svnlook uuid
svnlook youngest
svnsync
svnsync 选项
svnsync 子命令
svnsync copy-revprops
svnsync help
svnsync initialize
svnsync synchronize
svnserve
svnserve 选项
svndumpfilter
svndumpfilter 选项
svndumpfilter 子命令
svndumpfilter exclude
svndumpfilter include
svndumpfilter help
svnversion
svnversion
mod_dav_svn
mod_dav_svn 配置指令
mod_authz_svn
mod_authz_svn 配置指令
Subversion 属性
版本化属性
非版本化属性
仓库钩子
start-commit
pre-commit
post-commit
pre-revprop-change
post-revprop-change
pre-lock
post-lock
pre-unlock
post-unlock
A. Subversion 快速入门指南
安装 Subversion
高速教程
B. Subversion 针对 CVS 用户
版本号现在不同了
目录版本
更多分离操作
状态和更新之间的区别
状态
更新
分支和标签
元数据属性
冲突解决
二进制文件和翻译
版本化模块
身份验证
将仓库从 CVS 转换为 Subversion
C. WebDAV 和自动版本控制
什么是 WebDAV？
自动版本控制
客户端互操作性
独立 WebDAV 应用程序
Microsoft Office、Dreamweaver、Photoshop
cadaver、DAV Explorer
文件浏览器 WebDAV 扩展
Microsoft Web 文件夹
Nautilus、Konqueror
WebDAV 文件系统实现
WebDrive、NetDrive
Mac OS X
Linux davfs2
D. 版权
索引

图例

1. Subversion 的架构
1.1. 典型的客户端/服务器系统
1.2. 要避免的问题
1.3. 锁定-修改-解锁解决方案
1.4. 复制-修改-合并解决方案
1.5. 复制-修改-合并解决方案（续）
1.6. 仓库的文件系统
1.7. 仓库
4.1. 开发分支
4.2. 起始仓库布局
4.3. 具有新副本的仓库
4.4. 一个文件历史记录的分支
8.1. 二维的文件和目录
8.2. 版本控制时间——第三维度！

表格目录

1.1. 仓库访问 URL
4.1. 分支和合并命令
5.1. 仓库数据存储比较
6.1. Subversion 服务器选项比较
C.1. 常用 WebDAV 客户端

示例目录

5.1. txn-info.sh (报告未完成的事务)
5.2. 镜像仓库的 pre-revprop-change 钩子脚本
5.3. 镜像仓库的 start-commit 钩子脚本
6.1. 匿名访问的示例配置
6.2. 身份验证访问的示例配置
6.3. 混合身份验证/匿名访问的示例配置
6.4. 完全禁用路径检查
7.1. 示例注册项 (.reg) 文件
7.2. diffwrap.py
7.3. diffwrap.bat
7.4. diff3wrap.py
7.5. diff3wrap.bat
8.1. 使用仓库层
8.2. 使用 Python 的仓库层
8.3. Python 状态爬虫
   下一页
   前言
TortoiseSVN 官方中文版 1.14.7 发布