[svnbook] r5913 committed - branches/1.8/zh/book/ref-svn.xml
wuzhouhui at users.sourceforge.net
wuzhouhui at users.sourceforge.net
Sat Apr 20 21:15:54 CDT 2019
Revision: 5913
http://sourceforge.net/p/svnbook/source/5913
Author: wuzhouhui
Date: 2019-04-21 02:15:51 +0000 (Sun, 21 Apr 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-04-20 10:22:13 UTC (rev 5912)
+++ branches/1.8/zh/book/ref-svn.xml 2019-04-21 02:15:51 UTC (rev 5913)
@@ -6792,6 +6792,7 @@
-->
<title>描述</title>
+ <!--
<para>Print the value of a property on files,
directories, or revisions. The first form prints the
versioned property of an item or items in your working
@@ -6799,11 +6800,18 @@
properties on a repository revision. See <xref
linkend="svn.advanced.props"/> for more information on
properties.</para>
+ -->
+ <para>打印文件, 目录或版本号上的属性值. 命令的第一种形式打印工作副本
+ 里的一个或多个项目的属性值; 第二种形式打印版本号上的属性值. 关于属性
+ 的更多信息, 见 <xref linkend="svn.advanced.props"/>.</para>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>选项</title>
<informalexample>
<screen>
@@ -6822,10 +6830,16 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>示例</title>
+ <!--
<para>Examine a property of a file in your working
copy:</para>
+ -->
+ <para>查看工作副本中某个文件的属性值:</para>
<informalexample>
<screen>
@@ -6836,7 +6850,10 @@
</screen>
</informalexample>
+ <!--
<para>The same goes for a revision property:</para>
+ -->
+ <para>查看一个版本号的属性值:</para>
<informalexample>
<screen>
@@ -6845,9 +6862,13 @@
</screen>
</informalexample>
+ <!--
<para>For a more structured display of properties, use
- the <option>--verbose</option> (<option>-v</option>)
+ the <option>- -verbose</option> (<option>-v</option>)
option:</para>
+ -->
+ <para>为了获得更加结构化的输出, 可以加上选项 <option>--verbose</option>
+ (<option>-v</option>):</para>
<informalexample>
<screen>
@@ -6860,9 +6881,13 @@
</screen>
</informalexample>
+ <!--
<para>Examine the versioned properties inherited by a URL in
- your repository using the <option>--show-inherited-props
+ your repository using the <option>- -show-inherited-props
</option> option:</para>
+ -->
+ <para>为了查看继承而来的属性, 可以加上选项
+ <option>--show-inherited-props</option>:</para>
<informalexample>
<screen>
@@ -6875,6 +6900,7 @@
</screen>
</informalexample>
+ <!--
<para>By default, <command>svn propget</command> will append
a trailing end-of-line sequence to the property value it
prints. Most of the time, this is a desirable feature
@@ -6884,11 +6910,21 @@
in nature, but of some binary format (such as a JPEG
thumbnail stored as a property value, for example). To
disable pretty-printing of property values, use
- the <option>--strict</option> option.</para>
+ the <option>- -strict</option> option.</para>
+ -->
+ <para>默认情况下, <command>svn propget</command> 在打印完属性值后会额外
+ 打印一个换行符, 在大多数情况下这是一种比较合理的行为, 但有时候用户
+ 可能想精确地打印属性值, 比如属性值根本就不是纯文本, 例如 JPEG 缩略
+ 图. 为了禁止打印额外的换行符, 可以加上选项 <option>--strict</option>.
+ </para>
+ <!--
<para>Lastly, you can get <command>svn propget</command>
- output in XML format with the <option>--xml</option>
+ output in XML format with the <option>- -xml</option>
option:</para>
+ -->
+ <para>最后, 为了让 <command>svn propget</command> 以 XML 格式显示输出,
+ 可以加上选项 <option>--xml</option>:</para>
<informalexample>
<screen>
@@ -6921,7 +6957,10 @@
<refnamediv>
<refname>svn proplist (plist, pl)</refname>
+ <!--
<refpurpose>List all properties.</refpurpose>
+ -->
+ <refpurpose>列出所有的属性.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -6931,8 +6970,12 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>描述</title>
+ <!--
<para>List all properties on files, directories, or
revisions. The first form lists versioned properties in
your working copy, and the second lists unversioned remote
@@ -6939,11 +6982,18 @@
properties on a repository revision
(<replaceable>TARGET</replaceable> determines only which
repository to access).</para>
+ -->
+ <para>列出文件, 目录或版本号上的所有属性. 命令的第一种形式为工作副本里
+ 的项目列出属性; 第二种形式列出版本号上的属性 (可选参数
+ <replaceable>TARGET</replaceable> 指定仓库的 URL).</para>
</refsect1>
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>选项</title>
<informalexample>
<screen>
@@ -6962,10 +7012,16 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>示例</title>
+ <!--
<para>You can use <command>proplist</command> to see the properties on an
item in your working copy:</para>
+ -->
+ <para>显示工作副本中中的某个文件上已经设置了哪些属性:</para>
<informalexample>
<screen>
@@ -6977,10 +7033,15 @@
</screen>
</informalexample>
- <para>But with the <option>--verbose</option>
+ <!--
+ <para>But with the <option>- -verbose</option>
(<option>-v</option>) flag, <command>svn
proplist</command> is extremely handy as it also shows you
the values for the properties:</para>
+ -->
+ <para>加上选项 <option>--verbose</option> (<option>-v</option>) 后,
+ <command>svn proplist</command> 不仅会打印属性名, 还会打印属性值:
+ </para>
<informalexample>
<screen>
@@ -6995,9 +7056,13 @@
</screen>
</informalexample>
+ <!--
<para>List all the versioned properties inherited by a file in
- your working copy using the <option>--show-inherited-props
+ your working copy using the <option>- -show-inherited-props
</option> option:</para>
+ -->
+ <para>为了列出继承而来的属性, 可以加上选项
+ <option>--show-inherited-props</option>:</para>
<informalexample>
<screen>
@@ -7012,9 +7077,13 @@
</screen>
</informalexample>
+ <!--
<para>Lastly, you can get <command>svn proplist</command>
- output in XML format with the <option>--xml</option>
+ output in XML format with the <option>- -xml</option>
option:</para>
+ -->
+ <para>最后, 为了让 <command>svn proplist</command> 以 XML 格式显示输出,
+ 可以加上选项 <option>--xml</option>:</para>
<informalexample>
<screen>
@@ -7046,9 +7115,14 @@
<refnamediv>
<refname>svn propset (pset, ps)</refname>
+ <!--
<refpurpose>Set <replaceable>PROPNAME</replaceable>
to <replaceable>PROPVAL</replaceable> on files, directories,
or revisions.</refpurpose>
+ -->
+ <refpurpose>把文件, 目录或版本号上的属性
+ <replaceable>PROPNAME</replaceable> 的值设置成
+ <replaceable>PROPVAL</replaceable>.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -7058,8 +7132,12 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>描述</title>
+ <!--
<para>Set <replaceable>PROPNAME</replaceable> to
<replaceable>PROPVAL</replaceable> on files, directories,
or revisions. The first example creates a versioned, local
@@ -7068,11 +7146,20 @@
repository revision
(<replaceable>TARGET</replaceable> determines only which
repository to access).</para>
+ -->
+ <para>把文件, 目录或版本号上的属性 <replaceable>PROPNAME</replaceable>
+ 的值设置成 <replaceable>PROPVAL</replaceable>. 命令的第一种形式在工作
+ 副本的项目上设置或修改一个属性; 第二种形式为版本号设置或修改一个属性
+ (可选参数 <replaceable>TARGET</replaceable> 指定仓库的 URL).</para>
<tip>
+ <!--
<para>Subversion has a number of <quote>special</quote>
properties that affect its behavior. See <xref
linkend="svn.advanced.props.ref"/> for details.</para>
+ -->
+ <para>Subversion 预定义了很多 <quote>特殊</quote> 属性, 见 <xref
+ linkend="svn.advanced.props.ref"/>.</para>
</tip>
</refsect1>
@@ -7079,7 +7166,10 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>选项</title>
<informalexample>
<screen>
@@ -7099,9 +7189,15 @@
<!-- =============================================================== -->
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>示例</title>
+ <!--
<para>Set the MIME type for a file:</para>
+ -->
+ <para>为一个文件设置 MIME 类型:</para>
<informalexample>
<screen>
@@ -7110,8 +7206,11 @@
</screen>
</informalexample>
+ <!--
<para>On a Unix system, if you want a file to have the
executable permission set:</para>
+ -->
+ <para>在 Unix 系统中, 如果你希望文件具有可执行权限, 可以这样做:</para>
<informalexample>
<screen>
@@ -7120,8 +7219,11 @@
</screen>
</informalexample>
+ <!--
<para>Perhaps you have an internal policy to set certain
properties for the benefit of your coworkers:</para>
+ -->
+ <para>为了方便协作, 你可能需要设置自定义属性:</para>
<informalexample>
<screen>
@@ -7130,10 +7232,14 @@
</screen>
</informalexample>
+ <!--
<para>If you made a mistake in a log message for a
particular revision and want to change it, use
- <option>--revprop</option> and set <literal>svn:log</literal>
+ <option>- -revprop</option> and set <literal>svn:log</literal>
to the new log message:</para>
+ -->
+ <para>如果你不小心把一个版本号的日志写错了, 现在想把它改回来,
+ 可以这样做:</para>
<informalexample>
<screen>
@@ -7142,8 +7248,11 @@
</screen>
</informalexample>
+ <!--
<para>Or, if you don't have a working copy, you can
provide a URL:</para>
+ -->
+ <para>如果你没有工作副本, 可以使用仓库的 URL:</para>
<informalexample>
<screen>
@@ -7153,9 +7262,13 @@
</screen>
</informalexample>
+ <!--
<para>Lastly, you can tell <command>propset</command> to take its input from
a file. You could even use this to set the contents of a
property to something binary:</para>
+ -->
+ <para>最后, 还可以让 <command>svn propset</command> 从一个文件中获取属性
+ 值, 可以利用这个特性把属性设置成二进制内容:</para>
<informalexample>
<screen>
@@ -7165,6 +7278,7 @@
</informalexample>
<note>
+ <!--
<para>By default, you cannot modify revision properties
in a Subversion repository. Your repository
administrator must explicitly enable revision property
@@ -7172,6 +7286,11 @@
<literal>pre-revprop-change</literal>. See
<xref linkend="svn.reposadmin.hooks" /> for more
information on hook scripts.</para>
+ -->
+ <para>默认情况下, Subversion 禁止用户修改版本号的属性, 为了允许修改,
+ 仓库管理员必须通过创建钩子脚本 pre-revprop-change 来显式地允许
+ 用户修改版本号的属性. 关于钩子脚本的更多信息, 见
+ <xref linkend="svn.reposadmin.hooks" />.</para>
</note>
</refsect1>
More information about the svnbook-dev
mailing list