[svnbook] r5930 committed - branches/1.8/zh/book/ref-svnadmin.xml
wuzhouhui at users.sourceforge.net
wuzhouhui at users.sourceforge.net
Sun Jun 9 06:51:19 CDT 2019
Revision: 5930
http://sourceforge.net/p/svnbook/source/5930
Author: wuzhouhui
Date: 2019-06-09 11:51:17 +0000 (Sun, 09 Jun 2019)
Log Message:
-----------
1.8/zh: svnadmin reference translated, but review needed
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-09 02:38:48 UTC (rev 5929)
+++ branches/1.8/zh/book/ref-svnadmin.xml 2019-06-09 11:51:17 UTC (rev 5930)
@@ -1881,14 +1881,21 @@
<refsect1>
<title>Description</title>
+ <!--
<para>Delete outstanding transactions from a repository.
This is covered in detail in <xref
linkend="svn.reposadmin.maint.diskspace.deadtxns" />.</para>
+ -->
+ <para>从仓库中删除未完成的事务, 更多的细节见 <xref
+ linkend="svn.reposadmin.maint.diskspace.deadtxns" />.</para>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>选项</title>
<informalexample>
<screen>
@@ -1899,9 +1906,15 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>示例</title>
+ <!--
<para>Remove named transactions:</para>
+ -->
+ <para>删除指定的事务:</para>
<informalexample>
<screen>
@@ -1909,8 +1922,12 @@
</screen>
</informalexample>
+ <!--
<para>Fortunately, the output of <command>lstxns</command>
works great as the input for <command>rmtxns</command>:</para>
+ -->
+ <para>方便的是, 我们可以把 <command>lstxns</command> 的输出当作
+ <command>rmtxns</command> 的输入:</para>
<informalexample>
<screen>
@@ -1918,8 +1935,11 @@
</screen>
</informalexample>
+ <!--
<para>This removes all uncommitted transactions from
your repository.</para>
+ -->
+ <para>上面的例子删除了仓库中所有未提交的事务.</para>
</refsect1>
</refentry>
@@ -1938,7 +1958,10 @@
<refnamediv>
<refname>svnadmin setlog</refname>
+ <!--
<refpurpose>Set the log message on a revision.</refpurpose>
+ -->
+ <refpurpose>设备版本号的日志消息.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -1947,24 +1970,43 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>描述</title>
+ <!--
<para>Set the log message on
revision <replaceable>REVISION</replaceable> to the
contents of <replaceable>FILE</replaceable>.</para>
+ -->
+ <para>把版本号 <replaceable>REVISION</replaceable> 的日志消息设置成
+ 文件 <replaceable>FILE</replaceable> 的内容.</para>
+ <!--
<para>This is similar to using <command>svn propset</command>
- with the <option>--revprop</option> option to set the <literal>svn:log</literal> property
+ with the <option>- -revprop</option> option to set the <literal>svn:log</literal> property
on a revision, except that you can also use the option
- <option>--bypass-hooks</option> to avoid running any pre-
+ <option>- -bypass-hooks</option> to avoid running any pre-
or post-commit hooks, which is useful if the modification
of revision properties has not been enabled in
the <literal>pre-revprop-change</literal> hook.</para>
+ -->
+ <para>这个命令类似于用带有选项 <option>--revprop</option> 的命令
+ <command>svn propset</command> 设置版本号的 <literal>svn:log</literal>
+ 属性, 不同点是在使用 <command>svnadmin setlog</command> 可以利用选项
+ <option>--bypass-hooks</option> 旁路掉 pre-commit 或 post-commit 钩子
+ 脚本, 这对于没有在钩子 pre-revprop-change 中开启版本号修改的情景非常
+ 方便.</para>
<warning>
+ <!--
<para>Revision properties are not under version control,
so this command will permanently overwrite the previous
log message.</para>
+ -->
+ <para>Subversion 不会对版本号属性进行版本控制, 所以 <command>svnadmin
+ setlog</command> 会永久性地覆盖掉之前的日志消息. </para>
</warning>
</refsect1>
@@ -1971,7 +2013,10 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>选项</title>
<informalexample>
<screen>
@@ -1983,10 +2028,17 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>示例</title>
+ <!--
<para>Set the log message for revision 19 to the contents of
the file <filename>msg</filename>:</para>
+ -->
+ <para>把版本号 19 的日志消息设置成文件 <filename>msg</filename> 的
+ 内容:</para>
<informalexample>
<screen>
@@ -2010,7 +2062,10 @@
<refnamediv>
<refname>svnadmin setrevprop</refname>
+ <!--
<refpurpose>Set a property on a revision.</refpurpose>
+ -->
+ <refpurpose>在版本号上设置一个属性.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -2019,21 +2074,34 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>描述</title>
+ <!--
<para>Set the property <replaceable>NAME</replaceable> on
revision <replaceable>REVISION</replaceable> to the
contents of <replaceable>FILE</replaceable>. Use
- <option>--use-pre-revprop-change-hook</option>
- or <option>--use-post-revprop-change-hook</option> to
+ <option>- -use-pre-revprop-change-hook</option>
+ or <option>- -use-post-revprop-change-hook</option> to
trigger the revision property-related hooks (e.g., if
you want an email notification sent from your <literal>post-revprop-change-hook</literal>).</para>
+ -->
+ <para>把版本号 <replaceable>REVISION</replaceable> 的属性
+ <replaceable>NAME</replaceable> 的值设置成文件
+ <filename>FILE</filename> 的内容. 如果想要触发与版本号属性相关的
+ 钩子脚本 (例如在钩子 post-revprop-change 里发送一封邮件, 通知大家
+ 有属性被修改了).</para>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>选项</title>
<informalexample>
<screen>
@@ -2046,11 +2114,18 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>示例</title>
+ <!--
<para>The following sets the revision
property <literal>repository-photo</literal> to the contents
of the file <filename>sandwich.png</filename>:</para>
+ -->
+ <para>下面的例子把版本号属性 <literal>repository-photo</literal> 的值设置
+ 文件 <filename>sandwich.png</filename> 的内容:</para>
<informalexample>
<screen>
@@ -2058,8 +2133,12 @@
</screen>
</informalexample>
+ <!--
<para>As you can see, <command>svnadmin setrevprop</command>
has no output upon success.</para>
+ -->
+ <para>可以看到, <command>svnadmin setrevprop</command> 在执行成功时不会
+ 输出任何信息.</para>
</refsect1>
</refentry>
@@ -2077,7 +2156,10 @@
<refnamediv>
<refname>svnadmin setuuid</refname>
+ <!--
<refpurpose>Reset the repository UUID.</refpurpose>
+ -->
+ <refpurpose>重置仓库的 UUID.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -2086,27 +2168,46 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>描述</title>
+ <!--
<para>Reset the repository UUID for the repository located
at <replaceable>REPOS_PATH</replaceable>.
If <replaceable>NEW_UUID</replaceable> is provided, use
that as the new repository UUID; otherwise, generate a
brand-new UUID for the repository.</para>
+ -->
+ <para>重置仓库 <replaceable>REPOS_PATH</replaceable> 的 UUID. 如果提供了
+ <replaceable>NEW_UUID</replaceable>, 它将会是仓库的新 UUID; 否则的话,
+ Subversion 将自动为仓库生成一个新的 UUID.</para>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>选项</title>
+
+ <!--
<para>None</para>
+ -->
+ <para>无</para>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>示例</title>
+ <!--
<para>If you've <command>svnsync</command>ed <filename>/var/svn/repos</filename>
to <filename>/var/svn/repos-new</filename> and intend to use <filename>repos-new</filename> as your
canonical repository, you may want to change the UUID for
@@ -2113,6 +2214,13 @@
<filename>repos-new</filename> to the UUID of <filename>repos</filename> so that your users don't
have to check out a new working copy to accommodate the
change:</para>
+ -->
+ <para>如果管理员已经用 <command>svnsyn</command> 把
+ <filename>/var/svn/repos</filename> 备份到了
+ <filename>/var/svn/repos-new</filename>, 现在想用
+ <filename>repos-new</filename> 作为新的官方仓库, 为了不麻烦用户再重新
+ 检出新的工作副本, 管理员需要把 <filename>repos-new</filename> 的 UUID
+ 设置成 <filename>repos</filename> 的 UUID:</para>
<informalexample>
<screen>
@@ -2120,8 +2228,12 @@
</screen>
</informalexample>
+ <!--
<para>As you can see, <command>svnadmin setuuid</command>
has no output upon success.</para>
+ -->
+ <para>可以看到, <command>svnadmin setuuid</command> 在执行成功时不会
+ 输出任何信息.</para>
</refsect1>
</refentry>
@@ -2138,7 +2250,10 @@
<refnamediv>
<refname>svnadmin unlock</refname>
+ <!--
<refpurpose>Unlock path in the repository directly.</refpurpose>
+ -->
+ <refpurpose>直接在仓库中解锁一个路径.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -2148,18 +2263,30 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>描述</title>
+ <!--
<para>Unlock <replaceable>LOCKED_PATH</replaceable> in the
repository (as <replaceable>USERNAME</replaceable>) after
verifying that the token associated with the lock
matches <replaceable>TOKEN</replaceable>.</para>
+ -->
+ <para>如果锁令牌与 <replaceable>TOKEN</replaceable> 相匹配,
+ <command>svnadmin</command> 将以用户
+ <replaceable>USERNAME</replaceable> 的身份解锁
+ <replaceable>LOCKED_PATH</replaceable>.</para>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>选项</title>
<informalexample>
<screen>
<xref linkend="svn.ref.svnadmin.sw.bypass_hooks" />
@@ -2181,8 +2308,11 @@
<refnamediv>
<refname>svnadmin upgrade</refname>
+ <!--
<refpurpose>Upgrade a repository to the latest supported
schema version.</refpurpose>
+ -->
+ <refpurpose>把仓库升级到 Subversion 支持的最新格式.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -2191,12 +2321,20 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>描述</title>
+ <!--
<para>Upgrade the repository located
at <replaceable>REPOS_PATH</replaceable> to the latest
supported schema version.</para>
+ -->
+ <para>把仓库 <replaceable>REPOS_PATH</replaceable> 升级到 Subversion
+ 支持的最新格式.</para>
+ <!--
<para>This functionality is provided as a convenience for
repository administrators who wish to make use of new
Subversion functionality without having to undertake a
@@ -2207,26 +2345,45 @@
and subsequent load guarantee the most optimized
repository state, <command>svnadmin upgrade</command> does
not.</para>
+ -->
+ <para>命令的目标是为了让管理员方便地对仓库进行升级, 而不用通过麻烦的
+ 转储和加载. 为了完成升级, <command>svnadmin upgrade</command> 只会
+ 完成最小量的工作, 同时保证仓库的完整性. 虽然转储和随后的加载操作可以
+ 保证得到一个处于最佳状态的仓库, 但 <command>svnadmin upgrade</command>
+ 却无法保证这点.</para>
<warning>
+ <!--
<para>You should <emphasis>always</emphasis> back up your
repository before upgrading.</para>
+ -->
+ <para>管理员在升级仓库前, 应该先对它进行备份.</para>
</warning>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Options</title>
<para>None</para>
+ -->
+ <title>选项</title>
+ <para>无</para>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>示例</title>
+ <!--
<para>Upgrade the repository at
path <filename>/var/repos/svn</filename>:</para>
+ -->
+ <para>升级仓库 <filename>/var/repos/svn</filename>:</para>
<informalexample>
<screen>
@@ -2257,7 +2414,10 @@
<refnamediv>
<refname>svnadmin verify</refname>
+ <!--
<refpurpose>Verify the data stored in the repository.</refpurpose>
+ -->
+ <refpurpose>验证仓库里的数据的完整性.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -2266,13 +2426,18 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>描述</title>
+ <!--
<para>Run this command if you wish to verify the integrity
of your repository. This basically iterates through all
revisions in the repository by internally dumping all
revisions and discarding the output—it's a good idea
to run this on a regular basis to guard against latent
+ ### TODO
hard disk failures and <quote>bitrot.</quote> If this
command fails—which it will do at the first sign of
a problem—that means your repository has at
@@ -2279,12 +2444,21 @@
least one corrupted revision, and you should restore the
corrupted revision from a backup (you did make a backup,
didn't you?).</para>
+ -->
+ <para>命令的目标是验证仓库的完整性. 基本上讲, 命令做的工作就是转储
+ 所有的版本号, 并丢弃输出—为了检测潜在的硬盘错误和
+ bitrot, 最好定期执行 <command>svnadmin verify</command>. 如果命令
+ 报错, 说明仓库内至少含有一个出错的版本号, 这时候管理员应该从备份
+ 恢复出错的版本号 (你备份过, 对吧?).</para>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>选项</title>
<informalexample>
<screen>
@@ -2297,9 +2471,15 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>示例</title>
+ <!--
<para>Verify a hung repository:</para>
+ -->
+ <para>验证一个挂起的仓库:</para>
<informalexample>
<screen>
More information about the svnbook-dev
mailing list