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

rocksun noreply at red-bean.com
Tue Nov 7 00:20:13 CST 2006


Author: rocksun
Date: Tue Nov  7 00:20:12 2006
New Revision: 2512

Modified:
   trunk/src/zh/book/ch00.xml
   trunk/src/zh/book/ch05.xml
   trunk/src/zh/book/ch07.xml
   trunk/src/zh/book/ch08.xml
   trunk/src/zh/book/ch09.xml

Log:
change some words

Modified: trunk/src/zh/book/ch00.xml
==============================================================================
--- trunk/src/zh/book/ch00.xml	(original)
+++ trunk/src/zh/book/ch00.xml	Tue Nov  7 00:20:12 2006
@@ -8,7 +8,7 @@
         —Brian W. Fitzpatrick</para>
     </blockquote>
 
-    <para>在开源软件世界,并行版本系统(CVS)一直是版本控制长久以来的不二选择。事实证明,这是个正确的选择。CVS本身是自由软件,不加限制的<foreignphrase>处事风格</foreignphrase>,对网络化操作的支持(众多身处不同地方的程序员可以共享他们的工作),都非常符合开源世界的协作精神。CVS和它半混乱状态的开发模型已成为开源文化的基石。</para>
+    <para>在开源软件世界,并行版本系统(CVS)一直是版本控制长久以来的唯一选择。事实证明,这是个正确的选择。CVS本身是自由软件,不加限制的<foreignphrase>处事风格</foreignphrase>,对网络化操作的支持(众多身处不同地方的程序员可以共享他们的工作),都非常符合开源世界的协作精神。CVS和它半混乱状态的开发模型已成为开源文化的基石。</para>
 
 
     <para>但是,和其它许多工具一样,CVS开始显露出衰老的迹象。而Subversion,正是以CVS继任者的面目出现的新型版本控制系统。Subversion的设计者们力图通过两方面的努力赢得CVS用户的青睐:保持构建开源软件版本控制系统的方式(以及视觉和感觉上)与CVS尽可能类似,同时尽力弥补CVS许多显著的缺陷。这些努力的结果使得从CVS迁移到Subversion不需要作出重大的变革,Subversion确实是非常强大、非常有用和非常灵活的工具。</para>

Modified: trunk/src/zh/book/ch05.xml
==============================================================================
--- trunk/src/zh/book/ch05.xml	(original)
+++ trunk/src/zh/book/ch05.xml	Tue Nov  7 00:20:12 2006
@@ -638,7 +638,7 @@
           <varlistentry>
             <term><literal>lock</literal></term>
             <listitem>
-              <para>If a path is locked, describe the lock attributes.</para>
+              <para>如果路径被锁定,则是对锁定属性的描述。</para>
             </listitem>
           </varlistentry>
           
@@ -707,7 +707,7 @@
       <sect3 id="svn.reposadmin.maint.tk.svnadmin">
         <title>svnadmin</title>
 
-        <para><command>svnadmin</command>程序是版本库管理员最好的朋友。除了提供创建Subversion版本库的功能,这个程序使你可以维护这些版本库。<command>svnadmin</command>的语法跟 <command>svnlook</command>类似:</para>
+        <para><command>svnadmin</command>程序是版本库管理员最好的朋友。除了提供创建Subversion版本库的功能,这个程序使你可以维护这些版本库。<command>svnadmin</command>的语法跟<command>svnlook</command>类似:</para>
 
         <screen>
 $ svnadmin help

Modified: trunk/src/zh/book/ch07.xml
==============================================================================
--- trunk/src/zh/book/ch07.xml	(original)
+++ trunk/src/zh/book/ch07.xml	Tue Nov  7 00:20:12 2006
@@ -922,7 +922,7 @@
     <sect2 id="svn.advanced.props.auto">
       <title>自动属性设置</title>
 
-      <para>属性§是Subversion一个强大的特性,成为本章和其它章讨论的许多Subversion特性的关键组成部分—文本区别和合并支持、关键字替换、新行的自动转换等等。但是为了从属性得到完全的利益,他们必须设置到正确的文件和目录。不幸的是,在日常工作中很容易忘记这一步工作,特别是当没有设置属性不会引起明显的错误时(至少相对与未能添加一个文件到版本控制这种操作),为了帮助你在需要添加属性的文件上添加属性,Subversion提供了一些简单但是有用的特性。</para>
+      <para>属性是Subversion一个强大的特性,成为本章和其它章讨论的许多Subversion特性的关键组成部分—文本区别和合并支持、关键字替换、新行的自动转换等等。但是为了从属性得到完全的利益,他们必须设置到正确的文件和目录。不幸的是,在日常工作中很容易忘记这一步工作,特别是当没有设置属性不会引起明显的错误时(至少相对与未能添加一个文件到版本控制这种操作),为了帮助你在需要添加属性的文件上添加属性,Subversion提供了一些简单但是有用的特性。</para>
 
       <para>当你使用<command>svn add</command>或是<command>svn import</command>准备加入一个版本控制的文件时,Subversion会运行一个基本探测来检查文件是包括了可读还是不可读的内容,如果Subversion猜测错误,或者是你希望使用<literal>svn:mime-type</literal>属性更精确的设置—或许是<literal>image/png</literal>或者<literal>application/x-shockwave-flash</literal>—你可以一直删除或编辑那个属性。</para>
 
@@ -1514,7 +1514,7 @@
       <para>你一定要要考虑在所有的外部定义中使用明确的修订版本,这样做意味着你已经决定了何时拖出外部信息不同的快照,和精确的拖出哪个快照。除了不会受到第三方版本库的意外修改的影响以外,当你的工作拷贝回溯到以前的版本库时,使用明确的修订版本号会让外部定义回到以前的那个修订版本,也意味着外部定义的工作拷贝更新会匹配以前修订版本的样子。对于软件项目,这可能是编译复杂代码基的老快照成功和失败的区别。
      </para>
     </tip>
-    <para>Subversion目前对外部定义的支持可能会引起误导,首先,一个外部定义只可以指向目录,而不是文件。第二,外部定义不可以指向相对路径(如<filename>../../skins/myskin</filename>)。第三,同过外部定义创建的工作拷贝与主工作拷贝没有连接,所以举个例子,如果你希望提交一个或多个外部定义的拷贝,你必须在这些工作拷贝显示的运行<command>svn commit</command>—对主工作拷贝的提交不会迭代到外部定义的部分。</para>
+    <para>Subversion目前对外部定义的支持可能会引起误导,首先,一个外部定义只可以指向目录,而不是文件。第二,外部定义不可以指向相对路径(如<filename>../../skins/myskin</filename>)。第三,通过外部定义创建的工作拷贝与主工作拷贝没有连接,所以举个例子,如果你希望提交一个或多个外部定义的拷贝,你必须在这些工作拷贝显示的运行<command>svn commit</command>—对主工作拷贝的提交不会迭代到外部定义的部分。</para>
 
     <para>另外,因为定义本身使用绝对路径,移动和拷贝路径他们附着的路径不会影响他们作为外部的检出(尽管相对的本地目标子目录会这样,当然,根据重命名的目录)。这看起来有些迷惑—甚至让人沮丧—在特定情形。举个例子,如果你在<filename>/trunk</filename>开发线对一个目录使用外部定义,指向同一条线上的其他区域,然后使用<command>svn copy</command>把分支开发线拷贝到<filename>/branches/my-branch</filename>这个新位置,这个项目新分支的外部定义仍然指向<filename>/trunk</filename>版本化资源。另外,需要意识到如果你需要一个重新规划你的工作拷贝的父目录(使用<command>svn switch --relocate</command>),外部定义<emphasis>不</emphasis>会重新选择父目录。</para>
 

Modified: trunk/src/zh/book/ch08.xml
==============================================================================
--- trunk/src/zh/book/ch08.xml	(original)
+++ trunk/src/zh/book/ch08.xml	Tue Nov  7 00:20:12 2006
@@ -39,7 +39,7 @@
           </row>
           <row>
             <entry>libsvn_diff</entry>
-            <entry>Contextual differencing and merging routines</entry>
+            <entry>上下文区别和合并例程</entry>
           </row>
           <row>
             <entry>libsvn_fs</entry>
@@ -146,7 +146,7 @@
       <para>大多数文件系统接口提供的功能作为一个动作发生在一个文件系统路径上,也就是,从文件系统的外部,描述和访问文件和目录独立版本的主要机制是经过如<filename>/foo/bar</filename>的路径,就像你在喜欢的shell程序中定位文件和目录。你通过传递它们的路径到相应的API功能来添加新的文件和目录,查询这些信息也是同样的机制。
      </para>
 
-      <para>不像大多数文件系统,尽管,一个单独的路径不足以在Subversion定位一个文件或目录,可以把目录树看作一个二维的系统,一个节点的兄弟代表了一种从左到右的动作,并且递减到子目录是一个向下的动作,<xref linkend="svn.developer.layerlib.repos.dia-1"/>展示了一个典型的树的形式。
+      <para>然而,不像大多数文件系统,一个单独的路径不足以在Subversion定位一个文件或目录,可以把目录树看作一个二维的系统,一个节点的兄弟代表了一种从左到右的动作,并且递减到子目录是一个向下的动作,<xref linkend="svn.developer.layerlib.repos.dia-1"/>展示了一个典型的树的形式。
      </para>
 
       <figure id="svn.developer.layerlib.repos.dia-1">
@@ -331,7 +331,7 @@
 
         <para>libsvn_ra_dav库是给在不同机器使用<literal>http:</literal>或<literal>https:</literal>协议访问服务器的用户设计的,为了理解这个模块的工作,我们首先要知道这种版本库访问层中的特定配置的关键组成部分—强大的Apache HTTP服务器,和Neon HTTP/WebDAV客户端库。</para>
   
-        <para>Subversion的主要网络服务器是Apache HTTP服务器,Apache是久经考验的用来认真使用的开源服务器,它可以支撑很大的网络压力并且可以运行在多种平台。Apache服务器支持多种认证协议,而且可以通过模块扩展使用其它协议。它也支持流水线和缓存之类的网络优化。通过将Apache作为服务器,Subversion轻易得到这些特性。而且因为许多防火墙已经允许HTTP通过,系统管理员通常不会改变防火墙设置来允许Subversion工作。</para>
+        <para>Subversion的主要网络服务器是Apache HTTP服务器,Apache是久经考验的用来认真使用的开源服务器,它可以支撑很大的网络压力并且可以运行在多种平台。Apache服务器支持多种认证协议,而且可以通过模块扩展使用其它协议。它也支持流水线和缓存之类的网络优化。通过将Apache作为服务器,Subversion轻易得到这些特性。而且因为许多防火墙已经允许HTTP通过,系统管理员通常不需要改变防火墙设置来允许Subversion工作。</para>
   
         <para>Subversion使用HTTP和WebDAV(和DeltaV)来与Apache服务器通讯,你可以在本章的WebDAV读到更多信息,但简而言之,WebDAV和DeltaV是标准HTTP 1.1协议的扩展,允许在web上对文件进行分享和版本操作。Apache的2.0及以后的版本都包含一个mod_dav,一个Apache理解HTTP DAV扩展的模块,Subversion本身提供了mod_dav_svn,尽管,这是另一个Apache模块,它与mod_dav结合(实际上mod_dav_svn是作为后端支持)使用来提供Subversion对WebDAV和DeltaV的实现。</para>
 
@@ -360,7 +360,7 @@
         <para>作为标准HTTP/WebDAV协议的补充,Subversion也提供了一个使用自定义协议的RA实现,libsvn_ra_svn模块实现了自己的网络套接字连接,与一个独立服务器通讯—<filename>svnserve</filename>程序—在存放版本库的机器上。客户端可以使用<literal>svn://</literal>访问版本库。
        </para>
 
-        <para>这个RA实现缺乏前面小节提到的Apache的大多数优点;然而虽然如此,系统管理员会非常有兴趣,因为这配置和运行异常的简单;设置一个<filename>svnserve</filename>几乎是立刻的,它与Apache相比也是非常的小(从代码长度这方面说),让它非常容易进行安全或其它方面原因的审核。此外,一些系统管理员或许已经有了一个SSH安全基础,希望Subversion使用它,客户端使用ra_svn可以容易的使用SSH封装这个协议。
+        <para>这个RA实现缺乏前面小节提到的Apache的大多数优点;然而虽然如此,系统管理员会非常有兴趣,因为配置和运行异常的简单;设置一个<filename>svnserve</filename>几乎是立刻的,它与Apache相比也是非常的小(从代码长度这方面说),让它非常容易进行安全或其它方面原因的审核。此外,一些系统管理员或许已经有了一个SSH安全基础,希望Subversion使用它,客户端使用ra_svn可以容易的使用SSH封装这个协议。
        </para>
 
       </sect3>
@@ -969,7 +969,7 @@
       <para>现在你的工作拷贝包含了最新的Subversion源代码,你可以浏览一下<quote>Hacker's Guide to Subversion</quote>,它位于这个工作拷贝的<filename>www/hacking.html</filename>和Subversion网站的<ulink
           url="http://subversion.tigris.org/hacking.html"/>。这个指南包含了为Subversion贡献的指导,包括如何正确地格式化代码,从而与原来的代码保持一致,如何用有效的日志信息描述你修改的目的,等等。Subversion源代码版本库的提交权限是要自己争取的—由知识界精华控制。
         <footnote>
-          <para>浅薄的看起来这像是某种高人一等的优越感,<quote>赢得你的提交特权</quote>这个概念关于效率—检查和应用别人的修改是否安全和有用会花费大量的时间和精力,与之相比的是取消危险的代码的潜在代价。</para>
+          <para>浅薄的看起来这像是某种高人一等的优越感,但是<quote>赢得你的提交特权</quote>这个概念关于效率—检查和应用别人的修改是否安全和有用会花费大量的时间和精力,与之相比的是取消危险的代码的潜在代价。</para>
         </footnote>
         <quote>Hacker's Guide</quote>文件是一个无价的资源,它可以确保你被提议作的修改能够取得承认,而不会因为技术原因被拒绝。</para>
 

Modified: trunk/src/zh/book/ch09.xml
==============================================================================
--- trunk/src/zh/book/ch09.xml	(original)
+++ trunk/src/zh/book/ch09.xml	Tue Nov  7 00:20:12 2006
@@ -123,8 +123,7 @@
         </varlistentry>
         
         <varlistentry>
-          <term><option>--help</option> (<option>-h</option> or
-                <option>-?</option>)
+          <term><option>--help</option> (<option>-h</option>或<option>-?</option>)
           </term>
           <listitem>
             <para>如果同一个或多个子命令一起使用,会显示每个子命令内置的帮助文本,如果单独使用,它会显示常规的客户端帮助文本。</para>
@@ -280,8 +279,7 @@
         </varlistentry>
         
         <varlistentry>
-          <term><option>--relocate</option> <replaceable>FROM TO
-          [PATH...]</replaceable></term>
+          <term><option>--relocate</option> <replaceable>目的路径[PATH...]</replaceable></term>
           <listitem>
             <para><command>svn switch</command>子命令中使用,用来修改你的工作拷贝所引用的版本库位置。当版本库的位置修改了,而你有一个工作拷贝,希望继续使用时非常有用。见<command>svn switch</command>的例子。
             </para>
@@ -5336,7 +5334,7 @@
             <term><literal>SVNSpecialURI</literal></term>
             <listitem>
 
-              <para>指定特定Subversion资源的URI部分(命名空间),缺省是<quote><literal>!svn</literal></quote>,大多数管理员不会用到这个指示。只有那些必须要在版本库中放一个名字为<filename>!svn</filename>的文件时需要设置。如果你在一个已经使用中的服务器上这样修改,它会破坏所有的工作拷贝,你的用户会拿着叉子和火炬追杀你。
+              <para>指定特定Subversion资源的URI部分(命名空间),缺省是<quote><literal>!svn</literal></quote>,大多数管理员不会用到这个指示。只有那些必须要在版本库中放一个名字为<filename>!svn</filename>的文件时需要设置。如果你在一个已经使用中的服务器上这样修改,它会破坏所有的工作拷贝,你的用户会拿着叉子和火把追杀你。
              </para>
 
             </listitem>




More information about the svnbook-dev mailing list