[svnbook] r5926 committed - branches/1.8/zh/book/ref-svnadmin.xml
wuzhouhui at users.sourceforge.net
wuzhouhui at users.sourceforge.net
Sun Jun 2 08:24:49 CDT 2019
Revision: 5926
http://sourceforge.net/p/svnbook/source/5926
Author: wuzhouhui
Date: 2019-06-02 13:24:46 +0000 (Sun, 02 Jun 2019)
Log Message:
-----------
1.8/zh: translation of svnadmin reference in progress
Modified Paths:
--------------
branches/1.8/zh/book/ref-svnadmin.xml
Modified: branches/1.8/zh/book/ref-svnadmin.xml
===================================================================
--- branches/1.8/zh/book/ref-svnadmin.xml 2019-06-02 03:50:05 UTC (rev 5925)
+++ branches/1.8/zh/book/ref-svnadmin.xml 2019-06-02 13:24:46 UTC (rev 5926)
@@ -1,31 +1,55 @@
<!-- -*- sgml -*- -->
<reference id="svn.ref.svnadmin">
+ <!--
<title>svnadmin Reference—Subversion Repository Administration</title>
+ -->
+ <title>svnadmin 参考手册—Subversion 仓库管理工具</title>
<partintro>
+ <!--
<para><command>svnadmin</command> is the administrative tool for
monitoring and repairing your Subversion repository. For
detailed information on repository administration, see the maintenance section for <xref
linkend="svn.reposadmin.maint.tk.svnadmin"/>.</para>
+ -->
+ <para><command>svnadmin</command> 监控和修复 Subversion 仓库的管理工具. 关
+ 于仓库管理的更多细节, 见 <xref
+ linkend="svn.reposadmin.maint.tk.svnadmin"/>.</para>
+ <!--
<para>Since <command>svnadmin</command> works via direct repository access
(and thus can only be used on the machine that holds the
repository), it refers to the repository with a path, not a URL.</para>
+ -->
+ <para>由于 <command>svnadmin</command> 只有直接访问访问仓库才能工作 (因
+ 此它只能用在存放了仓库的主机中), 所以说在指定仓库时只能使用路径, 而不是
+ URL.</para>
+ <!--
<para>Options in <command>svnadmin</command> are global, just
as they are in <command>svn</command>:</para>
+ -->
+ <para><command>svnadmin</command> 的选项都是全局的, 就像
+ <command>svn</command> 的全局选项:</para>
<variablelist id="svn.ref.svnadmin.sw">
+ <!--
<title>svnadmin Options</title>
+ -->
+ <title>svnadmin 选项</title>
<varlistentry id="svn.ref.svnadmin.sw.bdb_log_keep">
<term><option>--bdb-log-keep</option></term>
<listitem>
+ <!--
<para>(Berkeley DB-specific.) Disable automatic log removal
of database logfiles. Having these logfiles around
can be convenient if you need to restore from a
catastrophic repository failure.</para>
+ -->
+ <para>(特定于 Berkeley DB 的选项.) 禁止自动删除数据库的日志文件.
+ 保留这些日志文件有助于从灾难性的仓库失败中恢复数据.</para>
</listitem>
</varlistentry>
@@ -33,6 +57,7 @@
<term><option>--bdb-txn-nosync</option></term>
<listitem>
+ <!--
<para>(Berkeley DB-specific.) Disables fsync when
committing database transactions. Used with the
<command>svnadmin create</command> command to create a
@@ -39,6 +64,12 @@
Berkeley DB-backed repository with
<literal>DB_TXN_NOSYNC</literal> enabled (which improves
speed but has some risks associated with it).</para>
+ -->
+ <para>(特定于 Berkeley DB 的选项.) 在提交数据库事务时禁止调用
+ <literal>fsync</literal>. 该选项可以让 <command>svnadmin
+ create</command> 创建一个开启了 <literal>DB_TXN_NOSYNC</literal>,
+ 以 Berkeley DB 用为后端存储的仓库 (该选项可以提升性能, 但会带
+ 来一定的风险).</para>
</listitem>
</varlistentry>
@@ -45,7 +76,10 @@
<varlistentry id="svn.ref.svnadmin.sw.bypass_hooks">
<term><option>--bypass-hooks</option></term>
<listitem>
+ <!--
<para>Bypass the repository hook system.</para>
+ -->
+ <para>旁路掉仓库的钩子脚本.</para>
</listitem>
</varlistentry>
@@ -52,8 +86,11 @@
<varlistentry id="svn.ref.svnadmin.sw.bypass_prop_validation">
<term><option>--bypass-prop-validation</option></term>
<listitem>
+ <!--
<para>When loading a dump file, disable the logic which
validates property values.</para>
+ -->
+ <para>加载一个转储文件时, 禁止对属性值进行检查.</para>
</listitem>
</varlistentry>
@@ -60,7 +97,10 @@
<varlistentry id="svn.ref.svnadmin.sw.clean_logs">
<term><option>--clean-logs</option></term>
<listitem>
+ <!--
<para>Remove unused Berkeley DB logs.</para>
+ -->
+ <para>删除无用的 Berkeley DB 日志.</para>
</listitem>
</varlistentry>
@@ -67,8 +107,12 @@
<varlistentry id="svn.ref.svnadmin.sw.compatible_version">
<term><option>--compatible-version</option> <replaceable>ARG</replaceable></term>
<listitem>
+ <!--
<para>Use repository format compatible with Subversion version
<replaceable>ARG</replaceable>.</para>
+ -->
+ <para>使用与版本为 <replaceable>ARG</replaceable> 的 Subversion
+ 兼容的仓库格式.</para>
</listitem>
</varlistentry>
@@ -77,10 +121,14 @@
logic doesn't even use it. Weird. -->
<term><option>--config-dir</option> <replaceable>DIR</replaceable></term>
<listitem>
+ <!--
<para>Instructs Subversion to read configuration
information from the specified directory instead of the
default location (<filename>.subversion</filename> in
the user's home directory).</para>
+ -->
+ <para>告诉 Subversion 从指定的目录内读取配置信息, 而不是从默认的目录
+ (用户家目录中的 <filename>.subversion</filename>) 中读取.</para>
</listitem>
</varlistentry>
@@ -87,9 +135,13 @@
<varlistentry id="svn.ref.svnadmin.sw.deltas">
<term><option>--deltas</option></term>
<listitem>
+ <!--
<para>When creating a repository dump file, specify
changes in versioned properties and file contents as
deltas against their previous state.</para>
+ -->
+ <para>在创建仓库的转储文件时, 把属性和文件内容上的修改指定成相对于
+ 前一状态的修改.</para>
</listitem>
</varlistentry>
@@ -96,8 +148,11 @@
<varlistentry id="svn.ref.svnadmin.sw.file">
<term><option>--file</option> (<option>-F</option>) <replaceable>FILENAME</replaceable></term>
<listitem>
+ <!--
<para>Uses the contents of the named file for the
specified subcommand.</para>
+ -->
+ <para>为指定的子命令使用文件中的内容.</para>
</listitem>
</varlistentry>
@@ -104,11 +159,16 @@
<varlistentry id="svn.ref.svnadmin.sw.fs_type">
<term><option>--fs-type</option> <replaceable>ARG</replaceable></term>
<listitem>
+ <!--
<para>When creating a repository,
use <replaceable>ARG</replaceable> as the requested
filesyste type. <replaceable>ARG</replaceable> may be
either <literal>bdb</literal>
or <literal>fsfs</literal>.</para>
+ -->
+ <para>创建一个仓库时, 使用 <replaceable>ARG</replaceable> 指定的文件
+ 系统类型, <replaceable>ARG</replaceable> 可以是
+ <literal>bdb</literal> 或 <literal>fsfs</literal>.</para>
</listitem>
</varlistentry>
@@ -115,11 +175,16 @@
<varlistentry id="svn.ref.svnadmin.sw.force_uuid">
<term><option>--force-uuid</option></term>
<listitem>
+ <!--
<para>By default, when loading data into a repository that
already contains revisions, <command>svnadmin</command>
will ignore the UUID from the dump stream. This option
will cause the repository's UUID to be set to the UUID
from the stream.</para>
+ -->
+ <para>默认情况下, 为一个已经包含了版本号的仓库加载转储数据时,
+ <command>svnadmin</command> 会忽略转储数据中的 UUID. 该选项使得
+ 仓库的 UUID 被设置成转储数据中的 UUID.</para>
</listitem>
</varlistentry>
@@ -126,10 +191,16 @@
<varlistentry id="svn.ref.svnadmin.sw.ignore_uuid">
<term><option>--ignore-uuid</option></term>
<listitem>
+ <!--
<para>By default, when loading data into an empty repository,
<command>svnadmin</command> will set the repository's UUID
to the UUID from the dump stream. This option will cause
the UUID from the stream to be ignored.</para>
+ -->
+ <para>默认情况下, 往一个空仓库加载转储数据时,
+ <command>svnadmin</command> 会把仓库的 UUID 设置成转储数据中的
+ UUID. 该选项使得 <command>svnadmin</command> 忽略转储数据中的
+ UUID.</para>
</listitem>
</varlistentry>
@@ -136,9 +207,12 @@
<varlistentry id="svn.ref.svnadmin.sw.incremental">
<term><option>--incremental</option></term>
<listitem>
+ <!--
<para>Dump a revision only as a diff against the
previous revision, instead of the usual
fulltext.</para>
+ -->
+ <para>按照增量格式转储版本号.</para>
</listitem>
</varlistentry>
@@ -145,10 +219,14 @@
<varlistentry id="svn.ref.svnadmin.sw.memory_cache_size">
<term><option>--memory-cache-size</option> (<option>-M</option>) <replaceable>ARG</replaceable></term>
<listitem>
+ <!--
<para>Configures the size (in Megabytes) of the extra
in-memory cache used to minimize redundant operations.
The default value is <literal>16</literal>. (This cache
is used for FSFS-backed repositories only.)</para>
+ -->
+ <para>配置额外的内存缓存大小 (以 MB 为单位), 这种缓存可以用来减少
+ 重复操作, 但只能用于以 FSFS 作为后端存储的仓库. 默认值是 16.</para>
</listitem>
</varlistentry>
@@ -155,9 +233,14 @@
<varlistentry id="svn.ref.svnadmin.sw.parent_dir">
<term><option>--parent-dir</option> <replaceable>DIR</replaceable></term>
<listitem>
+ <!--
<para>When loading a dump file, root paths at
<replaceable>DIR</replaceable> instead of
<filename>/</filename>.</para>
+ -->
+ <para>加载一个转储文件时, 把根目录设置成
+ <replaceable>DIR</replaceable>, 而不是默认的
+ <filename>/</filename>.</para>
</listitem>
</varlistentry>
@@ -164,10 +247,15 @@
<varlistentry id="svn.ref.svnadmin.sw.pre_1.4_compatible">
<term><option>--pre-1.4-compatible</option></term>
<listitem>
+ <!--
<para><emphasis>Deprecated</emphasis>. See option
- <option>--compatible-version</option>. When creating a new
+ <option>- -compatible-version</option>. When creating a new
repository, use a format that is compatible with versions of
Subversion earlier than Subversion 1.4.</para>
+ -->
+ <para><emphasis>不再推荐使用</emphasis>. 见选项
+ <option>--compatible-version</option>. 当创建一个新的仓库时,
+ 仓库的格式要和 Subversion 1.4 之前的版本保持兼容.</para>
</listitem>
</varlistentry>
@@ -174,10 +262,15 @@
<varlistentry id="svn.ref.svnadmin.sw.pre_1.5_compatible">
<term><option>--pre-1.5-compatible</option></term>
<listitem>
+ <!--
<para><emphasis>Deprecated</emphasis>. See option
- <option>--compatible-version</option>. When creating a new
+ <option>- -compatible-version</option>. When creating a new
repository, use a format that is compatible with versions of
Subversion earlier than Subversion 1.5.</para>
+ -->
+ <para><emphasis>不再推荐使用</emphasis>. 见选项
+ <option>--compatible-version</option>. 当创建一个新的仓库时,
+ 仓库的格式要和 Subversion 1.5 之前的版本保持兼容.</para>
</listitem>
</varlistentry>
@@ -184,10 +277,15 @@
<varlistentry id="svn.ref.svnadmin.sw.pre_1.6_compatible">
<term><option>--pre-1.6-compatible</option></term>
<listitem>
+ <!--
<para><emphasis>Deprecated</emphasis>. See option
- <option>--compatible-version</option>. When creating a new
+ <option>- -compatible-version</option>. When creating a new
repository, use a format that is compatible with versions of
Subversion earlier than Subversion 1.6.</para>
+ -->
+ <para><emphasis>不再推荐使用</emphasis>. 见选项
+ <option>--compatible-version</option>. 当创建一个新的仓库时,
+ 仓库的格式要和 Subversion 1.6 之前的版本保持兼容.</para>
</listitem>
</varlistentry>
@@ -194,8 +292,11 @@
<varlistentry id="svn.ref.svnadmin.sw.revision">
<term><option>--revision</option> (<option>-r</option>) <replaceable>ARG</replaceable></term>
<listitem>
+ <!--
<para>Specify a particular revision to operate
on.</para>
+ -->
+ <para>为后面的操作指定一个版本号.</para>
</listitem>
</varlistentry>
@@ -202,8 +303,11 @@
<varlistentry id="svn.ref.svnadmin.sw.quiet">
<term><option>--quiet</option> (<option>-q</option>)</term>
<listitem>
+ <!--
<para>Do not show normal progress—show only
errors.</para>
+ -->
+ <para>不要显示正常的输出—只显示与错误有关的输出.</para>
</listitem>
</varlistentry>
@@ -210,9 +314,13 @@
<varlistentry id="svn.ref.svnadmin.sw.use_post_commit_hook">
<term><option>--use-post-commit-hook</option></term>
<listitem>
+ <!--
<para>When loading a dump file, runs the repository's
<literal>post-commit</literal> hook after finalizing each newly loaded
revision.</para>
+ -->
+ <para>加载一个转储文件时, 每完成一个版本号的提交, 就执行一次仓库
+ 的 post-commit 钩子脚本.</para>
</listitem>
</varlistentry>
@@ -219,9 +327,13 @@
<varlistentry id="svn.ref.svnadmin.sw.use_post_revprop_change_hook">
<term><option>--use-post-revprop-change-hook</option></term>
<listitem>
+ <!--
<para>When changing a revision property, runs the
repository's <literal>post-revprop-change</literal> hook after changing the
revision property.</para>
+ -->
+ <para>修改一个版本号属性时, 在修改完后执行仓库的
+ post-revprop-change 钩子脚本.</para>
</listitem>
</varlistentry>
@@ -228,10 +340,15 @@
<varlistentry id="svn.ref.svnadmin.sw.use_pre_commit_hook">
<term><option>--use-pre-commit-hook</option></term>
<listitem>
+ <!--
<para>When loading a dump file, runs the repository's
<literal>pre-commit</literal> hook before finalizing each newly loaded
revision. If the hook fails, aborts the commit and
terminates the load process.</para>
+ -->
+ <para>加载一个转储文件时, 在提交版本号之前, 执行仓库的
+ pre-commit 钩子脚本, 如果脚本返回错误, 则中止提交, 并结束整个加载
+ 过程.</para>
</listitem>
</varlistentry>
@@ -238,10 +355,14 @@
<varlistentry id="svn.ref.svnadmin.sw.use_pre_revprop_change_hook">
<term><option>--use-pre-revprop-change-hook</option></term>
<listitem>
+ <!--
<para>When changing a revision property, runs the
repository's <literal>pre-revprop-change</literal> hook before changing the
revision property. If the hook fails, aborts the
modification and terminates.</para>
+ -->
+ <para>在修改一个版本号属性之前, 执行仓库的 pre-revprop-change
+ 钩子脚本, 如果脚本返回错误, 就中止修改操作并结束.</para>
</listitem>
</varlistentry>
@@ -248,10 +369,14 @@
<varlistentry id="svn.ref.svnadmin.sw.wait">
<term><option>--wait</option></term>
<listitem>
+ <!--
<para>For operations which require exclusive repository
access, wait until the requisite repository lock has
been obtained instead of immediately erroring out when
it cannot be.</para>
+ -->
+ <para>对于那些需要互斥访问仓库的操作来说, 如果仓库锁已经被他人获取,
+ 则等待别人放锁, 而不是马上报错退出.</para>
</listitem>
</varlistentry>
@@ -271,7 +396,10 @@
<refnamediv>
<refname>svnadmin crashtest</refname>
+ <!--
<refpurpose>Simulate a process that crashes.</refpurpose>
+ -->
+ <refpurpose>模拟一个崩溃的进程.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -280,8 +408,12 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>描述</title>
+ <!--
<para>Open the repository at <replaceable>REPOS_PATH</replaceable>, then abort, thus
simulating a process that crashes while holding an open
repository handle. This is used for testing automatic
@@ -288,20 +420,33 @@
repository recovery (a new feature in Berkeley DB 4.4).
It's unlikely that you'll need to run this
command.</para>
+ -->
+ <para>打开路径为 <replaceable>REPOS_PATH</replaceable> 的仓库,
+ 然后模拟进程在持有一个打开的仓库句柄时崩溃. 该命令用于测试仓库的自动
+ 复原 (Berkeley DB 4.4 引入的新特性). 用户应该不会用到该命令.</para>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>选项</title>
+ <!--
<para>None</para>
+ -->
+ <para>无</para>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>示例</title>
<informalexample>
<screen>
@@ -310,7 +455,10 @@
</screen>
</informalexample>
+ <!--
<para>Exciting, isn't it?</para>
+ -->
+ <para>很刺激, 是不是?</para>
</refsect1>
</refentry>
@@ -328,7 +476,10 @@
<refnamediv>
<refname>svnadmin create</refname>
+ <!--
<refpurpose>Create a new, empty repository.</refpurpose>
+ -->
+ <refpurpose>创建一个新的空仓库.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -337,8 +488,12 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>描述</title>
+ <!--
<para>Create a new, empty repository at the path provided.
If the provided directory does not exist, it will be
created for
@@ -349,6 +504,13 @@
repositories with the
<literal>FSFS</literal> filesystem backend by
default.</para>
+ -->
+ <para>在指定的路径下创建一个新的空仓库, 如果目录不存在,
+ <command>svnadmin</command> 就会创建该目录. <footnote><para>记住,
+ <command>svnadmin</command> 只接受本地 <emphasis>路径</emphasis>,
+ 不支持 <emphasis>URL</emphasis>.</para></footnote> 从
+ Subversion 1.2 开始, <command>svnadmin</command> 默认使用 FSFS
+ 作为新仓库的后端存储.</para>
<para>While <command>svnadmin create</command> will create
the base directory for a new repository, it will not
More information about the svnbook-dev
mailing list