[svnbook] r5305 committed - branches/1.8/zh/book/ch02-basic-usage.xml

wuzhouhui at users.sourceforge.net wuzhouhui at users.sourceforge.net
Fri Jun 2 20:49:10 CDT 2017


Revision: 5305
          http://sourceforge.net/p/svnbook/source/5305
Author:   wuzhouhui
Date:     2017-06-03 01:49:09 +0000 (Sat, 03 Jun 2017)
Log Message:
-----------
Branch 1.8/zh: chapter 2 reviewed

Modified Paths:
--------------
    branches/1.8/zh/book/ch02-basic-usage.xml

Modified: branches/1.8/zh/book/ch02-basic-usage.xml
===================================================================
--- branches/1.8/zh/book/ch02-basic-usage.xml	2017-06-03 00:25:24 UTC (rev 5304)
+++ branches/1.8/zh/book/ch02-basic-usage.xml	2017-06-03 01:49:09 UTC (rev 5305)
@@ -20,7 +20,7 @@
   <para>理论是很用的, 但是实际使用它们的乐趣却很简单. 现在我们开始介绍使用
     Subversion 的细节, 到这一章结束时, 读者在日常工作中使用 Subversion 将
     不会遇到太大的问题. 本章首先介绍如何把文件纳入 Subversion, 然后对代码
-    进行首次检出, 接下来将对代码进行一些修改, 并检查修改前后的代码差异. 读
+    进行首次检出, 接下来将对代码进行一些修改, 并检查修改前后的具体差异. 读
     者还将会看到如何把其他人的修改应用到自己的工作副本中, 检查修改并解决可
     能的冲突.</para>
 
@@ -51,7 +51,7 @@
     to a Subversion repository.</para>
   -->
   <para>另外, 本章还假设读者已经拥有了一个已存在的 Subversion 仓库. 没有仓库
-    就没有工作副本, 没有工作副本就无法实践本章的内容. 在因特网上可以找到许多
+    就没有工作副本, 没有工作副本就无法练习本章的内容. 在因特网上可以找到许多
     提供免费或廉价的 Subversion 仓库托管服务的网站, 如果读者想要自己创建仓库,
     请阅读 <xref linkend="svn.reposadmin"/>. 为了练习本章的例子, 读者必须对
     Subversion 仓库拥有访问权限.</para>
@@ -98,7 +98,7 @@
       help</command> command is your gateway to that built-in
       documentation:</para>
     -->
-    <para>本书的目的是成为 Subversion 新老用户的助手与信息来源, 不过,
+    <para>本书的目标是成为 Subversion 新老用户的助手与信息来源, 不过,
       Subversion 的命令行工具本身就带有丰富的帮助文档, 如此一来, 读者就
       用不着每次都从书架上拿这本书. 命令 <command>svn help</command> 是
       打开内置文档的入口:</para>
@@ -133,8 +133,8 @@
     -->
     <para>上面的输出内容已经说了, 读者可以用 <userinput>svn help <replaceable>
       SUBCOMMAND</replaceable></userinput> 查看特定子命令的帮助信息,
-      Subversion 会输出这个子命令完整的使用方法, 包括它的语法, 选项和行
-      为:</para>
+      Subversion 会输出这个子命令完整的使用方法, 包括它的语法, 选项和功能:
+      </para>
 
     <informalexample>
       <screen>
@@ -172,7 +172,7 @@
         usage message for that subcommand.</para>
       -->
       <para> Subversion 的客户端命令行工具拥有大量的命令修饰符, 有些人把它们
-        叫作 <quote>开关</quote> 或 <quote>标志</quote> — 本书把它叫
+        叫作 <quote>开关</quote> 或 <quote>标志</quote> — 本书把它们叫
         作 <quote>选项</quote>. 读者将会看到特定的 <command>svn</command>
         子命令支持的选项, 再加上所有子命令都支持的全局选项, 全局选项显示在
         子命令帮助信息靠近底部的位置.</para>
@@ -198,12 +198,12 @@
       <para>Subversion 的选项有两种形式: 短选项由一个连字符和一个英文字母
         组成, 长选项以两个连续的连字符开始, 后跟几个英文字母和连字符 (例如
         短选项 <literal>-s</literal> 和长选项 <literal>--this-is-a-long-option
-        </literal>), 每一个选项都至少有一个长格式. 有些选项, 例如 <option>
-        --changelist</option>, 会有一个缩写的长格式别名 (<option>--cl
+        </literal>), 每一个选项都至少有一个长格式. 有些选项—例如 <option>
+        --changelist</option>—会有一个缩写的长格式别名 (<option>--cl
       </option>), 只有特定的几个选项 — 通常是最经常用到的选项 —
       才会拥有一个额外的短格式. 为了使书中的内容更加清晰, 在登录中我们通常
-      使用选项的长格式, 但是在描述选项时, 如果该选项存在短格式, 我们将会
-      同时长格式 (为了清晰) 和短格式 (为了方便记忆). 读者在执行 Subversion
+      使用选项的长格式, 但是在描述选项时, 如果该选项存在短格式, 我们会
+      同时列出长格式 (为了清晰) 和短格式 (为了方便记忆). 读者在执行 Subversion
       命令时, 可以自由选择选项的格式.</para>
 
     </sidebar>
@@ -274,8 +274,8 @@
       -->
       <para>命令 <command>svn import</command> 可以快速地向仓库中添加新文件
         或目录. <command>svn import</command> 不要求工作副本, 新增的文件会
-        马上提交到仓库中. 使用该命令的典型情况是用户想要把一个已存在的文件
-        树添加到 Subversion 仓库中, 例如:</para>
+        马上提交到仓库中. 使用该命令的典型情况是用户想要把一个已存在的目录
+        添加到 Subversion 仓库中, 例如:</para>
 
       <informalexample>
         <screen>
@@ -351,7 +351,7 @@
       <para>为了方便用户管理数据, Subversion 提供了很大的灵活性. Subversion
         只是简单地对目录和文件进行版本控制, 不会给它们附上特殊的意义, 用户
         完全可以按照自己的喜好来决定数据的布局. 不过, 这种灵活性有时也会带
-        来一些麻烦, 如果用户同时在 2 个或多个布局完成不同的仓库中浏览, 而这
+        来一些麻烦, 如果用户同时在 2 个或多个布局完全不同的仓库中浏览, 而这
         些仓库的布局又没有规律, 那么人们往往会感到迷失, 不知身在何处.</para>
 
       <para>
@@ -503,7 +503,7 @@
         XML 的属性值, 属性名是 XML 的标签名, 此时文件路径只能包含合法的
         XML (1.0) 字符, 属性也只能使用 ASCII 字符. Subversion 禁止在文件路径
         中出现 <literal>TAB</literal>, <literal>CR</literal> 和
-        <literal>LF</literal> 这些字符, 避免在差异比较时, 或者在命令
+        <literal>LF</literal> 这些字符, 这是为了避免在差异比较时, 或者在命令
         <command>svn log</command> 和 <command>svn status</command> 和输出中
         文件路径被错误地断开.</para>
 
@@ -646,7 +646,7 @@
         的意愿编辑里面的文件, 但是其他事情必须告诉给 Subversion. 例如, 如果
         用户想要复制或移动工作副本中的某个文件或目录, 必须使用
         <command>svn copy</command> 或 <command>svn move</command>, 而不是
-        操作系统提供了复制与移动命令. 关于它们的更多内容会在后面讲到.</para>
+        操作系统提供的复制与移动命令. 关于它们的更多内容会在后面讲到.</para>
     </warning>
 
       <!--
@@ -693,7 +693,7 @@
       local directory name that Subversion should use for the working
       copy it creates.  For example:</para>
       -->
-    <para>在上面的两个例子中, Subversion 在本地创建的目录名是检出命令中,
+    <para>在上面的两个例子中, Subversion 在本地创建的目录名是检出命令中
       URL 参数的最后一个分量. 如果用户只向 <command>svn checkout</command>
       提供了 URL 参数, 那么根据最后一个分量来创建目录对用户来说就比较方便.
       不过 Subversion 客户端命令行工具也允许用户自己指定一个目录名, 例如:
@@ -813,7 +813,7 @@
       -->
         <para><emphasis>解决冲突 (合并其他人的修改).</emphasis> 当一个用户
           正在修改文件时, 其他人可能已经把自己的修改提交到了服务器上. 为了防止
-          在提交修改时, 由于工作副本过而旧导致提交失败, 用户需要把其他人的修改
+          在提交修改时, 由于工作副本过旧导致提交失败, 用户需要把其他人的修改
           更新到本地, 用到的命令是 <command>svn update</command>. 如果命令
           的执行结果有冲突产生, 用户需要用命令 <command>svn resolve</command>
           解决冲突.</para>
@@ -954,7 +954,7 @@
         器, 字处理程序, 图形工具等. Subversion 可以自动检测到哪些文件发生了
         变化, 处理二进制文件和处理文本文件一样简单高效. 目录修改涉及到目录结构
         的变化, 例如添加和删除文件, 重命名文件和目录, 复制文件和目录. 目录修改
-        要使用 Subversion 的操作来完成. 文件修改和目录修改只有在提交后才会更新
+        要使用 Subversion 的命令完成. 文件修改和目录修改只有在提交后才会更新
         到仓库中.</para>
 
       <sidebar>
@@ -1075,7 +1075,7 @@
       <para>从工作副本中删除文件, 目录或符号链接 <filename>FOO</filename>,
         在下一次提交时, <filename>FOO</filename> 就会从仓库中删除.
         <footnote><para>当然, 不会有东西可以从仓库中完全删除 —它们
-            只是从修改号 <literal>HEAD</literal> 中删除, 可以从更早的
+            只是从版本号 <literal>HEAD</literal> 中删除, 可以从更早的
             修改版中看到被删除的条目, 只要用户愿意, 可以把删除的条目恢复
             到 <literal>HEAD</literal> 中, 参考
             <xref linkend="svn.branchmerge.basicmerging.resurrect"/>.
@@ -1164,7 +1164,7 @@
       <!--
         <title>Changing the Repository Without a Working Copy</title>
       -->
-        <title>在没有工作副本的情况下, 修改仓库</title>
+        <title>在没有工作副本的情况下修改仓库</title>
 
       <!--
         <para>Subversion <emphasis>does</emphasis> offer ways to
@@ -1183,7 +1183,7 @@
         <para>Subversion <emphasis>确实</emphasis> 支持在没有显式的提交操作
           下, 马上把目录修改提交到仓库中. 除了工作副本中的路径,
           <command>svn mkdir</command>, <command>svn copy</command> 和
-          <command>svn delete</command> 还可以接受仓库有 URL 作为参数. 前面
+          <command>svn delete</command> 还可以接受仓库的 URL 作为参数. 前面
           我们也提到过, <command>svn import</command> 总是直接修改仓库.
           我们会在 <xref linkend="svn.advanced.working-without-a-wc"/> 介绍
           如何在没有工作副本的情况下提交目录修改.</para>
@@ -1301,7 +1301,7 @@
           件, 这就允许 Subversion 在不需要连接网络的情况下, 查看或撤消本地
           的修改. 这些缓存 (称为 <firstterm>基文本</firstterm>,
           <firstterm>text-base</firstterm>) 允许 Subversion 把用户的修改
-          压缩后再向服务器提交. 这样做的好处是巨大的 — 就算用户的网络
+          压缩后再向服务器提交. 这样做有很大的好处 — 就算用户的网络
           访问速度很快, 但是和发送整个文件相比, 只发送差异部分会快得多.
         </para>
 
@@ -1357,8 +1357,8 @@
           made.</para>
       -->
         <para>如果在工作副本的根目录不加任何参数地执行
-          <userinput>svn status</userinput>, Subversion 就会检查并报告所有的
-          文件与目录修改.</para>
+          <userinput>svn status</userinput>, Subversion 就会检查并报告所有
+          文件目录的修改.</para>
 
         <informalexample>
           <screen>
@@ -1510,7 +1510,7 @@
       -->
         <para>这是 <command>svn status</command> 的 <quote>长格式</quote>
           (long form) 输出. 第一列字符的含义不变, 第二列显示该项在工作副本
-          中的修订号, 第三和第四列显示该项最后一次被修改的修订号和作者.</para>
+          中的版本号, 第三和第四列显示该项最后一次被修改的版本号和作者.</para>
 
       <!--
         <para>None of the prior invocations to <command>svn
@@ -1562,7 +1562,7 @@
           <filename>README</filename> 和 <filename>trout.c</filename> 的更新.
           除此之外我们还可以知道, 在本地被修改的文件当中, 至少有一个在仓库中
           也被更新了 (文件 <filename>README</filename>), 所以用户必须在提交前把
-          仓库中的更新同步到本地, 否则仓库将会拒绝针对已过时文件的提交,
+          仓库的更新同步到本地, 否则仓库将会拒绝针对已过时文件的提交,
           关于这点我们会在后面介绍更多的细节.</para>
 
       <!--
@@ -2020,7 +2020,7 @@
               as set in the environment variable
               <literal>EDITOR</literal>.</para>
       -->
-            <para>使用环境变化 <literal>EDITOR</literal> 定义的编辑器打开
+            <para>使用环境变量 <literal>EDITOR</literal> 定义的编辑器打开
               发生冲突的文件.</para>
           </listitem>
         </varlistentry>
@@ -2225,9 +2225,9 @@
           the server (<emphasis>usually</emphasis> the
           <literal>HEAD</literal> revision).</para>
       -->
-        <para>差异内容的第一行显示了工作副本之前的内容 (修订号
+        <para>差异内容的第一行显示了工作副本之前的内容 (版本号
           <literal>BASE</literal>), 下一行是用户的修改, 最后一行是从服务器
-          收到的修改 (<emphasis>通常</emphasis> 是修订号
+          收到的修改 (<emphasis>通常</emphasis> 是版本号
           <literal>HEAD</literal>).</para>
 
       <!--
@@ -2553,9 +2553,9 @@
                     <replaceable>OLDREV</replaceable> is that base
                     revision number.</para>
       -->
-                  <para>该文件的内容和修订号 <literal>BASE</literal> 对应
+                  <para>该文件的内容和版本号 <literal>BASE</literal> 对应
                     的文件内容相同, 也就是在执行更新操作前工作副本中未修改
-                    的版本, <replaceable>OLDREV</replaceable> 是基础修订号.
+                    的版本, <replaceable>OLDREV</replaceable> 是基础版本号.
                   </para>
                 </listitem>
               </varlistentry>
@@ -2574,7 +2574,7 @@
                     requested).</para>
       -->
                   <para>该文件的内容和从服务器收到的版本相同,
-                    <replaceable>NEWREV</replaceable> 等于更新到的修订号
+                    <replaceable>NEWREV</replaceable> 等于更新到的版本号
                     (如果没有额外指定的话, 就是 <literal>HEAD</literal>).
                   </para>
                 </listitem>
@@ -2616,10 +2616,12 @@
 </screen>
         </informalexample>
 
+    <!--
         <para>At this point, Subversion will <emphasis>not</emphasis>
           allow Sally to commit the file
           <filename>sandwich.txt</filename> until the three temporary
           files are removed:</para>
+    -->
         <para>此时, 直到这三个临时文件被删除之前, Subversion 不会允许 Sally
           提交 <filename>sandwich.txt</filename>:</para>
 
@@ -2660,7 +2662,7 @@
           <command>svn resolve</command>, Subversion 就会进入交互式地冲突
           解决步骤, 这部分内容我们已经在上一节—
           <xref linkend="svn.tour.cycle.resolve.resolve"/>—介绍过了.
-          下面我们会介绍如何使用选择 <option>--accept</option>.</para>
+          下面我们会介绍如何使用选项 <option>--accept</option>.</para>
 
       <!--
         <para>The <option>- -accept</option> option to the <command>svn
@@ -2790,7 +2792,7 @@
           composed of the changes you made in the conflicting
           area:</para>
       -->
-        <para>分别由小于号, 等号和大于号缓存的行是冲突标记, 它们不是冲突数据
+        <para>分别由小于号, 等号和大于号组成的行是冲突标记, 它们不是冲突数据
           一部分, 用户通常只需要确保在提交前把它们都删除掉即可. 前两个标记之
           间的文本是用户的本地修改.</para>
 
@@ -3008,7 +3010,7 @@
         (<option>-m</option>) option:</para>
       -->
       <para><command>svn commit</command> 把本地的所有修改发往仓库. 提交时
-        用户需要输入一段日志来描述本次修改, 日志被附加到新的修订号上. 如果
+        用户需要输入一段日志来描述本次修改, 日志被附加到新的版本号上. 如果
         日志比较简短, 可以用选项 <option>--message</option>
         (<option>-m</option>) 在直接命令行上输入日志:</para>
 
@@ -3159,9 +3161,9 @@
       -->
     <para>Subversion 仓库就像一台时间机器, 它记录了用户提交的每一次修改,
       允许用户查看文件和目录以前的版本, 以及它们的元数据. 只要一个命令,
-      用户就可以检出仓库在以前任意一个时间点或修订号的版本 (或复原一个
-      已存在的工作副本). 不过, 有时候用户可能只是想看一下过去的历史, 而不是
-      想真正地回到过去.</para>
+      用户就可以检出仓库在以前任意一个时间点或版本号的版本 (或者回滚工作
+      副本的版本号). 不过, 有时候用户可能只是想看一下过去的历史,
+      而不是想真正地回到过去.</para>
 
       <!--
     <para>Several commands can provide you with historical data from
@@ -3189,7 +3191,7 @@
               and author information attached to revisions and which
               paths changed in each revision</para>
       -->
-            <para>和修订号绑定的日志消息, 及其日期, 作者, 以及受影响的文件
+            <para>和版本号绑定的日志消息, 及其日期, 作者, 以及受影响的文件
               路径.</para>
           </listitem>
         </varlistentry>
@@ -3201,7 +3203,7 @@
             <para>Retrieves a file as it existed in a particular
               revision number and displays it on your screen</para>
       -->
-            <para>根据给定的修改号, 输出文件在该版本下的内容.</para>
+            <para>根据给定的版本号, 输出文件在该版本下的内容.</para>
           </listitem>
         </varlistentry>
 
@@ -3214,7 +3216,7 @@
               tabular form with last-changed information attributed to
               each line of the file.</para>
       -->
-            <para>根据给定的修改号, 查看该版本下的文件的每一行的最后一
+            <para>根据给定的版本号, 查看该版本下的文件的每一行的最后一
               次修改信息.</para>
           </listitem>
         </varlistentry>
@@ -3226,7 +3228,7 @@
             <para>Displays the files in a directory for any given
               revision</para>
       -->
-            <para>根据给定的修订号, 列出仓库在该版本下的文件与目录清单.</para>
+            <para>根据给定的版本号, 列出仓库在该版本下的文件与目录清单.</para>
           </listitem>
         </varlistentry>
 
@@ -3276,7 +3278,7 @@
       <!--
           <para>Comparing repository revisions</para>
       -->
-          <para>比较仓库的修订号</para>
+          <para>比较仓库的版本号</para>
         </listitem>
 
       </itemizedlist>
@@ -3332,7 +3334,7 @@
           repository:</para>
       -->
         <para>如果带上选项 <option>--revision</option> (<option>-r</option>),
-          命令就把工作副本和仓库中指定的修订号作对比:</para>
+          命令就把工作副本和仓库中指定的版本号作对比:</para>
 
         <informalexample>
           <screen>
@@ -3359,7 +3361,7 @@
       <!--
         <title>Comparing repository revisions</title>
       -->
-        <title>比较仓库的修订号</title>
+        <title>比较仓库的版本号</title>
 
       <!--
         <para>If two revision numbers, separated by a colon, are
@@ -3368,7 +3370,7 @@
           compared:</para>
       -->
         <para>如果用选项 <option>--revision</option> (<option>-r</option>)
-          传递了一对用冒号隔开的修订号, 命令就会比较这两个修改号的差异.</para>
+          传递了一对用冒号隔开的版本号, 命令就会比较这两个版本号的差异.</para>
 
         <informalexample>
           <screen>
@@ -3392,7 +3394,7 @@
           previous revision is to use the <option>- -change</option>
           (<option>-c</option>) option:</para>
       -->
-        <para>如果要比较某个修订号与前一个修订号, 比较方便的做法是用选项
+        <para>如果要比较某个版本号与前一个版本号, 比较方便的做法是用选项
           <option>--change</option> (<option>-c</option>):</para>
 
         <informalexample>
@@ -3418,7 +3420,7 @@
           including the appropriate URL on the command line:</para>
       -->
         <para>最后, 即使本地机器上没有工作副本, <command>svn diff</command>
-          也可以比较仓库的修订号, 方法是在命令行中指定 URL:</para>
+          也可以比较仓库的版本号, 方法是在命令行中指定 URL:</para>
 
         <informalexample>
           <screen>
@@ -3449,7 +3451,7 @@
         the commit:</para>
       -->
       <para>为了查看某个文件或目录的历史修改信息, 使用命令
-        <command>svn log</command>, 它显示的信息包括提交修改的作者, 修订号,
+        <command>svn log</command>, 它显示的信息包括提交修改的作者, 版本号,
         时间和日期, 以及日志消息 (如果有的话):</para>
 
       <informalexample>
@@ -3480,7 +3482,7 @@
         option:</para>
       -->
       <para>注意, <command>svn log</command> 默认按照时间逆序来打印消息,
-        如果用户只想查看某段范围内的日志, 或者是单个修订号的日志, 又或者是想
+        如果用户只想查看某段范围内的日志, 或者是单个版本号的日志, 又或者是想
         改变打印顺序, 就带上选项 <option>--revision</option>
         (<option>-r</option>):</para>
 
@@ -3507,7 +3509,7 @@
               <entry>Display logs for revisions 5 through 19 in
                 chronological order</entry>
       -->
-              <entry>按照时间顺序打印从修订号 5 到 19 的日志</entry>
+              <entry>按照时间顺序打印从版本号 5 到 19 的日志</entry>
             </row>
             <row>
               <entry><userinput>svn log -r 19:5</userinput></entry>
@@ -3515,7 +3517,7 @@
               <entry>Display logs for revisions 5 through 19 in
                 reverse chronological order</entry>
       -->
-              <entry>按照时间逆序打印从修订号 5 到 19 的日志</entry>
+              <entry>按照时间逆序打印从版本号 5 到 19 的日志</entry>
             </row>
             <row>
               <entry><userinput>svn log -r 8</userinput></entry>
@@ -3522,7 +3524,7 @@
       <!--
               <entry>Display logs for revision 8 only</entry>
       -->
-              <entry>显示修订号 8 的日志</entry>
+              <entry>显示版本号 8 的日志</entry>
             </row>
           </tbody>
         </tgroup>
@@ -3548,7 +3550,7 @@
         for those revisions in which the named file (or directory)
         changed.</para>
       -->
-      <para>上面的命令只会显示和 <filename>foo.c</filename> 相关的修订号的
+      <para>上面的命令只会显示和 <filename>foo.c</filename> 相关的版本号的
         日志.</para>
 
       <sidebar>
@@ -3583,14 +3585,14 @@
           用户就会发现输出的日志消息中没有包含最近的几次提交, 这种情况是由
           <command>svn commit</command> 和 <command>svn log</command> 的
           共同作用的结果. 首先, 用户向仓库提交修改时, <command>svn</command>
-          只更新了被提交的文件和目录的修订号, 所以父目录依然是
-          较旧的修订号 (原因见
+          只更新了被提交的文件和目录的版本号, 所以父目录依然是
+          较旧的版本号 (原因见
           <xref linkend="svn.basic.in-action.mixedrevs.update-commit"/>),
-          <command>svn log</command> 默认从目录的当前修订号开始获取历史消息,
+          <command>svn log</command> 默认从目录的当前版本号开始获取历史消息,
           所以用户就看不到刚提交的日志. 解决办法是用
           <command>svn update</command> 更新工作副本, 或通过选项
           <option>--revision</option> (<option>-r</option>) 显式地向
-          <command>svn log</command> 传递一个修订号.</para>
+          <command>svn log</command> 传递一个版本号.</para>
 
       </sidebar>
 
@@ -3674,13 +3676,13 @@
           the topmost URL of your repository, as in <userinput>svn log
           -r 2 ^/</userinput>.</para>
       -->
-      <para>乍看起来好像是 Subversion 出错了, 但是别忘了修订号是整个
+      <para>乍看起来好像是 Subversion 出错了, 但是别忘了版本号是整个
         仓库统一进行编号. <command>svn log</command> 针对仓库中的文件
-        路径进行操作, 如果用户在执行命令时没有提交路径参数,
+        路径进行操作, 如果用户在执行命令时没有提供路径参数,
         <command>svn log</command> 就把当前工作副本作为默认目标. 于是,
-        如果用户上在某个工作副本目录中查看某个修订号的日志, 而在这个修订
+        如果用户上在某个工作副本目录中查看某个版本号的日志, 而在这个版本
         号中, 当前工作目录及其子目录与子目录都没有被修改, 所以 Subversion
-        什么都没打印. 如果确实想看该修订号的日志, 就把仓库的顶层 URL 作为
+        什么都没打印. 如果确实想看该版本号的日志, 就把仓库的顶层 URL 作为
         参数传递给 <command>svn log</command>, 例如
         <userinput>svn log -r 2 ^/</userinput>.</para>
 
@@ -3717,7 +3719,7 @@
       <para>从 Subversion 1.8 开始, <command>svn log</command> 支持选项
         <option>--search</option> 和 <option>--search-and</option>. 这两个
         选项允许用户指定搜索模式字符串, 从而过滤 <command>svn log</command>
-        的输出: 只有当修订号的作者, 日期, 日志消息或被修改的文件路径与搜索
+        的输出: 只有当版本号的作者, 日期, 日志消息或被修改的文件路径与搜索
         模式匹配时, 才会输出该日志.</para>
 
     </sect2>
@@ -3737,7 +3739,7 @@
         use either one.</para>
       -->
       <para>利用 <command>svn cat</command> 和 <command>svn list</command>,
-        用户可以查看任意一个修订号下的文件和目录, 而无须修改工作副本, 实际上,
+        用户可以查看任意一个版本号下的文件和目录, 而无须修改工作副本, 实际上,
         在使用这两个命令时甚至都不需要工作副本.</para>
 
       <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
@@ -3801,7 +3803,7 @@
         <para>和 <command>svn cat</command> 比较类似的命令是
           <command>svn annotate</command> 有点类似, 但是 <command>svn annotate
           </command> 的输出更丰富—除了文件的内容外, 还会输出每一行
-          最后一次被修改时的作者, 修订号及其日期 (可选).</para>
+          最后一次被修改时的作者, 版本号及其日期 (可选).</para>
 
       <!--
         <para>When used with a working copy file target, <command>svn
@@ -3836,7 +3838,7 @@
       -->
         <para>在上面的例子里, 某些行的属性没有打印出来, 原因是这几行在工作
           副本中被修改了. 利用这个特点, 我们也可以通过 <command>svn annotate
-          </command> 判断出文件的哪些行被修改了. 用户可以用修订号关键词
+          </command> 判断出文件的哪些行被修改了. 用户可以用版本号关键词
           <literal>BASE</literal> (见 <xref linkend="svn.tour.revs.keywords"/>)
           查看文件的未修改版本的输出:</para>
 
@@ -3858,7 +3860,7 @@
           line of ouput, so we'll skip the demonstration here.)</para>
       -->
         <para>选项 <option>--verbose</option> (<option>-v</option>) 使得
-          <command>svn annotate</command> 在输出中增加每一行的修订号的
+          <command>svn annotate</command> 在输出中增加每一行的版本号的
           提交日期 (这会显著增加输出内容的宽度, 所以我们不在这里展示添加
           了选项 <option>--verbose</option> 后的运行效果).</para>
 
@@ -3872,7 +3874,7 @@
       -->
         <para>和 <command>svn cat</command> 一样, <command>svn annotate
           </command> 也能针对文件的早先版本进行操作, 这个功能有时候会很有
-          帮助—如果用户已经找到了文件中某一行的最后一次修改的修订号,
+          帮助—如果用户已经找到了文件中某一行的最后一次修改的版本号,
           他可能还想知道在此之前是谁最后一次修改了这一行:</para>
 
         <informalexample>
@@ -3949,7 +3951,7 @@
           <para>根据执行命令时的心情, 用户可能不会使用标准形式
             (<command>svn annotate</command>), 转而使用 <command>svn blame
             </command> 或 <command>svn praise</command>, 后面两种形式是
-            标准形式的别名, 它们在本质上是完全等价的.</para>
+            标准形式的别名, 它们是完全等价的.</para>
         </tip>
 
       <!--
@@ -3990,9 +3992,11 @@
 </screen>
         </informalexample>
 
+    <!--
         <para>If you want a more detailed listing, pass the
-          <option>--verbose</option> (<option>-v</option>) flag to get
+          <option>- -verbose</option> (<option>-v</option>) flag to get
           output like this:</para>
+    -->
         <para>如果想得到更详细的信息, 添加选项 <option>--verbose</option>
           (<option>-v</option>):</para>
 
@@ -4013,7 +4017,7 @@
           if it is a file, the date it was last modified, and the item's
           name.</para>
       -->
-        <para>从左到右分别表示文件或目录最后一次被修改时的修订号, 作者,
+        <para>从左到右分别表示文件或目录最后一次被修改时的版本号, 作者,
           文件大小 (仅针对文件), 日期以及文件或目录的名字.</para>
 
         <warning>
@@ -4080,7 +4084,7 @@
         <para>许多 Subversion 新手会尝试利用上面的
           <command>svn update</command>
           例子来 <quote>撤消</quote> (undo) 已经提交的修改, 但是这不可能
-          实现, 因为如果被修改的文件的修订号比较旧, 那就无法成功提交.
+          实现, 因为如果被修改的文件的版本号比较旧, 那就无法成功提交.
           关于如何 <quote>撤消</quote> 提交请参考
           <xref linkend="svn.branchmerge.basicmerging.resurrect"/></para>
       </tip>
@@ -4101,7 +4105,7 @@
         <command>svn update</command>, 可以给它添加一个选项
         <option>--revision</option> (<option>-r</option>). 由于
         <xref linkend="svn.advanced.pegrevs"/> 介绍的原因, 用户可能想
-        把目标修订号作为 Subversion 扩展 URL 语法的一部分.</para>
+        把目标版本号作为 Subversion 扩展 URL 语法的一部分.</para>
 
       <informalexample>
         <screen>
@@ -4379,7 +4383,7 @@
           unversioned file in the working copy.</para></listitem>
     -->
       <listitem><para>删除重命名前的文件, 如果文件在本地被修改了, 就保留在
-          磁盘上, 但不再是版本库的一部分.</para></listitem>
+          磁盘上, 但不再是仓库或工作副本的一部分.</para></listitem>
 
     <!--
         <listitem><para>Add the file, as it exists in the repository,
@@ -4454,7 +4458,7 @@
         changes, some of which also involve modifications
         to <filename>bar.c</filename>:</para>
     -->
-      <para>后来, 在修订号 14, 你的同事 Harry 把 <filename>bar.c</filename>
+      <para>后来, 在版本号 14, 你的同事 Harry 把 <filename>bar.c</filename>
         重命名为 <filename>baz.c</filename>, 但是你并不知情. 此时你正忙于
         编写另外一套修改, 其中就牵涉到 <filename>bar.c</filename>:</para>
 
@@ -4619,7 +4623,7 @@
         <emphasis>左边</emphasis> (<emphasis>left</emphasis>) 的 URL 显示了
         冲突的本地端来源, <emphasis>右边</emphasis>
         (<emphasis>right</emphasis>) 的 URL 显示了冲突的服务器端来源, 这些
-        URL 指出了我们应该从哪个修订号开始搜索导致冲突的修改.</para>
+        URL 指出了我们应该从哪个版本号开始搜索导致冲突的修改.</para>
 
       <informalexample>
         <screen>




More information about the svnbook-dev mailing list