[svnbook] r5946 committed - branches/1.8/zh/book/ref-svnversion.xml
wuzhouhui at users.sourceforge.net
wuzhouhui at users.sourceforge.net
Sat Jul 6 21:53:13 CDT 2019
Revision: 5946
http://sourceforge.net/p/svnbook/source/5946
Author: wuzhouhui
Date: 2019-07-07 02:53:11 +0000 (Sun, 07 Jul 2019)
Log Message:
-----------
1.8/zh: svnversion reference translated and reviewed
Modified Paths:
--------------
branches/1.8/zh/book/ref-svnversion.xml
Modified: branches/1.8/zh/book/ref-svnversion.xml
===================================================================
--- branches/1.8/zh/book/ref-svnversion.xml 2019-07-07 02:20:27 UTC (rev 5945)
+++ branches/1.8/zh/book/ref-svnversion.xml 2019-07-07 02:53:11 UTC (rev 5946)
@@ -1,7 +1,10 @@
<!-- -*- sgml -*- -->
<reference id="svn.ref.svnversion">
+ <!--
<title>svnversion Reference—Subversion Working Copy Version Info</title>
+ -->
+ <title>svnversion 参考手册—Subversion 工作副本版本信息</title>
<!-- ================================================================= -->
<!-- ================================================================= -->
@@ -14,8 +17,11 @@
<refnamediv>
<refname>svnversion</refname>
+ <!--
<refpurpose>Summarize the local revision(s) of a working
copy.</refpurpose>
+ -->
+ <refpurpose>输出工作副本的本地版本号总结信息.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -24,16 +30,28 @@
<!-- =============================================================== -->
<refsect1 id="svn.ref.svnversion.re.desc">
+ <!--
<title>Description</title>
+ -->
+ <title>描述</title>
+ <!--
<para><command>svnversion</command> is a program for
summarizing the revision mixture of a working copy. The
resultant revision number, or revision range, is written to
standard output.</para>
+ -->
+ <para><command>svnversion</command> 用于输出工作副本的本地版本号总结
+ 信息.</para>
+ <!--
<para>It's common to use this output in your build process
when defining the version number of your program.</para>
+ -->
+ <para>在程序的编译过程中, 人们经常用它来生成程序的版本号 (指的是软件
+ 的版本号, 而不是 Subversion 提交日志的版本号).</para>
+ <!--
<para><replaceable>TRAIL_URL</replaceable>, if present, is the
trailing portion of the URL used to determine whether
<replaceable>WC_PATH</replaceable> itself is switched
@@ -40,22 +58,40 @@
(detection of switches within
<replaceable>WC_PATH</replaceable> does not rely on
<replaceable>TRAIL_URL</replaceable>).</para>
+ -->
+ <para>参数 <replaceable>TRAIL_URL</replaceable> 指的是 URL 中处于末尾
+ 的分量, 如果指定了该参数, 它将被用于判断
+ <replaceable>WC_PATH</replaceable> 是否是切换过的 (对于判断
+ <replaceable>WC_PATH</replaceable> 中的路径是否是切换过的, 不依赖
+ 于参数 <replaceable>TRAIL_URL</replaceable>).</para>
+ <!--
<para>When <replaceable>WC_PATH</replaceable> is not defined,
the current directory will be used as the working copy path.
<replaceable>TRAIL_URL</replaceable> cannot be defined if
<replaceable>WC_PATH</replaceable> is not explicitly
given.</para>
+ -->
+ <para>如果没有显式指定 <replaceable>WC_PATH</replaceable>, 将默认使用当
+ 前工作目录, 而且此时不能再指定参数
+ <replaceable>TRAIL_URL</replaceable>.</para>
</refsect1>
<!-- =============================================================== -->
<refsect1 id="svn.ref.svnversion.re.sw">
+ <!--
<title>Options</title>
+ -->
+ <title>选项</title>
+ <!--
<para>Like <command>svnserve</command>,
<command>svnversion</command> has no subcommands—only
options:</para>
+ -->
+ <para>和 <command>svnserve</command> 一样, <command>svnversion</command>
+ 没有子命令, 只有选项:</para>
<variablelist>
@@ -62,7 +98,10 @@
<varlistentry id="svn.ref.svnversion.sw.no_newline">
<term><option>--no-newline</option> (<option>-n</option>)</term>
<listitem>
+ <!--
<para>Omits the usual trailing newline from the output.</para>
+ -->
+ <para>不要打印换行符.</para>
</listitem>
</varlistentry>
@@ -69,8 +108,12 @@
<varlistentry id="svn.ref.svnversion.sw.committed">
<term><option>--committed</option> (<option>-c</option>)</term>
<listitem>
+ <!--
<para>Uses the last-changed revisions rather than the
+ ### TODO
current (i.e., highest locally available) revisions.</para>
+ -->
+ <para>使用最近一次产生修改的版本号, 而不是当前版本号.</para>
</listitem>
</varlistentry>
@@ -77,7 +120,10 @@
<varlistentry id="svn.ref.svnversion.sw.help">
<term><option>--help</option> (<option>-h</option>)</term>
<listitem>
+ <!--
<para>Prints a help summary.</para>
+ -->
+ <para>输出帮助信息.</para>
</listitem>
</varlistentry>
@@ -84,8 +130,11 @@
<varlistentry id="svn.ref.svnversion.sw.quiet">
<term><option>--quiet</option> (<option>-q</option>)</term>
<listitem>
+ <!--
<para>Requests that the program print only essential
information while performing an operation.</para>
+ -->
+ <para>只输出必要的信息.</para>
</listitem>
</varlistentry>
@@ -92,8 +141,11 @@
<varlistentry id="svn.ref.svnversion.sw.version">
<term><option>--version</option></term>
<listitem>
+ <!--
<para>Prints the version of <command>svnversion</command>
and exit with no error.</para>
+ -->
+ <para>输出 <command>svnversion</command> 的版本信息.</para>
</listitem>
</varlistentry>
@@ -102,11 +154,19 @@
<!-- =============================================================== -->
<refsect1 id="svn.ref.svnversion.re.examples">
+ <!--
<title>Examples</title>
+ -->
+ <title>示例</title>
+ <!--
<para>If the working copy is all at the same revision (e.g.,
immediately after an update), then that revision is
printed out:</para>
+ -->
+ <para>如果工作副本中每个路径的版本号都相同 (例如刚执行完 <command>svn
+ update</command>), <command>svnversion</command> 就会输出这个
+ 共同的版本号:</para>
<informalexample>
<screen>
@@ -115,10 +175,15 @@
</screen>
</informalexample>
+ <!--
<para>You can add <replaceable>TRAIL_URL</replaceable> to make
sure the working copy is not switched from what you
expect. Note that the <replaceable>WC_PATH</replaceable>
is required in this command:</para>
+ -->
+ <para>为了判断工作副本是否是切换过的, 就加上参数
+ <replaceable>TRAIL_URL</replaceable>, 注意这时候必须显式地指定
+ <replaceable>WC_PATH</replaceable>:</para>
<informalexample>
<screen>
@@ -127,8 +192,11 @@
</screen>
</informalexample>
+ <!--
<para>For a mixed-revision working copy, the range of
revisions present is printed:</para>
+ -->
+ <para>对于版本号混合的工作副本, 将会输出版本号的范围:</para>
<informalexample>
<screen>
@@ -137,8 +205,12 @@
</screen>
</informalexample>
+ <!--
<para>If the working copy contains modifications, a trailing
'<literal>M</literal>' is added:</para>
+ -->
+ <para>如果工作副本含有本地修改, 就会在末尾添加字符
+ '<literal>M</literal>':</para>
<informalexample>
<screen>
@@ -147,8 +219,12 @@
</screen>
</informalexample>
+ <!--
<para>If the working copy is switched, a trailing
'<literal>S</literal>' is added:</para>
+ -->
+ <para>如果工作副本是切换过的, 就会在末尾添加字符 '<literal>S</literal>':
+ </para>
<informalexample>
<screen>
@@ -157,10 +233,15 @@
</screen>
</informalexample>
+ <!--
<para><command>svnversion</command> will also inform you if
the target working copy is sparsely populated (see
<xref linkend="svn.advanced.sparsedirs" />) by attaching the
'<literal>P</literal>' code to its output:</para>
+ -->
+ <para><command>svnversion</command> 还会指出工作副本是否是稀疏的
+ (见 <xref linkend="svn.advanced.sparsedirs" />), 方法是在末尾添加
+ 字符 '<literal>P</literal>':</para>
<informalexample>
<screen>
@@ -169,9 +250,13 @@
</screen>
</informalexample>
+ <!--
<para>Thus, here is a mixed-revision, sparsely populated and
switched working copy containing some local
modifications:</para>
+ -->
+ <para>如果有一个工作副本是稀疏的, 切换过的, 含有本地修改和混合的
+ 版本号, 则 <command>svnversion</command> 的输出将会是:</para>
<informalexample>
<screen>
More information about the svnbook-dev
mailing list