[svnbook] r5907 committed - branches/1.8/zh/book/ref-svn.xml

wuzhouhui at users.sourceforge.net wuzhouhui at users.sourceforge.net
Sat Mar 30 21:25:43 CDT 2019


Revision: 5907
          http://sourceforge.net/p/svnbook/source/5907
Author:   wuzhouhui
Date:     2019-03-31 02:25:39 +0000 (Sun, 31 Mar 2019)
Log Message:
-----------
1.8/zh: translation of svn reference in progress

Modified Paths:
--------------
    branches/1.8/zh/book/ref-svn.xml

Modified: branches/1.8/zh/book/ref-svn.xml
===================================================================
--- branches/1.8/zh/book/ref-svn.xml	2019-03-30 11:45:46 UTC (rev 5906)
+++ branches/1.8/zh/book/ref-svn.xml	2019-03-31 02:25:39 UTC (rev 5907)
@@ -4595,16 +4595,26 @@
       <listitem><para>最近一次提交的日期和时间</para></listitem>
       </itemizedlist>
 
-      <para>With <option>--xml</option>, output is in XML format
+      <!--
+      <para>With <option>- -xml</option>, output is in XML format
         (with a header and an enclosing document element unless
-        <option>--incremental</option> is also specified).  All of
-        the information is present; the <option>--verbose</option>
+        <option>- -incremental</option> is also specified).  All of
+        the information is present; the <option>- -verbose</option>
         (<option>-v</option>) option is not accepted.</para>
+      -->
+      <para>如果添加了选项 <option>--xml</option>, 输出将会是 XML 格式
+        (带有头部信息和封闭的文件元素, 除非还添加了选项
+        <option>--incremental</option>), 所有的信息都会被呈现出来, 但
+        此时不能再使用选项 <option>--verbose</option> (<option>-v</option>).
+      </para>
     </refsect1>
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Options</title>
+      -->
+      <title>选项</title>
 
       <informalexample>
         <screen>
@@ -4620,11 +4630,18 @@
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Examples</title>
+      -->
+      <title>示例</title>
 
+      <!--
       <para><command>svn list</command> is most useful if you
         want to see what files a repository has without
         downloading a working copy:</para>
+      -->
+      <para>如果你想查看仓库里有哪些文件, 但又不想检出工作副本, 那么
+        <command>svn list</command> 就显得很方便了:</para>
 
       <informalexample>
         <screen>
@@ -4636,10 +4653,14 @@
 </screen>
       </informalexample>
 
-      <para>You can pass the <option>--verbose</option>
+      <!--
+      <para>You can pass the <option>- -verbose</option>
         (<option>-v</option>) option for additional information,
         rather like the Unix command
         <command>ls -l</command>:</para>
+      -->
+      <para>如果你想查看更多的信息, 就添加选项 <option>--verbose</option>,
+        就像 Unix 命令 <command>ls -l</command>:</para>
 
       <informalexample>
         <screen>
@@ -4650,8 +4671,12 @@
 </screen>
       </informalexample>
 
+      <!--
       <para>You can also get <command>svn list</command> output in
-        XML format with the <option>--xml</option> option:</para>
+        XML format with the <option>- -xml</option> option:</para>
+      -->
+      <para>添加选项 <option>--xml</option> 后, <command>svn list</command>
+        将以 XML 格式显示输出:</para>
 
       <informalexample>
         <screen>
@@ -4676,8 +4701,11 @@
 </screen>
       </informalexample>
 
+      <!--
       <para>For further details, see the earlier section <xref
         linkend="svn.tour.history.browsing.list"/>.</para>
+      -->
+    <para>更多的信息见 <xref linkend="svn.tour.history.browsing.list"/>.</para>
 
     </refsect1>
   </refentry>
@@ -4696,9 +4724,13 @@
 
     <refnamediv>
       <refname>svn lock</refname> 
+      <!--
         <refpurpose>Lock working copy paths or URLs in the
           repository so that no other user can commit changes to
           them.</refpurpose>
+      -->
+        <refpurpose>根据工作副本路径或 URL, 为仓库里的文件加锁, 从而阻止其他
+          用户提交这些文件的修改.</refpurpose>
     </refnamediv>
 
     <refsynopsisdiv>
@@ -4707,20 +4739,33 @@
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Description</title>
+      -->
+      <title>描述</title>
 
+      <!--
       <para>Lock each <replaceable>TARGET</replaceable>.  If any
         <replaceable>TARGET</replaceable> is already locked by
         another user, print a warning and continue locking the
         rest of the <replaceable>TARGET</replaceable>s.  Use
-        <option>--force</option> to steal a lock from another user
+        <option>- -force</option> to steal a lock from another user
         or working copy.</para>
+      -->
+      <para>锁定每一个 <replaceable>TARGET</replaceable>. 如果存在
+        <replaceable>TARGET</replaceable> 已经被其他用户锁定了, Subversion
+        将打印一个警告, 然后继续锁定剩下的 <replaceable>TARGET</replaceable>.
+        如果想要从其他用户或工作副本那儿窃取锁, 就加上选项
+        <option>--force</option>.</para>
 
     </refsect1>
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Options</title>
+      -->
+      <title>选项</title>
 
       <informalexample>
         <screen>
@@ -4736,9 +4781,15 @@
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Examples</title>
+      -->
+      <title>示例</title>
 
+      <!--
       <para>Lock two files in your working copy:</para>
+      -->
+      <para>锁定工作副本中的两个文件:</para>
 
       <informalexample>
         <screen>
@@ -4748,8 +4799,11 @@
 </screen>
       </informalexample>
 
+      <!--
       <para>Lock a file in your working copy that is currently
         locked by another user:</para>
+      -->
+      <para>锁定一个已经被其他用户锁定的文件:</para>
 
       <informalexample>
         <screen>
@@ -4761,7 +4815,10 @@
 </screen>
       </informalexample>
 
+      <!--
       <para>Lock a file without a working copy:</para>
+      -->
+      <para>在没有工作副本的情况下锁定一个文件:</para>
 
       <informalexample>
         <screen>
@@ -4770,8 +4827,11 @@
 </screen>
       </informalexample>
 
+      <!--
       <para>For further details, see <xref
         linkend="svn.advanced.locking"/>.</para>
+      -->
+    <para>更多的细节, 见 <xref linkend="svn.advanced.locking"/>.</para>
 
     </refsect1>
   </refentry>
@@ -4790,7 +4850,10 @@
 
     <refnamediv>
       <refname>svn log</refname>
+      <!--
       <refpurpose>Display commit log messages.</refpurpose>
+      -->
+      <refpurpose>显示提交日志消息.</refpurpose>
     </refnamediv>
 
     <refsynopsisdiv>
@@ -4800,8 +4863,12 @@
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Description</title>
+      -->
+      <title>描述</title>
 
+      <!--
       <para>Shows log messages from the repository.
         If no arguments are supplied, <command>svn
         log</command> shows the log messages for all files and
@@ -4810,34 +4877,61 @@
         results by specifying a path, one or more revisions, or
         any combination of the two.  The default revision range
         for a local path is <literal>BASE:1</literal>.</para>
+      -->
+      <para>显示仓库的日志消息. 如果没有指定目标参数, <command>svn
+          log</command> 将显示当前工作副本目录的日志消息. 为了提炼输出结果,
+        你可以指定一个路径, 一个或多个版本号, 或路径与版本号的组合. Subversion
+        为一个本地路径打印的默认版本号范围是 <literal>BASE:1</literal>.</para>
 
+      <!--
       <para>If you specify a URL alone, it prints log
         messages for everything the URL contains.  If you
         add paths past the URL, only messages for those paths
         under that URL will be printed.  The default revision range
         for a URL is <literal>HEAD:1</literal>.</para>
+      -->
+      <para>如果用户只指定了一个 URL, 命令将会为 URL 内的所有文件打印日志
+        消息, 如果你在 URL 中添加了路径, 命令将只打印该路径的日志消息.
+        Subversion 为一个 URL 打印的默认版本号范围是 <literal>BASE:1</literal>.
+      </para>
 
-      <para>With <option>--verbose</option>
+      <!--
+      <para>With <option>- -verbose</option>
         (<option>-v</option>), <command>svn log</command> will
         also print all affected paths with each log message.
-        With <option>--quiet</option>
+        With <option>- -quiet</option>
         (<option>-q</option>), <command>svn log</command> will not
         print the log message body itself, this is compatible
-        with <option>--verbose</option>
+        with <option>- -verbose</option>
         (<option>-v</option>).</para>
+      -->
+      <para>如果添加了选项 <option>--verbose</option> (<option>-v</option>),
+        <command>svn log</command> 还会额外打印在本次修改中受到影响的路径.
+        如果添加了选项 <option>--quiet</option> (<option>-q</option>),
+        <command>svn log</command> 将不会打印日志消息的文本内容, 这个选项和
+        选项 <option>--verbose</option> (<option>-v</option>) 是兼容的.</para>
 
+      <!--
       <para>Each log message is printed just once, even if more
         than one of the affected paths for that revision were
         explicitly requested.  Logs follow copy history by
-        default.  Use <option>--stop-on-copy</option> to disable
+        default.  Use <option>- -stop-on-copy</option> to disable
         this behavior, which can be useful for determining branch
         points.</para>
+      -->
+      <para>即使在一次提交中受到影响的路径在命令行中出现了多次, 对应的日志
+        消息也只显示一次. 日志默认会跟随复制历史, 但可以用选项
+        <option>--stop-on-copy</option> 禁止跟随, 这可以用来判断创建分支的
+        时间点.</para>
 
     </refsect1>
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Options</title>
+      -->
+      <title>选项</title>
 
       <informalexample>
         <screen>
@@ -4867,7 +4961,10 @@
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Examples</title>
+      -->
+      <title>示例</title>
 
       <para>You can see the log messages for all the paths that
         changed in your working copy by running <userinput>svn




More information about the svnbook-dev mailing list