Part I. Nhận Biết Subversion

Table of Contents

1. Những Khái Niệm Cơ Bản

Căn Bản Kiểm Soát Phiên Bản

Kho lưu trữ

Bản sao làm việc

Mô hình phiên bản

Vấn đề của việc chia sẽ tập tin

Giải pháp khoá-sửa đổi-mở khoá

Giải pháp sao chép-sửa đổi-hợp nhất

Kiểm Soát Phiên Bản Theo Cách Của Subversion

Kho lưu trữ Subversion

Phiên bản

Địa chỉ kho lưu trữ

Bản sao làm việc Subversion

Bản sao làm việc hoạt động như thế nào

Tương tác cơ bản trên bảo sao làm việc

Bản sao làm việc phiên-bản-hỗn-hợp

Tóm Tắt

2. Cách Sử Dụng Cơ Bản

Trợ Giúp!

Đưa Dữ Liệu Vào Trong Kho Lưu Trữ Của Bạn

Nhập tập tin và thư mục

Khuyến nghị cách bố trí kho lưu trữ

Tên gọi nói lên điều gì?

Tạo Bản Sao Làm Việc

Chu Kỳ Làm Việc Cơ Bản

Cập nhật bản sao làm việc của bạn

Thực hiện thay đổi của bạn

Xem lại thay đổi của bạn

Xem tổng quan về những thay đổi của bạn

Kiểm tra chi tiết những thay đổi trên bản sao cục bộ của bạn

Sửa lỗi của bạn

Giải quyết xung đột

Xem những khác biệt trên xung đột một cách tương tác

Giải quyết xung đột một cách tương tác

Hoãn giải quyết xung đột

Giải quyết xung đột theo cách thủ công

Huỷ bỏ những thay đổi của bạn và sử dụng phiên bản mới được lấy về

Đánh cược: sử dụng svn revert

Chuyển giao những thay đổi của bạn

Xem Xét Lịch Sử

Xem chi tiết những thay đổi trong lịch sử

Xem xét những thay đổi cục bộ

So sánh bản sao làm việc với kho lưu trữ

So sánh những phiên bản trên kho lưu trữ

Tạo một danh sách các thay đổi lịch sử

Duyệt kho lưu trữ

Hiển thị nội dung tập tin

Hiển thị thuộc tính thay đổi theo-từng-dòng

Liệt kê danh sách những thư mục được định phiên bản

Lấy lại những phiên bản cũ trên kho lưu trữ

Đôi Khi Bạn Chỉ Cần Dọn Dẹp

Hủy bỏ bản sao làm việc

Phục hồi từ gián đoạn

Xử Lý Xung Đột Về Cấu Trúc

Một ví dụ xung đột cấu trúc cây

Tóm Lược

3. Advanced Topics

Revision Specifiers

Revision Keywords

Revision Dates

Peg and Operative Revisions

Properties

Why Properties?

Manipulating Properties

Properties and the Subversion Workflow

Inherited Properties

Automatic Property Setting

Subversion's Reserved Properties

Versioned properties

Unversioned properties

File Portability

File Content Type

File Executability

End-of-Line Character Sequences

Ignoring Unversioned Items

Keyword Substitution

Sparse Directories

Locking

Creating Locks

Discovering Locks

Breaking and Stealing Locks

Lock Communication

Externals Definitions

Changelists

Creating and Modifying Changelists

Changelists As Operation Filters

Changelist Limitations

Network Model

Requests and Responses

Client Credentials

Caching credentials

Disabling password caching

Removing cached credentials

Command-line authentication

Authentication wrap-up

Working Without a Working Copy

Remote command-line client operations

Using svnmucc

Summary

4. Branching and Merging

What's a Branch?

Using Branches

Creating a Branch

Working with Your Branch

The Key Concepts Behind Branching

Basic Merging

Changesets

Keeping a Branch in Sync

Subtree Merges and Subtree Mergeinfo

Reintegrating a Branch

Mergeinfo and Previews

Undoing Changes

Resurrecting Deleted Items

Advanced Merging

Cherrypicking

Merge Syntax: Full Disclosure

Merges Without Mergeinfo

More on Merge Conflicts

Blocking Changes

Merge-Sensitive Logs and Annotations

Noticing or Ignoring Ancestry

Merges and Moves

Preventing Naïve Clients from Committing Merges

The Final Word on Merge Tracking

Traversing Branches

Tags

Creating a Simple Tag

Creating a Complex Tag

Branch Maintenance

Repository Layout

Data Lifetimes

Common Branching Patterns

Release Branches

Feature Branches

Vendor Branches

General Vendor Branch Management Procedure

Vendor Branches from Foreign Repositories

Vendor Branches from Mirrored Sources

To Branch or Not to Branch?

Summary

5. Repository Administration

The Subversion Repository, Defined

Strategies for Repository Deployment

Planning Your Repository Organization

Deciding Where and How to Host Your Repository

Controlling Access to Your Repository

Creating and Configuring Your Repository

Creating the Repository

Implementing Repository Hooks

Hook script environment configuration

Common uses for hook scripts

Finding hook scripts or rolling your own

FSFS Configuration

Repository Maintenance

An Administrator's Toolkit

svnadmin

svnlook

svndumpfilter

svnrdump

svnsync

fsfs-reshard.py

Commit Log Message Correction

Managing Disk Space

How Subversion saves disk space

Removing dead transactions

Packing FSFS filesystems

Migrating Repository Data Elsewhere

Repository data migration using svnadmin

Repository data migration using svnrdump

Filtering Repository History

Repository Replication

Replication with svnsync

Partial replication with svnsync

A quick trick for mirror creation

Replication wrap-up

Repository Backup

Managing Repository UUIDs

Moving and Removing Repositories

Summary

6. Server Configuration

Overview

Choosing a Server Configuration

The svnserve Server

svnserve over SSH

The Apache HTTP Server

Recommendations

svnserve, a Custom Server

Invoking the Server

svnserve as daemon

svnserve via inetd

svnserve via xinetd

svnserve over a tunnel

svnserve as a Windows service

svnserve as a launchd job

Built-in Authentication and Authorization

Create a users file and realm

Set access controls

Using svnserve with SASL

Authenticating with SASL

SASL encryption

Tunneling over SSH

SSH Configuration Tricks

Initial setup

Controlling the invoked command

svnserve Configuration Reference

General configuration

Cyrus SASL configuration

httpd, the Apache HTTP Server

Prerequisites

Basic Apache Configuration

Authentication Options

Basic authentication

Digest authentication

Authorization Options

Blanket access control

Per-directory access control

Disabling path-based checks

Versioned in repository access files

Protecting network traffic with SSL

Subversion server SSL certificate configuration

Subversion client SSL certificate management

Tuning for Performance

KeepAlive

Bulk updates

Extra Goodies

Repository browsing

Apache logging

Write-through proxying

Other Apache features

Subversion Apache HTTP Server Configuration Reference

mod_dav_svn configuration directives

mod_authz_svn configuration directives

Path-Based Authorization

Getting Started with Path-Based Access Control

Access Control Groups

Username Aliases

Advanced Access Control Features

Some Gotchas with Access Control

High-level Logging

Server Optimization

Data Caching

Network Compression of Data

Supporting Multiple Repository Access Methods

7. Customizing Your Subversion Experience

Runtime Configuration Area

Configuration Area Layout

Configuration and the Windows Registry

Runtime Configuration Options

General configuration

Per-server configuration

Localization

Understanding Locales

Subversion's Use of Locales

Using External Editors

Using External Differencing and Merge Tools

External diff

External diff3

External merge

Summary

8. Embedding Subversion

Layered Library Design

Repository Layer

Repository Access Layer

Client Layer

Using the APIs

The Apache Portable Runtime Library

Functions and Batons

URL and Path Requirements

Using Languages Other Than C and C++

Code Samples

Summary