[svnbook] r5381 committed - branches/1.8/zh/book/ch03-advanced-topics.xml

[wuzhouhui at users.sourceforge.net]

Revision: 5381
          http://sourceforge.net/p/svnbook/source/5381
Author:   wuzhouhui
Date:     2017-07-31 13:27:10 +0000 (Mon, 31 Jul 2017)
Log Message:
-----------
Branch 1.8/zh: translation of chapter 3 in progress

Modified Paths:
--------------
    branches/1.8/zh/book/ch03-advanced-topics.xml

Modified: branches/1.8/zh/book/ch03-advanced-topics.xml
===================================================================
--- branches/1.8/zh/book/ch03-advanced-topics.xml	2017-07-30 06:10:55 UTC (rev 5380)
+++ branches/1.8/zh/book/ch03-advanced-topics.xml	2017-07-31 13:27:10 UTC (rev 5381)
@@ -4004,6 +4004,7 @@
 
     </sidebar>
 
+    <!--
     <para>When found on a versioned directory, the
       <literal>svn:ignore</literal> property is expected to contain a
       list of newline-delimited file patterns that Subversion should
@@ -4023,7 +4024,20 @@
       book—the HTML, PDF, or PostScript files generated as the
       result of a conversion of some source DocBook XML files to a
       more legible output format.</para>
+    -->
+    <para>如果被版本控制的目录上设置了属性 <literal>svn:ignore</literal>,
+      属性值应该是一个文件名模式列表, 各项之间用换行符分开, Subversion 根据
+      文件名模式列表判断 <emphasis>相同</emphasis> 目录内的哪些文件是可以忽略
+      的. 属性 <literal>svn:ignore</literal> 不会覆盖运行时配置选项 <literal>
+        global-ignores</literal> 的值, 而是作为一种补充. 与 <literal>
+        global-ignores</literal> 不同的是, 属性 <literal>svn:ignore</literal>
+      里的模式只能作用在该属性所在的目录上, 不会递归作用到子目录上. 属性
+      <literal>svn:ignore</literal> 的一个常用目的是告诉 Subversion 去忽略每个
+      用户的工作副本中可能都会有的文件, 例如编译器的输出文件—对于本书而
+      言, 就是 HTML, PDF, PostScript 文件, 或其他 DocBook XML 转换过程中产生
+      的临时文件和输出文件.</para>
 
+    <!--
     <para>Subversion 1.8 provides a more powerful version of the
       <literal>svn:ignore</literal> property, the
       <literal>svn:global-ignores</literal> property.  Like the
@@ -4047,6 +4061,23 @@
       and applies to <emphasis>all</emphasis> paths under the directory on
       which the property is set, not just the immediate children of the
       directory.</para>
+    -->
+    <para>Subversion 1.8 提供了一个比 <literal>svn:ignore</literal> 更强大的
+      属性—<literal>svn:global-ignores</literal>. 和 <literal>
+        svn:ignore</literal> 相同的是, <literal>svn:global-ignores</literal>
+      只能设置到目录上, 属性值是文件名模式集合.<footnote><para><literal>
+            svn:global-ignores</literal> 的各个文件名模式之间可能用空白符
+          分隔 (就像运行时配置选项 <literal>global-ignores</literal>), 而不仅
+          仅是换行符 (属性 <literal>svn:ignore</literal> 的各个文件名模式之间
+          只能用换行符分隔).</para></footnote> <literal>svn:global-ignores
+        </literal> 定义的文件名模式会添加到运行时配置选项
+        <literal>global-ignores</literal> 与 属性 <literal>svn:ignore</literal>
+        定义的模式上. 与 <literal>svn:ignore</literal> 不同的是, <literal>
+          svn:global-ignores</literal> 是可继承的 <footnote><para>当然, 只
+            有 1.8 或更新版本的 Subversion 客户端才能认识
+            <literal>svn:global-ignores</literal> 的意义与可继承性</para>
+        </footnote>, 它会递归地作用到目录内的 <emphasis>所有</emphasis> 路径上,
+        而不仅仅是目录的直接子文件.</para>
 
     <note>
       <para>Subversion's support for ignorable file patterns extends