帮助!

本书的目标是成为 Subversion 新老用户的助手与信息来源, 不过, Subversion 的命令行工具本身就带有丰富的帮助文档, 如此一来, 读者就 用不着每次都从书架上拿这本书. 命令 svn help 是 打开内置文档的入口:

$ svn help
usage: svn <subcommand> [options] [args]
Subversion command-line client, version 1.8.13.
Type 'svn help <subcommand>' for help on a specific subcommand.
Type 'svn --version' to see the program version and RA modules
  or 'svn --version --quiet' to see just the version number.

Most subcommands take file and/or directory arguments, recursing
on the directories.  If no arguments are supplied to such a
command, it recurses on the current directory (inclusive) by default.

Available subcommands:
   add
   blame (praise, annotate, ann)
   cat
…

上面的输出内容已经说了, 读者可以用 svn help SUBCOMMAND 查看特定子命令的帮助信息, Subversion 会输出这个子命令完整的使用方法, 包括它的语法, 选项和功能:

$ svn help help
help (?, h): Describe the usage of this program or its subcommands.
usage: help [SUBCOMMAND...]

Global options:
  --username ARG           : specify a username ARG
  --password ARG           : specify a password ARG
…

选项 (Options), 开关 (Switches) 和标志 (Flags), 这都是什 么鬼?

Subversion 的客户端命令行工具拥有大量的命令修饰符, 有些人把它们 叫作 “开关” 或 “标志” — 本书把它们叫 作 “选项”. 读者将会看到特定的 svn 子命令支持的选项, 再加上所有子命令都支持的全局选项, 全局选项显示在 子命令帮助信息靠近底部的位置.

Subversion 的选项有两种形式: 短选项由一个连字符和一个英文字母 组成, 长选项以两个连续的连字符开始, 后跟几个英文字母和连字符 (例如 短选项 -s 和长选项 --this-is-a-long-option), 每一个选项都至少有一个长格式. 有些选项—例如 --changelist—会有一个缩写的长格式别名 (--cl), 只有特定的几个选项 — 通常是最经常用到的选项 — 才会拥有一个额外的短格式. 为了使书中的内容更加清晰, 在例子中我们通常 使用选项的长格式, 但是在描述选项时, 如果该选项存在短格式, 我们会 同时列出长格式 (为了清晰) 和短格式 (为了方便记忆). 读者在执行 Subversion 命令时, 可以自由选择选项的格式.

许多基于 Unix 的 Subversion 发行版都包含了手册页, 可以通过命令 man 打开, 但是手册页往往只是指出了帮助信息的真正 位置, 例如项目网址. 另外, 有些公司会通过论坛和有偿咨询提供 Subversion 的帮助与支持. 当然, 还有资源最丰富的因特网. 获取 Subversion 的帮助从 来就不是一件难事.