[svnbook] r5584 committed - branches/1.8/zh/book/ch05-repository-admin.xml

[wuzhouhui at users.sourceforge.net]

Revision: 5584
          http://sourceforge.net/p/svnbook/source/5584
Author:   wuzhouhui
Date:     2018-01-14 02:04:21 +0000 (Sun, 14 Jan 2018)
Log Message:
-----------
1.8/zh: translation of chapter 5 in progress

Modified Paths:
--------------
    branches/1.8/zh/book/ch05-repository-admin.xml

Modified: branches/1.8/zh/book/ch05-repository-admin.xml
===================================================================
--- branches/1.8/zh/book/ch05-repository-admin.xml	2018-01-13 02:11:55 UTC (rev 5583)
+++ branches/1.8/zh/book/ch05-repository-admin.xml	2018-01-14 02:04:21 UTC (rev 5584)
@@ -1811,6 +1811,7 @@
           </listitem>
         </orderedlist>
 
+      <!--
         <para>This output is human-readable, meaning items such as the
           datestamp are displayed using a textual representation
           instead of something more obscure (such as the number of
@@ -1824,7 +1825,17 @@
           allocate for the message, or at least how many bytes to skip
           in the event that this output is not the last bit of data in
           the stream.</para>
+      -->
+        <para>打印的内容是人类可读的, 例如对于日期来说, 它是以文本形式表示
+          出来, 而不是某种很费解的形式 (例如把日期表示成距离某个特殊日期的
+          纳秒数). 打印的内容同时也能被程序解析, 因为日志消息可能有很
+          多行, 在长度上也没有限制, 所以 <command>svnlook</command> 在打印日
+          志消息本身的内容之前, 先打印消息的长度, 这就允许处理
+          <command>svnlook</command> 输出的程序针对日志消息做出更明智的决策,
+          例如为日志消息分配多少内存, 或者是应该跳过多少字节才能完全跳过日志
+          消息.</para>
 
+      <!--
         <para><command>svnlook</command> can perform a variety of
           other queries:  displaying subsets of bits of information
           we've mentioned previously, recursively listing versioned
@@ -1833,6 +1844,12 @@
           differences made to files and directories, and so on.  See
           <xref linkend="svn.ref.svnlook" /> for a full reference of
           <command>svnlook</command>'s features.</para>
+      -->
+        <para><command>svnlook</command> 还能执行很多查询: 只显示上面提到的
+          信息的部分内容, 递归地列出被版本控制的目录树, 报告哪些路径在给定
+          的版本号或事务中被修改了, 显示文件和目录的内容和属性的变化, 等等.
+          <command>svnlook</command> 完整的参考手册, 见
+          <xref linkend="svn.ref.svnlook" />.</para>
 
       </sect3>
 
@@ -1840,6 +1857,7 @@
       <sect3 id="svn.reposadmin.maint.tk.svndumpfilter">
         <title>svndumpfilter</title>
 
+      <!--
         <para>While it won't be the most commonly used tool at the
           administrator's disposal, <command>svndumpfilter</command>
           provides a very particular brand of useful
@@ -1846,9 +1864,16 @@
           functionality—the ability to quickly and easily modify
           streams of Subversion repository history data by acting as a
           path-based filter.</para>
+      -->
+        <para>虽然 <command>svndumpfilter</command> 不是管理员最常使用的工具
+          之一, 但它却提供了一种非常特别且有用的功能—它可以作为一种基
+          于路径的过滤器, 快速地修改 Subversion 仓库历史的数据流.</para>
 
+      <!--
         <para>The syntax of <command>svndumpfilter</command> is as
           follows:</para>
+      -->
+        <para><command>svndumpfilter</command> 的使用语法是:</para>
 
         <informalexample>
           <screen>
@@ -1864,6 +1889,7 @@
 </screen>
         </informalexample>
 
+      <!--
         <para>There are only two interesting subcommands:
           <command>svndumpfilter exclude</command> and
           <command>svndumpfilter include</command>.  They allow you to
@@ -1872,6 +1898,12 @@
           subcommands and <command>svndumpfilter</command>'s unique
           purpose later in this chapter, in <xref
           linkend="svn.reposadmin.maint.filtering" />.</para>
+      -->
+      <para><command>svndumpfilter</command> 包含了 2 个子命令:
+        <command>svndumpfilter exclude</command> 和 <command>svndumpfilter
+          include</command>, 它们允许管理员从历史数据流中排除或保留指定的
+        路径. 在本章的 <xref linkend="svn.reposadmin.maint.filtering" />
+        读者将会学习到子命令的用法, 以及它们的典型应用.</para>
 
       </sect3>