[svnbook] r6029 committed - branches/1.8/zh/book
wuzhouhui at users.sourceforge.net
wuzhouhui at users.sourceforge.net
Sun Feb 16 02:31:05 UTC 2020
Revision: 6029
http://sourceforge.net/p/svnbook/source/6029
Author: wuzhouhui
Date: 2020-02-16 02:31:05 +0000 (Sun, 16 Feb 2020)
Log Message:
-----------
1.8/zh: resolve some TODO
Modified Paths:
--------------
branches/1.8/zh/book/ch03-advanced-topics.xml
branches/1.8/zh/book/ch04-branching-and-merging.xml
branches/1.8/zh/book/ch05-repository-admin.xml
branches/1.8/zh/book/ch06-server-configuration.xml
branches/1.8/zh/book/ch07-customizing-svn.xml
Modified: branches/1.8/zh/book/ch03-advanced-topics.xml
===================================================================
--- branches/1.8/zh/book/ch03-advanced-topics.xml 2020-02-08 13:57:00 UTC (rev 6028)
+++ branches/1.8/zh/book/ch03-advanced-topics.xml 2020-02-16 02:31:05 UTC (rev 6029)
@@ -5640,7 +5640,7 @@
</filename>, <filename>trunk/project2</filename>, <filename>
trunk/project3</filename> 等), 但是用户可能只关心其中的部分模块—
比如说项目的主要模块及其依赖模块. 用户可以分别检出他所关心的各个模块的
- 工作副本, 但是这些工作副本之间是分离的, 如果想同时对它们执行同一个操作
+ 工作副本, 但是这些工作副本之间是互不相交的, 如果想同时对它们执行同一个操作
就会很麻烦, 必须多次切换目录. 另一种选择是利用稀疏目录特性, 检出一个只
包含了感兴趣的模块的工作副本. 首先为模块的公共父目录检出一个深度为
<literal>empty</literal> 的工作副本, 然后按照深度 <literal>infinity
@@ -7628,7 +7628,7 @@
-->
<para>或许最令人失望的是由外部定义创建的工作副本与主工作副本 (属性 <literal>
svn:externals</literal> 所在的工作副本) 之间是分离的, 而且 Subversion
- 也只能操作不相交的工作副本. 也就是说如果你想要提交一个或多个外部工作副本
+ 也只能操作非正交的工作副本. 也就是说如果你想要提交一个或多个外部工作副本
里的修改, 你只能显式地在每个外部工作副本里执行 <command>svn commit
</command>—在主工作副本内提交并不会影响外部工作副本.</para>
@@ -7701,17 +7701,18 @@
<primary>working copies (工作副本)</primary>
<secondary>disjoint (不相交的)</secondary>
</indexterm>
+ 除了
<command>svn checkout</command>, <command>svn update</command>,
- <command>svn switch</command> 和 <command>svn export</command> 这些
- 命令实际上管理的是 <firstterm>不相交的</firstterm>
- (<firstterm>disjoint</firstterm>), 检出了外部定义的子目录, 但
- <command>svn status</command> 可以识别外部工作副本.
+ <command>svn switch</command> 和 <command>svn export</command> 外
+ (这些子命令实际上管理了 <firstterm>互不相交的</firstterm>
+ (<firstterm>disjoint</firstterm>) (或者说互相分离的), 检出了外部
+ 定义的子目录),
+ <command>svn status</command> 也可以识别外部工作副本.
<command>svn status</command> 为外部
工作副本所在的子目录显示字符 <literal>X</literal>, 然后递归地显示外部
工作副本内的各个项目的状态. 为子命令添加选项
<option>--ignore-externals</option> 将会禁止子命令处理外部定义.</para>
<!--
- ### TODO
Besides the <command>svn checkout</command>, <command>svn
update</command>, <command>svn switch</command>, and
<command>svn export</command> commands which actually manage the
Modified: branches/1.8/zh/book/ch04-branching-and-merging.xml
===================================================================
--- branches/1.8/zh/book/ch04-branching-and-merging.xml 2020-02-08 13:57:00 UTC (rev 6028)
+++ branches/1.8/zh/book/ch04-branching-and-merging.xml 2020-02-16 02:31:05 UTC (rev 6029)
@@ -6183,7 +6183,7 @@
necessitating regeneration of those changes with each successive
version of the third-party code that you track.</para>
-->
- <para>现在你面临一种非常有趣的情况. 你的项目可以使用几种分离的方式存放
+ <para>现在你面临一种非常有趣的情况. 你的项目可以使用几种互不相交的方式存放
第三方数据的定制化修改, 比如说使用补丁文件, 或文件和目录的成熟的替代
版本. 但是维护人员很快就会感到头疼,
因此迫切需要一种机制, 能够方便地把你的定制化修改应用到第三方代码上, 并
@@ -7043,7 +7043,6 @@
code lines. Now, these drawbacks might be less of an issue for
true exploratory branches aimed at experimenting with the future
of a codebase with no expectation of reintegrating the results
- TODO
back into the main development lines—mere policy needn't
be a vision-killer! But the simple fact remains that projects
generally benefit from an orderly approach to version control
@@ -7057,7 +7056,7 @@
在长期存在的分支上工作的开发人员有时候需要付出额外的努力, 以确保分支的
演化方向与同事的保持一致. 对于有些分支而言, 这些缺点都不算是问题, 因为
它们只是试探性的分支, 仅仅是在尝试代码库未来的发展方向, 将来不会被整合
- 到主线上. 但是有一个简单的
+ 到主线上—单纯的规范不一定会扼杀远见. 但是有一个简单的
事实不容忽视, 那就是代码及其修改如果能得到更多人的审查与理解, 那么对项目
而言通常是有好处的.</para>
Modified: branches/1.8/zh/book/ch05-repository-admin.xml
===================================================================
--- branches/1.8/zh/book/ch05-repository-admin.xml 2020-02-08 13:57:00 UTC (rev 6028)
+++ branches/1.8/zh/book/ch05-repository-admin.xml 2020-02-16 02:31:05 UTC (rev 6029)
@@ -269,7 +269,6 @@
<!--
<para>In the years since, the
newer <firstterm>FSFS</firstterm><footnote><para>While it is
- ### TODO
often pronounced <quote>fuzz-fuzz,</quote> per Jack
Repenning's rendition, this book assumes that the reader is
thinking <quote>eff-ess-eff-ess.</quote></para></footnote>
@@ -3228,7 +3227,6 @@
<para>Since Subversion stores your versioned history using, at
the very least, binary differencing algorithms and data
compression (optionally in a completely opaque database
- ### TODO
system), attempting manual tweaks is unwise if not quite
difficult, and at any rate strongly discouraged. And once
data has been stored in your repository, Subversion generally
@@ -3239,7 +3237,6 @@
your repository. You might need to strip out all instances of
a file that was accidentally added to the repository (and
shouldn't be there for whatever
- ### TODO
reason).<footnote><para>Conscious, cautious removal of certain
bits of versioned data is actually supported by real use
cases. That's why an <quote>obliterate</quote> feature has
@@ -3253,13 +3250,13 @@
Subversion repository dump format.</para>
-->
<para>因为 Subversion 在存储版本历史时, 大量地使用了二进制差异算法和
- 数据压缩 (在完全不透明的数据库系统中是可选的), 如果管理员觉得不是很
+ 数据压缩 (在完全封闭的数据库系统中是可选的), 如果管理员觉得不是很
困难而手工地修改历史, 这是非常不明智的做法, 大家应该极力避免这样操作.
数据一旦存储到仓库中, Subversion 通常不会允许管理员轻易地删除数据.
<footnote><para>这不正是你使用版本控制系统的原因吗?</para></footnote>
但总会出现需要修改仓库历史的情况, 例如从历史中抹去与某个文件相关的所
有记录, 这个文件出现在历史中只是个意外 (或者因为其他一些原因).
- <footnote><para>从版本化的数据中删除某些数据实际上是允许的,
+ <footnote><para>小心谨慎地从版本化的数据中删除某些数据实际上是允许的,
<quote>清除</quote> 特性是 Subversion 必须提供的功能之一, 也是
Subversion 开发人员想尽快实现的功能之一.</para></footnote> 又或者
是多个项目本来共享同一个仓库, 现在你想把它们分别存放到自己独享的一个
@@ -4321,7 +4318,6 @@
will not attempt to mirror any of those properties when they
are found in the source repository. The reason is probably
obvious, but basically boils down to
- ### TODO
<command>svnsync</command> not being able to distinguish the
special properties it has merely copied from the source
repository from those it needs to consult and maintain for
@@ -4334,8 +4330,9 @@
<para>关于这些记账属性的另一件有趣的事情是: 如果
<command>svnsync</command> 在源仓库也发现了这些记账用的属性,
那么 <command>svnsync</command> 不会对这些属性进行镜像操作.
- 原因是显然的, 但归结到 <command>svnsync</command> 身上, 其实是因
- 为它无法区分从从源仓库复制来的记账属性和自己用来记账的属性.
+ 原因是显然的, 归结到底, 其实是因为 <command>svnsync</command>
+ 无法区分从从源仓库复制来的属性, 和为了满足自己记账的需要而
+ 维护的属性.
如果用户在维护一个仓库的镜像的镜像, 就会出现这种情况, 当
<command>svnsync</command> 在源仓库版本号 0 上看到它自己的记账
属性时, 就会直接忽略它们.</para>
Modified: branches/1.8/zh/book/ch06-server-configuration.xml
===================================================================
--- branches/1.8/zh/book/ch06-server-configuration.xml 2020-02-08 13:57:00 UTC (rev 6028)
+++ branches/1.8/zh/book/ch06-server-configuration.xml 2020-02-16 02:31:05 UTC (rev 6029)
@@ -6834,7 +6834,6 @@
<!--
<para>Specifies the name of a Subversion repository for
use in <literal>HTTP GET</literal> responses. This
- ### TODO
value will be prepended to the title of all directory
listings (which are served when you navigate to a
Subversion repository with a web browser). This
Modified: branches/1.8/zh/book/ch07-customizing-svn.xml
===================================================================
--- branches/1.8/zh/book/ch07-customizing-svn.xml 2020-02-08 13:57:00 UTC (rev 6028)
+++ branches/1.8/zh/book/ch07-customizing-svn.xml 2020-02-16 02:31:05 UTC (rev 6029)
@@ -1434,7 +1434,6 @@
<!--
<para>The value of this option is the name of the
PKCS#11 provider from which an SSL client certificate
- ### TODO
will be drawn (if the server asks for one). This
setting is only honored by Subversion's Neon-based
HTTP provider module, which was removed in Subversion
More information about the svnbook-dev
mailing list