[svnbook commit] r1812 - trunk/src/zh/book

leasun svnbook-dev at red-bean.com
Tue Nov 8 07:50:03 CST 2005


Author: leasun
Date: Tue Nov  8 07:50:01 2005
New Revision: 1812

Modified:
   trunk/src/zh/book/ch07.xml
Log:
* zh/book/ch07.xml: made a little adjusts.


Modified: trunk/src/zh/book/ch07.xml
==============================================================================
--- trunk/src/zh/book/ch07.xml	(original)
+++ trunk/src/zh/book/ch07.xml	Tue Nov  8 07:50:01 2005
@@ -129,12 +129,12 @@
     <sect2 id="svn-ch-7-sect-1.3">
       <title>配置选项</title>
       
-      <para>在本小节,我们会详细讨论Subversion目前支持的运行配置选项。</para>
+      <para>本节我们会详细讨论Subversion目前支持的运行配置选项。</para>
 
       <sect3 id="svn-ch-7-sect-1.3.1">
         <title>服务器</title>
 
-        <para><filename>servers</filename>文件保存了Subversion关于网络层的配置选项,这个文件有两个特别的小节—<literal>groups</literal> 和<literal>global</literal>,<literal>groups</literal>小节是一个交叉引用表,这个小节的关键字是这个文件其它的小节的名称;它们的值是一个组合—文本符号有可能包含通配符字符—对应Subversion请求发送的到的主机名。</para>
+        <para><filename>servers</filename>文件保存了Subversion关于网络层的配置选项,这个文件有两个特别的小节:<literal>groups</literal> 和<literal>global</literal>。<literal>groups</literal>小节是一个交叉引用表,其中的关键字是<filename>servers</filename>文件中其它小节的名字,值则是一个可以包含通配符的字符序列,对应于接收Subversion请求的主机名,称为glob。</para>
 
         <programlisting>
 [groups]
@@ -148,57 +148,57 @@
 …
 </programlisting>
 
-        <para>当Subversion是通过网络使用的,它会设法用正在尝试连接的服务器的名字和<literal>groups</literal>小节的组名称匹配,如果发现匹配,Subversion会在<filename>servers</filename>文件的查找匹配这个group名称的小节,在那个小节它会去读取真实的网络配置设置。</para>
+        <para>当通过网络访问Subversion服务器时,客户端会设法匹配正在尝试连接的服务器名字和<literal>groups</literal>小节中的glob名称,如果发现匹配,Subversion会在<filename>servers</filename>文件中查找对应于这个glob名称的小节,并从该小节中去读取真实的网络配置设置。</para>
 
-        <para><literal>global</literal>小节保存了没有<literal>groups</literal>小节匹配时的设置,这个小节存在的选项与其他服务器一样(当然是除了<literal>groups</literal>小节),是以下这些:</para>
+        <para>如果没有能够匹配到<literal>groups</literal>中的glob名称,<literal>global</literal>小节中的选项就会发生作用。<literal>global</literal>小节中的选项与其他小节一样(当然是除了<literal>groups</literal>小节),这些选项是:</para>
 
         <variablelist>
           <varlistentry>
             <term><literal>http-proxy-host</literal></term>
             <listitem>
-              <para>代理服务器的详细主机名,是HTTP为基础的Subversion请求必须通过的,缺省值是空的,意味着Subversion不会去尝试通过代理服务器进行HTTP请求,而会直接尝试去连接目标机器。</para>
+              <para>代理服务器的详细主机名,是HTTP为基础的Subversion请求必须通过的,缺省值为空,意味着Subversion不会尝试通过代理服务器进行HTTP请求,而会尝试直接连接目标机器。</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>http-proxy-port</literal></term>
             <listitem>
-              <para>代理服务器的详细端口,缺省值是空。</para>
+              <para>代理服务器的详细端口,缺省值为空。</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>http-proxy-username</literal></term>
             <listitem>
-              <para>代理服务器的用户名,缺省值是空。</para>
+              <para>代理服务器的用户名,缺省值为空。</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>http-proxy-password</literal></term>
             <listitem>
-              <para>代理服务器使用的密码,缺省是空。</para>
+              <para>代理服务器的密码,缺省为空。</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>http-timeout</literal></term>
             <listitem>
-              <para>等待服务器响应的时间,以秒为单位,如果你经历到过慢的网络速度,导致Subversion的操作超时,你可以增加这个值,缺省值是<literal>0</literal>会告诉HTTP库Neon使用自己的缺省值。</para>
+              <para>等待服务器响应的时间,以秒为单位,如果你的网络速度较慢,导致Subversion的操作超时,你可以加大这个数值,缺省值是<literal>0</literal>,意思是让HTTP库Neon使用自己的缺省值。</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>http-compression</literal></term>
             <listitem>
-              <para>这说明是否在与设置好DAV的服务器通讯时使用网络压缩请求,缺省值是<literal>yes</literal>(尽管只有在这个能力编译到网络层时压缩才会有效),设置<literal>no</literal>来关闭压缩,如调试网络传输时。</para>
+              <para>这说明是否在与设置好DAV的服务器通讯时使用网络压缩请求,缺省值是<literal>yes</literal>(尽管只有在这个功能编译到网络层时压缩才会有效),设置<literal>no</literal>来关闭压缩,如调试网络传输时。</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>neon-debug-mask</literal></term>
             <listitem>
-              <para>只是一个整形的掩码,底层的HTTP库Neon用来选择产生调试的输出,缺省值是<literal>0</literal>,关闭所有的调试输出,关于Subversion使用Neon的详细信息,见<xref linkend="svn-ch-8" />。</para>
+              <para>只是一个整形的掩码,底层的HTTP库Neon用来选择产生调试的输出,缺省值是<literal>0</literal>,意思是关闭所有的调试输出,关于Subversion使用Neon的详细信息,见<xref linkend="svn-ch-8" />。</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>ssl-authority-files</literal></term>
             <listitem>
-              <para>这是一个分号分割的路径和文件列表,这些文件包含了Subversion客户端在用HTTPS访问时可以接受的认证授权(或者CA)的证书。</para>
+              <para>这是一个分号分割的路径和文件列表,这些文件包含了Subversion客户端在用HTTPS访问时可以接受的认证授权(或者CA)证书。</para>
             </listitem>
           </varlistentry>
           <varlistentry>
@@ -210,13 +210,13 @@
           <varlistentry>
             <term><literal>ssl-client-cert-file</literal></term>
             <listitem>
-              <para>如果一个主机(或是一些主机)需要一个SSL客户端证书,你会收到一个提示说需要证书的路径。通过设置这个路径你的Subversion客户端可以自动找到你的证书而不会打扰你。没有标准的存放位置;Subversion会从任何你指定得只得到这个文件。</para>
+              <para>如果一个主机(或是一些主机)需要一个SSL客户端证书,你会收到一个提示说需要证书的路径。通过设置这个路径你的Subversion客户端可以自动找到你的证书而不会打扰你。没有标准的存放位置;Subversion会从任何你指定的路径得到这个文件。</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>ssl-client-cert-password</literal></term>
             <listitem>
-              <para>如果你的SSL客户端证书文件是用密码加密的,Subversion会在每次使用证书时请你输入密码,如果你发现这很讨厌(并且不介意把密码存放在<filename>servers</filename>文件),你可以设置这个参数为证书的密码,你不会再收到密码输入提示了。</para>
+              <para>如果你的SSL客户端证书文件是用密码加密的,Subversion会在每次使用证书时请你输入密码,如果你发现这很讨厌(并且不介意把密码存放在<filename>servers</filename>文件中),你可以设置这个参数为证书的密码,这样就不会再收到密码输入提示了。</para>
             </listitem>
           </varlistentry>
         </variablelist>
@@ -225,7 +225,7 @@
       <sect3 id="svn-ch-7-sect-1.3.2">
         <title>config</title>
 
-        <para><filename>config</filename>文件保存了剩下的当前存在的Subversion运行选项,这些与网络连接无关,这些只是一些现在使用的选项,但是为了将来期望的增加也是分组为小节。</para>
+        <para>其它的Subversion运行选项保存在<filename>config</filename>文件中,这些运行选项与网络连接无关,只是一些正在使用的选项,但是为了应对未来的扩展,也按小节划分成组。</para>
 
         <para><literal>auth</literal>小节保存了Subversion相关的认证和授权的设置,它包括:</para>
 
@@ -233,7 +233,7 @@
           <varlistentry>
             <term><literal>store-passwords</literal></term>
             <listitem>
-              <para>这告诉Subversion是否缓存服务器认证要求时用户需要提供的密码,缺省值是<literal>yes</literal>。设置为<literal>no</literal>可以关闭在存盘的密码缓存,你可以通过<command>svn</command>的<option>--no-auth-cache</option>命令行参数(那些支持这个的字命令)来覆盖这个设置,,详细信息请见<xref
+              <para>这告诉Subversion是否缓存服务器认证要求时用户提供的密码,缺省值是<literal>yes</literal>。设置为<literal>no</literal>可以关闭在存盘的密码缓存,你可以通过<command>svn</command>的<option>--no-auth-cache</option>命令行参数(那些支持这个参数的子命令)来覆盖这个设置,详细信息请见<xref
                 linkend="svn-ch-6-sect-2.2"/>。
               </para>
             </listitem>
@@ -241,7 +241,7 @@
           <varlistentry>
             <term><literal>store-auth-creds</literal></term>
             <listitem>
-              <para>这个设置与<literal>store-passwords</literal>相似,除了是否开启和关闭<emphasis>所有</emphasis>认证信息:用户名、密码、服务器证书和其他任何类型的可以缓存的凭证。</para>
+              <para>这个设置与<literal>store-passwords</literal>相似,不过设置了这个选项将会保存<emphasis>所有</emphasis>认证信息,如用户名、密码、服务器证书,以及其他任何类型的可以缓存的凭证。</para>
             </listitem>
           </varlistentry>
         </variablelist>
@@ -252,23 +252,20 @@
           <varlistentry>
             <term><literal>editor-cmd</literal></term>
             <listitem>
-              <para>Subversion在提交操作时用来询问用户日志信息的程序,例如使用<command>svn
-                commit</command>而没有指定<option>--message</option>(<option>-m</option>)或者<option>--file</option>(<option>-F</option>)选项。这个程序也会与<command>svn
-                propedit</command>一起使用—一个临时文件跳出来包含已经存在的用户希望编辑的属性,这个编辑只发生在编辑器程序(见<xref
-                linkend="svn-ch-7-sect-2" />),这个选项的缺省值是空,如果这个选项没有设置,Subversion会回头检查环境变量<literal>SVN_EDITOR</literal>、<literal>VISUAL</literal>和<literal>EDITOR</literal>(这个顺序)来找到一个编辑器命令。</para>
+              <para>Subversion在提交操作时用来询问用户日志信息的程序,例如使用<command>svn commit</command>而没有指定<option>--message</option>(<option>-m</option>)或者<option>--file</option>(<option>-F</option>)选项。这个程序也会与<command>svn propedit</command>一起使用—一个临时文件跳出来包含已经存在的用户希望编辑的属性,然后用户可以对这个属性进行编辑(见<xref linkend="svn-ch-7-sect-2" />),这个选项的缺省值为空,如果这个选项没有设置,Subversion会依次检查环境变量<literal>SVN_EDITOR</literal>、<literal>VISUAL</literal>和<literal>EDITOR</literal>(这个顺序)来找到一个编辑器命令。</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>diff-cmd</literal></term>
             <listitem>
-              <para>这个命令是区别程序的绝对路径,当Subversion生成了<quote>diff</quote>输出时(例如当使用<command>svn diff</command>命令)就会使用,缺省Subversion会使用一个内置的区别库—设置这个参数会导致它会使用外部程序执行这个任务。
+              <para>这个命令是比较程序的绝对路径,当Subversion生成了<quote>diff</quote>输出时(例如当使用<command>svn diff</command>命令)就会使用,缺省Subversion会使用一个内置的比较库—设置这个参数会强制它使用外部程序执行这个任务。
               </para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>diff3-cmd</literal></term>
             <listitem>
-              <para>这指定了一个三向的区别程序,Subversion使用这个程序来合并用户和从版本库接受的修改,缺省Subversion会使用一个内置的区别库—设置这个参数会导致它会使用外部程序执行这个任务。
+              <para>这指定了一个三向的比较程序,Subversion使用这个程序来合并用户和从版本库接受的修改,缺省Subversion会使用一个内置的比较库—设置这个参数会导致它会使用外部程序执行这个任务。
               </para>
             </listitem>
           </varlistentry>
@@ -280,12 +277,11 @@
           </varlistentry>
         </variablelist>
 
-        <para><literal>tunnels</literal>小节允许你定义一个<command>svnserve</command>和<literal>svn://</literal>客户端连接使用的管道模式,更多细节见<xref
-          linkend="svn-ch-6-sect-3.4"/>。</para>
+        <para><literal>tunnels</literal>小节允许你定义一个<command>svnserve</command>和<literal>svn://</literal>客户端连接使用的管道模式,更多细节见<xref linkend="svn-ch-6-sect-3.4"/>。</para>
 
-        <para><literal>miscellany</literal>小节是一些没法归到别处的选项,***
+        <para><literal>miscellany</literal>小节是一些没法归到别处的选项。
           <footnote>
-            <para>任何人为了一顿家常便饭?</para> 
+            <para>有人来吃晚饭吗?</para> 
           </footnote>
           在本小节,你会找到:</para>
 
@@ -293,38 +289,32 @@
           <varlistentry>
             <term><literal>global-ignores</literal></term>
             <listitem>
-              <para>当运行<command>svn status</command>命令时,Subversion会和版本化的文件一样列出未版本化的文件和目录,使用<literal>?</literal>字符(见see <xref
-                linkend="svn-ch-3-sect-5.3.1" />)标记,有时候察看不关心的为版本化的文件会很讨厌—举个例子,程序编译产生的对象文件—会显示。<literal>global-ignores</literal>选项是一个空格分隔的列表,用来描述Subversion在它们版本化之前不想现实的文件和目录,缺省值是<literal>*.o *.lo *.la #*# .*.rej *.rej .*~ *~
-                .#* .DS_Store</literal>。</para>
+              <para>当运行<command>svn status</command>命令时,Subversion会和版本化的文件一样列出未版本化的文件和目录,并使用<literal>?</literal>字符(见see <xref linkend="svn-ch-3-sect-5.3.1" />)标记,有时候察看无关的未版本化文件会很讨厌—比如程序编译产生的对象文件—的显示出来。<literal>global-ignores</literal>选项是一个空格分隔的列表,用来描述Subversion在它们版本化之前不想显示的文件和目录,缺省值是<literal>*.o *.lo *.la #*# .*.rej *.rej .*~ *~ .#* .DS_Store</literal>。</para>
 
-              <para>就像<command>svn status</command>,<command>svn add</command>和<command>svn import</command>命令也会忽略匹配这个列表的文件,你可以用单个的<option>--no-ignore</option>命令行参数来覆盖这个选项,关于更加细致的控制忽略的项目,见<xref linkend="svn-ch-7-sect-2.3.3"
-                />。</para>
+              <para>就像<command>svn status</command>,<command>svn add</command>和<command>svn import</command>命令也会忽略匹配这个列表的文件,你可以用单个的<option>--no-ignore</option>命令行参数来覆盖这个选项,关于更加细致的控制忽略的项目,见<xref linkend="svn-ch-7-sect-2.3.3"/>。</para>
             </listitem>
           </varlistentry>
           
           <varlistentry>
             <term><literal>enable-auto-props</literal></term>
             <listitem>
-              <para>这里指示Subversion自动对新加的或者导入的文件设置属性,缺省值是<literal>no</literal>,所以设置为<literal>yes</literal>来开启自动添加属性,这个文件的<literal>auto-props</literal>小节会说明那些属性设置到那些文件。</para>
+              <para>这里指示Subversion自动对新加的或者导入的文件设置属性,缺省值是<literal>no</literal>,可以设置为<literal>yes</literal>来开启自动添加属性,这个文件的<literal>auto-props</literal>小节会说明哪些属性会被设置到哪些文件。</para>
             </listitem>            
           </varlistentry>
 
           <varlistentry>
             <term><literal>log-encoding</literal></term>
-            <listitem>         
+            <listitem>
               <para>这个变量设置提交日志缺省的字符集,是<option>--encoding</option>选项(见<xref linkend="svn-ch-9-sect-1.1"/>)的永久形式,Subversion版本库保存了一些UTF8的日志信息,并且假定你的日志信息是用操作系统的本地编码,如果你提交的信息使用别的编码方式,你一定要指定不同的编码。</para>
             </listitem>
           </varlistentry>
 
           <varlistentry>
             <term><literal>use-commit-times</literal></term>
-            <listitem>         
-              <para>通常你的工作拷贝文件会有最后一次被进程访问的时间戳,不管是你自己的编辑器还是用<command>svn</command>子命令。这通常是对人们开发软件很方便,因为编译系统通常会通过察看时间戳来决定那些文件需要重新编译。</para>
+            <listitem>
+              <para>通常你的工作拷贝文件会有最后一次被进程访问的时间戳,不管是你自己的编辑器还是用<command>svn</command>子命令。这通常对人们开发软件提供了便利,因为编译系统通常会通过查看时间戳来决定那些文件需要重新编译。</para>
 
-              <para>在其他情形,有时候如果工作拷贝的文件德时间戳反映了上一次在版本库中更改的时间会非常好,<command>svn export</command>命令会一直放置这些<quote>上次提交的时间戳</quote>放到它创建的目录树。通过设置config参数为<literal>yes</literal>,<command>svn
-                checkout</command>、<command>svn update</command>、
-                <command>svn switch</command>和<command>svn
-                revert</command>命令也会为他们接触的文件设置上次提交的时间戳。</para>
+              <para>在其他情形,有时候如果工作拷贝的文件时间戳反映了上一次在版本库中更改的时间会非常好,<command>svn export</command>命令会一直放置这些<quote>上次提交的时间戳</quote>放到它创建的目录树。通过设置这个config参数为<literal>yes</literal>,<command>svn checkout</command>、<command>svn update</command>、 <command>svn switch</command>和<command>svn revert</command>命令也会为它们操作的文件设置上次提交的时间戳。</para>
             </listitem>
           </varlistentry>
           
@@ -332,7 +322,7 @@
           registry file, e.g., template-root -->
         </variablelist>
 
-        <para><literal>auto-props</literal>小节控制Subversion客户端自动设置提交和导入的文件的属性的能力,它包含了任何数量的键-值对,格式是<literal>PATTERN = PROPNAME=PROPVALUE</literal>,其中<literal>PATTERN</literal>十一个文件模式,匹配一系列文件名,此行剩下的属性和值。如果一个文件匹配多次,会导致有多个属性集;然而,没有手段保障自动属性不会按照配置文件中的顺序应用,所以你可以一个规则<quote>覆盖</quote>另一个。你可以在<filename>config</filename>文件找到许多自动属性的用法实例。最后,如果你希望开启自动属性,不要忘了设置<literal>miscellany</literal>小节的<literal>enable-auto-props</literal>为<literal>yes</literal>。</para>
+        <para><literal>auto-props</literal>小节控制Subversion客户端自动设置提交和导入的文件的属性的能力,它可以包含任意数量的键-值对,格式是<literal>PATTERN = PROPNAME=PROPVALUE</literal>,其中<literal>PATTERN</literal>是一个文件模式,匹配一系列文件名,此行其它两项为属性和值。如果一个文件匹配多次,会导致有多个属性集;然而,没有手段保障自动属性不会按照配置文件中的顺序应用,所以你可以一个规则<quote>覆盖</quote>另一个。你可以在<filename>config</filename>文件找到许多自动属性的用法实例。最后,如果你希望开启自动属性,不要忘了设置<literal>miscellany</literal>小节的<literal>enable-auto-props</literal>为<literal>yes</literal>。</para>
 
       </sect3>
 
@@ -345,17 +335,17 @@
   <sect1 id="svn-ch-7-sect-2">
     <title>属性</title>
 
-    <para>我们已经覆盖了Subversion存储和检索版本库中不同版本的文件和目录的细节,整个章节来论述这个工具的基本功能,如果版本支持到此为止,Subversion还只是一个普通的版本控制观点,但是还没有结束。</para>
+    <para>我们已经详细讲述了Subversion存储和检索版本库中不同版本的文件和目录的细节,并且用了好几个章节来论述这个工具的基本功能。到此为止,Subversion还仅仅表现出一个普通的版本控制理念。但是Subversion并没有就此止步。</para>
 
-    <para>作为目录和文件版本化的补充,Subversion提供了对每一个版本化的目录和文件添加、修改和删除版本化的元数据的接口,我们用<firstterm>properties</firstterm>来表示这些元数据,我们可以认为他们是一个两列的表,附加到你的工作拷贝每个条目上,影射属性名到任意的值。一般来说,属性的名称和值可以是你希望的任何值,限制就是名称必须是可读的文本,并且最好的一点是这些属性也是版本化的,就像你的文本内容文件,你可以像提交文本修改一样修改、提交和恢复属性修改,当你的更新时也会接收到别人的属性修改。</para>
+    <para>作为目录和文件版本化的补充,Subversion提供了对每一个版本化的目录和文件添加、修改和删除版本化的元数据的接口,我们用<firstterm>属性</firstterm>来表示这些元数据。我们可以认为他们是一个两列的表,附加到你的工作拷贝每个条目上,映射属性名到任意的值。一般来说,属性的名称和值可以是你希望的任何值,限制就是名称必须是可读的文本,并且最好的一点是这些属性也是版本化的,就像你的文本内容文件,你可以像提交文本修改一样修改、提交和恢复属性修改,当你更新时也会接收到别人的属性修改。</para>
 
     <sidebar>
       <title>Subversion的其他属性</title>
 
-      <para>Subversion也会在别的地方露面,就像文件和目录可能附加有任意的属性名和值,每个修订版本作为一个整体也可以附加任意的属性,也有同样的限制—可读的文本名称和任何你希望的,***二进制值—除了修订版本不是版本化的,见<xref linkend="svn-ch-5-sect-1.2" />来察看为版本化的属性信息。</para>
+      <para>Subversion的属性也可以在别的地方出现,就像文件和目录可能附加有任意的属性名和值,每个修订版本作为一个整体也可以附加任意的属性,也有同样的限制—可读的文本名称和任何你希望的,二进制值—除了修订版本不是版本化的,参见<xref linkend="svn-ch-5-sect-1.2" />获得版本化的属性信息。</para>
     </sidebar>
 
-    <para>在本小节,我们将会检验这个工具—不仅是对Subversion的用户,也对Subversion本身—关于属性支持。你会学好属性相关的<command>svn</command>子命令,和属性怎样影响你的普通Subversion工作流,很期待你会确信Subversion的属性可以提高你的版本控制体验。</para>
+    <para>在本小节,我们将会检验这个工具—不仅是对Subversion的用户,也对Subversion本身—对于属性的支持。你会学到与属性相关的<command>svn</command>子命令,和属性怎样影响你的普通Subversion工作流,希望你会感到Subversion的属性可以提高你的版本控制体验。</para>
 
     <!-- ***************************************************************** -->
     <sect2 id="svn-ch-7-sect-2.1">



More information about the svnbook-dev mailing list