使用 Subversion 进行版本控制

目录

前言

序言

什么是 Subversion？

Subversion 是合适的工具吗？

Subversion 的历史

Subversion 的架构

Subversion 的组件

Subversion 的新特性

读者对象

如何阅读本书

本书的组织结构

本书是免费的

致谢

1. 基本概念

版本控制基础

仓库

工作副本

版本控制模型

文件共享问题

锁定-修改-解锁解决方案

复制-修改-合并解决方案

Subversion 的版本控制方式

Subversion 仓库

修订版本

仓库地址

Subversion 工作副本

工作副本的工作原理

基本工作副本交互

混合修订版本工作副本

总结

2. 基本用法

帮助！

将数据导入仓库

导入文件和目录

推荐的仓库布局

名称的意义

创建工作副本

基本工作流程

更新工作副本

进行更改

查看更改

查看更改概述

检查本地修改的详细信息

修复错误

解决冲突

交互式查看冲突差异

交互式解决冲突差异

推迟冲突解决

手动合并冲突

放弃您的更改，转而使用新获取的修订版

推迟：使用 svn revert

提交您的更改

检查历史记录

检查历史更改的详细信息

检查本地更改

比较工作副本与仓库

比较仓库修订版

生成历史更改列表

浏览仓库

显示文件内容

显示逐行更改归属

列出版本化的目录

获取旧的仓库快照

有时您只需要清理

处理工作副本

从中断中恢复

处理结构性冲突

树冲突示例

总结

3. 高级主题

修订版说明符

修订版关键字

修订版日期

挂钩和操作修订版

属性

为什么要使用属性？

操作属性

属性和 Subversion 工作流程

自动属性设置

文件可移植性

文件内容类型

文件可执行性

行尾字符序列

忽略未版本化的项目

关键字替换

稀疏目录

锁定

创建锁

发现锁

破坏和窃取锁

锁通信

外部定义

变更列表

创建和修改变更列表

变更列表作为操作过滤器

变更列表限制

网络模型

请求和响应

客户端凭据

缓存凭据

禁用密码缓存

删除缓存的凭据

命令行身份验证

身份验证总结

总结

4. 分支和合并

什么是分支？

使用分支

创建分支

使用您的分支

分支背后的关键概念

基本合并

变更集

保持分支同步

子树合并和子树 mergeinfo

重新集成分支

mergeinfo 和预览

撤消更改

恢复已删除的项目

高级合并

樱桃采摘

合并语法：完整披露

没有 mergeinfo 的合并

关于合并冲突的更多信息

阻止更改

保持重新集成的分支处于活动状态

合并敏感日志和注释

注意或忽略祖先

合并和移动

防止天真的客户端提交合并

关于合并跟踪的最后说明

遍历分支

标签

创建简单标签

创建复杂标签

分支维护

仓库布局

数据生命周期

常见分支模式

发布分支

功能分支

供应商分支

通用供应商分支管理流程

svn_load_dirs.pl

是否要分支？

总结

5. 仓库管理

Subversion 仓库定义

仓库部署策略

规划仓库组织

决定仓库托管的位置和方式

选择数据存储

Berkeley DB

FSFS

创建和配置仓库

创建仓库

实现仓库钩子

Berkeley DB 配置

FSFS 配置

仓库维护

管理员工具包

svnadmin

svnlook

svndumpfilter

svnrdump

svnsync

fsfs-reshard.py

Berkeley DB 工具

提交日志消息修正

管理磁盘空间

Subversion 如何节省磁盘空间

删除无效事务

清除未使用的 Berkeley DB 日志文件

打包 FSFS 文件系统

Berkeley DB 恢复

将仓库数据迁移到其他位置

使用 svnadmin 迁移仓库数据

使用 svnrdump 迁移仓库数据

过滤仓库历史记录

仓库复制

使用 svnsync 进行复制

使用 svnsync 进行部分复制

创建镜像的快速技巧

复制总结

仓库备份

管理仓库 UUID

移动和删除仓库

总结

6. 服务器配置

概述

选择服务器配置

svnserve 服务器

通过 SSH 使用 svnserve

Apache HTTP 服务器

建议

svnserve，自定义服务器

调用服务器

svnserve 作为守护进程

通过 inetd 使用 svnserve

通过隧道使用 svnserve

svnserve 作为 Windows 服务

svnserve 作为 launchd 作业

内置身份验证和授权

创建用户文件和域

设置访问控制

使用 svnserve 与 SASL

使用 SASL 进行身份验证

SASL 加密

通过 SSH 建立隧道

SSH 配置技巧

初始设置

控制调用的命令

httpd，Apache HTTP 服务器

先决条件

基本 Apache 配置

身份验证选项

基本身份验证

摘要身份验证

授权选项

全面访问控制

按目录访问控制

禁用基于路径的检查

使用 SSL 保护网络流量

Subversion 服务器 SSL 证书配置

Subversion 客户端 SSL 证书管理

额外功能

仓库浏览

Apache 日志记录

直通代理

其他 Apache 功能

基于路径的授权

高级日志记录

服务器优化

数据缓存

网络数据压缩

支持多种仓库访问方法

7. 自定义 Subversion 体验

运行时配置区域

配置区域布局

配置和 Windows 注册表

配置选项

服务器

配置

本地化

了解区域设置

Subversion 的区域设置使用

使用外部编辑器

使用外部差异和合并工具

外部 diff

外部 diff3

外部合并

总结

8. 嵌入 Subversion

分层库设计

仓库层

仓库访问层

客户端层

使用 API

Apache 可移植运行时库

函数和 Baton

URL 和路径要求

使用除 C 和 C++ 之外的语言

代码示例

总结

9. Subversion 完整参考

svn—Subversion 命令行客户端

svn 选项

svn 子命令

svn add

svn blame (praise, annotate, ann)

svn cat

svn changelist (cl)

svn checkout (co)

svn cleanup

svn commit (ci)

svn copy (cp)

svn delete (del, remove, rm)

svn diff (di)

svn export

svn help (h, ?)

svn import

svn info

svn list (ls)

svn lock

svn log

svn merge

svn mergeinfo

svn mkdir

svn move (mv)

svn patch

svn propdel (pdel, pd)

svn propedit (pedit, pe)

svn propget (pget, pg)

svn proplist (plist, pl)

svn propset (pset, ps)

svn relocate

svn resolve

svn resolved

svn revert

svn status (stat, st)

svn switch (sw)

svn unlock

svn update (up)

svn upgrade

svnadmin—Subversion 仓库管理

svnadmin 选项

svnadmin 子命令

svnadmin crashtest

svnadmin create

svnadmin deltify

svnadmin dump

svnadmin help (h, ?)

svnadmin hotcopy

svnadmin list-dblogs

svnadmin list-unused-dblogs

svnadmin load

svnadmin lslocks

svnadmin lstxns

svnadmin pack

svnadmin recover

svnadmin rmlocks

svnadmin rmtxns

svnadmin setlog

svnadmin setrevprop

svnadmin setuuid

svnadmin upgrade

svnadmin verify

svnlook—Subversion 仓库检查

svnlook 选项

svnlook 子命令

svnlook author

svnlook cat

svnlook changed

svnlook date

svnlook diff

svnlook dirs-changed

svnlook filesize

svnlook help (h, ?)

svnlook history

svnlook info

svnlook lock

svnlook log

svnlook propget (pget, pg)

svnlook proplist (plist, pl)

svnlook tree

svnlook uuid

svnlook youngest

svnsync—Subversion 仓库镜像

svnsync 选项

svnsync 子命令

svnsync copy-revprops

svnsync help

svnsync info

svnsync 初始化 (init)

svnsync 同步 (sync)

svnrdump—远程 Subversion 仓库数据迁移

svnrdump 选项

svnrdump 子命令

svnrdump dump

svnrdump 帮助

svnrdump load

svnserve—自定义 Subversion 服务器

svnserve 选项

svndumpfilter—Subversion 历史记录过滤

svndumpfilter 选项

svndumpfilter 子命令

svndumpfilter exclude

svndumpfilter include

svndumpfilter 帮助

svnversion—Subversion 工作副本版本信息

svnversion

mod_dav_svn—Subversion Apache HTTP 服务器模块

mod_dav_svn 配置指令

mod_authz_svn—Subversion Apache HTTP 授权模块

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. 针对 CVS 用户的 Subversion

修订号现在不同了

目录版本

更多断开连接的操作

状态和更新之间的区别

状态

更新

分支和标签

元数据属性

冲突解决

二进制文件和翻译

版本化模块

身份验证

将存储库从 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. 版权

索引