[svnbook commit] r3171 - trunk/src/en/book
cmpilato
noreply at red-bean.com
Sat Jun 21 00:03:15 CDT 2008
Author: cmpilato
Date: Sat Jun 21 00:03:15 2008
New Revision: 3171
Log:
* book/ch03-advanced-topics.xml,
* book/ch02-basic-usage.xml
Note some further constraints on property names.
Modified:
trunk/src/en/book/ch02-basic-usage.xml
trunk/src/en/book/ch03-advanced-topics.xml
Modified: trunk/src/en/book/ch02-basic-usage.xml
==============================================================================
--- trunk/src/en/book/ch02-basic-usage.xml (original)
+++ trunk/src/en/book/ch02-basic-usage.xml Sat Jun 21 00:03:15 2008
@@ -210,14 +210,15 @@
can meaningfully be done (which is the case for most common
encodings in use today).</para>
- <para>In addition, path names are used as XML attribute values
- in WebDAV exchanges, as well as in some of Subversion's
- housekeeping files. This means that path names can contain
- only legal XML (1.0) characters. Subversion also prohibits
- TAB, CR, and LF characters in path names to prevent paths from
- being broken up in diffs or in the output of commands such as
- <command>svn log</command> or <command>svn
- status</command>.</para>
+ <para>In WebDAV exchanges and older versions of some of
+ Subversion's administrative files, paths are used as XML
+ attribute values, and property names in XML tag names. This
+ means that path names can contain only legal XML (1.0)
+ characters, and properties are further limited to ASCII
+ characters. Subversion also prohibits TAB, CR, and LF
+ characters in path names to prevent paths from being broken up
+ in diffs or in the output of commands such as <command>svn
+ log</command> or <command>svn status</command>.</para>
<para>While it may seem like a lot to remember, in practice
these limitations are rarely a problem. As long as your
Modified: trunk/src/en/book/ch03-advanced-topics.xml
==============================================================================
--- trunk/src/en/book/ch03-advanced-topics.xml (original)
+++ trunk/src/en/book/ch03-advanced-topics.xml Sat Jun 21 00:03:15 2008
@@ -298,14 +298,14 @@
two-column tables that map property names to arbitrary values
attached to each item in your working copy. Generally speaking,
the names and values of the properties can be whatever you want
- them to be, with the constraint that the names must be
- human-readable text. And the best part about these properties
- is that they, too, are versioned, just like the textual contents
- of your files. You can modify, commit, and revert property
- changes as easily as you can file content changes. And the
- sending and receiving of property changes occurs as part of your
- typical commit and update operations—you don't have to
- change your basic processes to accommodate them.</para>
+ them to be, with the constraint that the names must contain only
+ ASCII characters. And the best part about these properties is
+ that they, too, are versioned, just like the textual contents of
+ your files. You can modify, commit, and revert property changes
+ as easily as you can file content changes. And the sending and
+ receiving of property changes occurs as part of your typical
+ commit and update operations—you don't have to change your
+ basic processes to accommodate them.</para>
<note>
<para>Subversion has reserved the set of properties whose names
More information about the svnbook-dev
mailing list