[svnbook] r5934 committed - branches/1.8/zh/book/ref-svnlook.xml
wuzhouhui at users.sourceforge.net
wuzhouhui at users.sourceforge.net
Sat Jun 15 21:01:12 CDT 2019
Revision: 5934
http://sourceforge.net/p/svnbook/source/5934
Author: wuzhouhui
Date: 2019-06-16 02:01:10 +0000 (Sun, 16 Jun 2019)
Log Message:
-----------
1.8/zh: translation of svnlook reference in progress
Modified Paths:
--------------
branches/1.8/zh/book/ref-svnlook.xml
Modified: branches/1.8/zh/book/ref-svnlook.xml
===================================================================
--- branches/1.8/zh/book/ref-svnlook.xml 2019-06-13 13:52:53 UTC (rev 5933)
+++ branches/1.8/zh/book/ref-svnlook.xml 2019-06-16 02:01:10 UTC (rev 5934)
@@ -1,9 +1,13 @@
<!-- -*- sgml -*- -->
<reference id="svn.ref.svnlook">
+ <!--
<title>svnlook Reference—Subversion Repository Examination</title>
+ -->
+ <title>svnlook 参考手册—Subversion 仓库检查工具</title>
<partintro>
+ <!--
<para><command>svnlook</command> is a command-line utility for
examining different aspects of a Subversion repository. It
does not make any changes to the repository—it's just
@@ -11,15 +15,30 @@
<command>svnlook</command> is typically used by the
repository hooks, but a repository administrator might find it
useful for diagnostic purposes.</para>
+ -->
+ <para><command>svnlook</command> 是一个命令行工具, 用于检查 Subversion
+ 仓库的方方面面, 它不会对仓库做出任何修改—它仅仅是
+ <quote>看一下</quote> 仓库. <command>svnlook</command> 经常被仓库钩子
+ 使用, 但管理员也可以用它来诊断仓库.</para>
+ <!--
<para>Since <command>svnlook</command> works via direct repository access
(and thus can be used only on the machine that holds the
repository), it refers to the repository with a path, not a URL.</para>
+ -->
+ <para>由于 <command>svnlook</command> 只有直接访问仓库才能工作 (因
+ 此它只能用在存放了仓库的主机中), 所以说在指定仓库时只能使用文件系统路径,
+ 而不是 URL.</para>
+ <!--
<para>If no revision or transaction is specified,
<command>svnlook</command> defaults to the youngest (most
recent) revision of the repository.</para>
+ -->
+ <para>如果没有指定版本号或事务, <command>svnlook</command> 默认使用仓库
+ 最新的版本号.</para>
+ <!--
<para>Options in <command>svnlook</command> are global, just
as they are in <command>svn</command> and
<command>svnadmin</command>; however, most options apply
@@ -26,15 +45,27 @@
to only one subcommand since the functionality of
<command>svnlook</command> is (intentionally) limited in
scope:</para>
+ -->
+ <para><command>svnlook</command> 的选项都是全局的, 就像
+ <command>svn</command> 和 <command>svnadmin</command> 的全局选项, 但是大
+ 多数选项只对一个子命令起作用, 因为 <command>svnlook</command> (有意地)
+ 限制了功能的作用范围.</para>
<variablelist id="svn.ref.svnlook.sw">
+ <!--
<title>svnlook Options</title>
+ -->
+ <title>svnlook 选项</title>
<varlistentry id="svn.ref.svnlook.sw.copy_info">
<term><option>--copy-info</option></term>
<listitem>
+ <!--
<para>Causes <command>svnlook changed</command> to show
detailed copy source information.</para>
+ -->
+ <para>使得 <command>svnlook changed</command> 显示复制源的详细信息.
+ </para>
</listitem>
</varlistentry>
@@ -41,14 +72,21 @@
<varlistentry id="svn.ref.svnlook.sw.diff_cmd">
<term><option>--diff-cmd</option> <replaceable>CMD</replaceable></term>
<listitem>
+ <!--
<para>Specifies an external program to use to show differences
between files. When <command>svnlook diff</command> is invoked
without this option, it uses Subversion's internal differencing
engine, which provides unified diffs by default. If you want to
use an external differencing program, use
- <option>--diff-cmd</option>. You can then pass options to the
- specified program using the <option>--extensions</option>
+ <option>- -diff-cmd</option>. You can then pass options to the
+ specified program using the <option>- -extensions</option>
(<option>-x</option>) option.</para>
+ -->
+ <para>指定用于显示文件差异的外部差异比较工具. 如果在执行
+ <command>svnlook diff</command> 时没有指定该选项, 它就使用
+ Subversion 内建的差异比较引擎, 默认按照标准差异格式打印输出. 用户
+ 还可以用选项 <option>--extensions</option> (<option>-x</option>)
+ 向外部差异比较工具传递额外的选项.</para>
</listitem>
</varlistentry>
@@ -55,8 +93,11 @@
<varlistentry id="svn.ref.svnlook.sw.diff_copy_from">
<term><option>--diff-copy-from</option></term>
<listitem>
+ <!--
<para>Print differences for copied items against the copy
source.</para>
+ -->
+ <para>显示被复制的项目与复制源之间的差异.</para>
</listitem>
</varlistentry>
@@ -63,50 +104,76 @@
<varlistentry id="svn.ref.svnlook.sw.extensions">
<term><option>--extensions</option> (<option>-x</option>) <replaceable>ARG</replaceable></term>
<listitem>
+ <!--
<para>Specifies customizations which Subversion should
make when performing difference calculations. Valid
extensions include:</para>
+ -->
+ <para>为 Subversion 的差异比较指定扩展选项, 有效的扩展选项有:</para>
<variablelist>
<varlistentry>
<term><option>--ignore-space-change</option> (<option>-b</option>)</term>
<listitem>
+ <!--
<para>Ignore changes in the amount of white space.</para>
+ -->
+ <para>忽略空白字符在数量方面的变化.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--ignore-all-space</option> (<option>-w</option>)</term>
<listitem>
+ <!--
<para>Ignore all white space.</para>
+ -->
+ <para>忽略所有的空白字符.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--ignore-eol-style</option></term>
<listitem>
+ <!--
<para>Ignore changes in EOL (end-of-line) style.</para>
+ -->
+ <para>忽略 EOL (end-of-line, 行结束标记) 的变化.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--show-c-function</option> (<option>-p</option>)</term>
<listitem>
+ <!--
<para>Show C function names in the diff output.</para>
+ -->
+ <para>在差异比较输出中显示 C 语言的函数名.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--unified</option> (<option>-u</option>)</term>
<listitem>
+ <!--
<para>Show three lines of unified diff context.</para>
+ -->
+ <para>显示宽度为 3 行的标准差异上下文.</para>
</listitem>
</varlistentry>
</variablelist>
<para>The default value is <literal>-u</literal>.</para>
+ <!--
<para>Note that when Subversion is configured to invoke an
external diff command, the value of
- the <option>--extension</option> (<option>-x</option>)
+ the <option>- -extension</option> (<option>-x</option>)
option isn't restricted to the previously mentioned
options, but may be <emphasis>any</emphasis> additional
arguments which Subversion should pass to that command.
If you wish to pass multiple arguments, you must enclose
all of them in quotes.</para>
+ -->
+ <para>选项的默认值是 <literal>-u</literal>.</para>
+ <para>需要注意的是, 如果差异比较引擎是一个外部的差异比较工具, 那么
+ 选项 <option>--extensions</option> (<option>-x</option>) 的参数
+ 不仅限于以上提到的这些, 而是可以设置成外部差异比较工具能够授受
+ <emphasis>任意</emphasis> 参数, 如果你希望传递多个参数, 必须把
+ 它们用双引号包围起来.</para>
</listitem>
</varlistentry>
@@ -113,9 +180,13 @@
<varlistentry id="svn.ref.svnlook.sw.full_paths">
<term><option>--full-paths</option></term>
<listitem>
+ <!--
<para>Causes <command>svnlook tree</command> to display
full paths instead of hierarchical, indented path
components.</para>
+ -->
+ <para>使得 <command>svnlook tree</command> 显示完整的路径, 而不是
+ 层次化的, 逐渐缩进的路径分量.</para>
</listitem>
</varlistentry>
@@ -130,8 +201,12 @@
<varlistentry id="svn.ref.svnlook.sw.limit">
<term><option>--limit</option> (<option>-l</option>) <replaceable>ARG</replaceable></term>
<listitem>
+ <!--
<para>Limit output to a maximum number of
<replaceable>ARG</replaceable> items.</para>
+ -->
+ <para>把输出的项目个数限制在 <replaceable>ARG</replaceable> 以内.
+ </para>
</listitem>
</varlistentry>
@@ -138,11 +213,17 @@
<varlistentry id="svn.ref.svnlook.sw.no_diff_deleted">
<term><option>--no-diff-deleted</option></term>
<listitem>
+ <!--
<para>Prevents <command>svnlook diff</command> from printing
differences for deleted files. The default behavior
when a file is deleted in a transaction/revision is
to print the same differences that you would see if
you had left the file but removed all the content.</para>
+ -->
+ <para>禁止 <command>svnlook diff</command> 为删除的文件显示差异
+ 输出. 默认情况下, 如果文件在版本号或事务中被删除了,
+ <command>svnlook diff</command> 在为该文件显示差异输出时, 其效果
+ 就像是把文件的全部内容删除, 但不删除文件.</para>
</listitem>
</varlistentry>
@@ -149,11 +230,17 @@
<varlistentry id="svn.ref.svnlook.sw.no_diff_added">
<term><option>--no-diff-added</option></term>
<listitem>
+ <!--
<para>Prevents <command>svnlook diff</command> from printing
differences for added files. The default behavior when
you add a file is to print the same differences that you
would see if you had added the entire contents of an
existing (empty) file.</para>
+ -->
+ <para>禁止 <command>svnlook diff</command> 为新增的文件显示差异输出.
+ 默认情况下, 如果文件是新增的, 那么 <command>svnlook diff</command>
+ 在为该文件显示差异输出时, 其效果就像是把所有的内容一下子都添加到一
+ 个已有的空文件中.</para>
</listitem>
</varlistentry>
@@ -160,7 +247,10 @@
<varlistentry id="svn.ref.svnlook.sw.non_recursive">
<term><option>--non-recursive</option> (<option>-N</option>)</term>
<listitem>
+ <!--
<para>Operate on a single directory only.</para>
+ -->
+ <para>只对一个单独的目录进行操作.</para>
</listitem>
</varlistentry>
@@ -167,8 +257,11 @@
<varlistentry id="svn.ref.svnlook.sw.properties_only">
<term><option>--properties-only</option></term>
<listitem>
+ <!--
<para>Instructs <command>svnlook diff</command> to show only property
changes.</para>
+ -->
+ <para>使用 <command>svnlook diff</command> 只显示属性的变化.</para>
</listitem>
</varlistentry>
@@ -175,8 +268,11 @@
<varlistentry id="svn.ref.svnlook.sw.revision">
<term><option>--revision</option> (<option>-r</option>) <replaceable>REV</replaceable></term>
<listitem>
+ <!--
<para>Specifies a particular revision number that you wish
to examine.</para>
+ -->
+ <para>指定待检查版本号.</para>
</listitem>
</varlistentry>
@@ -183,11 +279,16 @@
<varlistentry id="svn.ref.svnlook.sw.revprop">
<term><option>--revprop</option></term>
<listitem>
+ <!--
<para>Operates on a revision property instead of a
property specific to a file or directory. This option
requires that you also pass a revision with the
- <option>--revision</option> (<option>-r</option>)
+ <option>- -revision</option> (<option>-r</option>)
option.</para>
+ -->
+ <para>针对版本号属性进行操作, 而不是文件或目录上的属性, 如果用到
+ 了该选项, 则用户还必须用选项 <option>--revision</option>
+ (<option>-r</option>) 指定一个版本号.</para>
</listitem>
</varlistentry>
@@ -194,9 +295,13 @@
<varlistentry id="svn.ref.svnlook.sw.show_inherited_props">
<term><option>--show-inherited-props</option></term>
<listitem>
+ <!--
<para>Works with <command>svnlook propget</command> and
<command>svnlook proplist</command> to display the versioned
properties inherited by a path.</para>
+ -->
+ <para>使得 <command>svnlook propget</command> 和
+ <command>svnlook proplist</command> 继承而来的属性.</para>
</listitem>
</varlistentry>
@@ -203,8 +308,11 @@
<varlistentry id="svn.ref.svnlook.sw.transaction">
<term><option>--transaction</option> (<option>-t</option>) <replaceable>ID</replaceable></term>
<listitem>
+ <!--
<para>Specifies a particular transaction ID that you wish to
examine.</para>
+ -->
+ <para>指定待检查的事务 ID.</para>
</listitem>
</varlistentry>
@@ -211,8 +319,11 @@
<varlistentry id="svn.ref.svnlook.sw.show_ids">
<term><option>--show-ids</option></term>
<listitem>
+ <!--
<para>Shows the filesystem node revision IDs for each path
in the filesystem tree.</para>
+ -->
+ <para>为文件系统树中的每一个路径, 显示文件系统节点的版本号 ID.</para>
</listitem>
</varlistentry>
@@ -219,10 +330,15 @@
<varlistentry id="svn.ref.svnlook.sw.verbose">
<term><option>--verbose</option> (<option>-v</option>)</term>
<listitem>
+ <!--
<para>Be verbose. When used with <command>svnlook
proplist</command>, for example, this causes Subversion
to display not just the list of properties, but their
values also.</para>
+ -->
+ <para>显示更加详细的输出. 例如为 <command>svnlook proplist</command>
+ 指定该选项时, 除了列出属性名, Subversion 还会把属性值打印出来.
+ </para>
</listitem>
</varlistentry>
@@ -229,7 +345,10 @@
<varlistentry id="svn.ref.svnlook.sw.xml">
<term><option>--xml</option></term>
<listitem>
+ <!--
<para>Prints output in XML format.</para>
+ -->
+ <para>按照 XML 格式打印输出.</para>
</listitem>
</varlistentry>
More information about the svnbook-dev
mailing list