[svnbook] r3855 committed - * src/en/book/ch01-fundamental-concepts.xml...
svnbook at googlecode.com
svnbook at googlecode.com
Wed Jun 29 10:45:59 CDT 2011
Revision: 3855
Author: cmpilato at gmail.com
Date: Wed Jun 29 08:44:51 2011
Log: * src/en/book/ch01-fundamental-concepts.xml
(svn.advanced.reposurls): Rework this to avoid showing actual 'svn'
commandlines.
* src/en/book/styles.css
Treat informal examples similarly to regular examples.
http://code.google.com/p/svnbook/source/detail?r=3855
Modified:
/trunk/src/en/book/ch01-fundamental-concepts.xml
/trunk/src/en/book/styles.css
=======================================
--- /trunk/src/en/book/ch01-fundamental-concepts.xml Tue Jun 28 07:56:17
2011
+++ /trunk/src/en/book/ch01-fundamental-concepts.xml Wed Jun 29 08:44:51
2011
@@ -494,12 +494,18 @@
files and directories in Subversion repositories. For the
most part, these URLs use the standard syntax, allowing for
server names and port numbers to be specified as part of the
- URL:</para>
-
- <screen>
-$ svn checkout http://svn.example.com:9834/repos
-…
-</screen>
+ URL.</para>
+
+ <informalexample>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <simpara>http://svn.example.com/svn/project</simpara>
+ </listitem>
+ <listitem>
+ <simpara>http://svn.example.com:9834/repos</simpara>
+ </listitem>
+ </itemizedlist>
+ </informalexample>
<para>Subversion repository URLs aren't limited to only
the <literal>http://</literal> variety. Because Subversion
@@ -557,12 +563,16 @@
of <literal>localhost</literal> or no server name at
all:</para>
- <screen>
-$ svn checkout file:///var/svn/repos
-…
-$ svn checkout file://localhost/var/svn/repos
-…
-</screen>
+ <informalexample>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <simpara>file:///var/svn/repos</simpara>
+ </listitem>
+ <listitem>
+ <simpara>file://localhost/var/svn/repos</simpara>
+ </listitem>
+ </itemizedlist>
+ </informalexample>
<para>Also, users of the <literal>file://</literal> scheme on
Windows platforms will need to use an unofficially
@@ -573,17 +583,24 @@
<literal>X</literal> is the drive on which the repository
resides:</para>
- <screen>
-C:\> svn checkout file:///X:/var/svn/repos
-…
-C:\> svn checkout "file:///X|/var/svn/repos"
-…
-</screen>
-
- <para>In the second syntax, you need to quote the URL so that the
- vertical bar character is not interpreted as a pipe. Also, note
- that a URL uses forward slashes even though the native
- (non-URL) form of a path on Windows uses backslashes.</para>
+ <informalexample>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <simpara>file:///X:/var/svn/repos</simpara>
+ </listitem>
+ <listitem>
+ <simpara>file:///X|/var/svn/repos</simpara>
+ </listitem>
+ </itemizedlist>
+ </informalexample>
+
+ <para>Note that a URL uses forward slashes even though the
+ native (non-URL) form of a path on Windows uses backslashes.
+ Also note that when using
+ the <literal>file:///<replaceable>X</replaceable>|/</literal>
+ form at the command line, you need to quote the URL (wrap it
+ in quotation marks) so that the vertical bar character is not
+ interpreted as a pipe.</para>
<note>
<para>You cannot use Subversion's <literal>file://</literal> URLs
@@ -599,40 +616,26 @@
</note>
<para>The Subversion client will automatically encode URLs as
- necessary, just like a web browser does. For example, if a
- URL contains a space or upper-ASCII character as in the
- following:</para>
-
- <screen>
-$ svn checkout "http://host/path with space/project/españa"
-</screen>
-
- <para>then Subversion will escape the unsafe characters
- and behave as though you had typed:</para>
-
- <screen>
-$ svn checkout http://host/path%20with%20space/project/espa%C3%B1a
-</screen>
-
- <para>If the URL contains spaces, be sure to place it within
quotation
- marks so that your shell treats the whole thing as a single
- argument to the <command>svn</command> program.</para>
+ necessary, just like a web browser does. For example, the URL
+ <literal>http://host/path with space/project/españa</literal>
+ — which contains both spaces and upper-ASCII characters
+ — will be automatically interpreted by Subversion as if
+ you'd provided
+
<literal>http://host/path%20with%20space/project/espa%C3%B1a</literal>.
+ If the URL contains spaces, be sure to place it within
+ quotation marks at the command line so that your shell treats
+ the whole thing as a single argument to the program.</para>
<para>In Subversion 1.6, a new caret (<literal>^</literal>)
notation was introduced as a shorthand for <quote>the URL of
- the repository's root directory</quote>. For example:</para>
-
- <screen>
-$ svn list ^/tags/bigsandwich/
-</screen>
-
- <para>In this example, we're specifying a URL for
- the <filename>/tags/bigsandwich</filename> directory in the
- root of the repository. Note that this URL syntax works only
- when your current working directory is a working
+ the repository's root directory</quote>. For example, you can
+ use the <literal>^/tags/bigsandwich/</literal> to refer to the
+ URL of the <filename>/tags/bigsandwich</filename> directory in
+ the root of the repository. Note that this URL syntax works
+ only when your current working directory is a working
copy—the command-line client knows the repository's root
- URL by looking at the working copy's metadata. Note that when
- you wish to refer precisely to the root directory of the
+ URL by looking at the working copy's metadata. Also note that
+ when you wish to refer precisely to the root directory of the
repository, you must do so using <literal>^/</literal> (with
the trailing slash character), not merely
<literal>^</literal>.</para>
=======================================
--- /trunk/src/en/book/styles.css Sat Feb 6 22:14:40 2010
+++ /trunk/src/en/book/styles.css Wed Jun 29 08:44:51 2011
@@ -104,7 +104,7 @@
font-family: serif;
font-style: italic;
}
-.figure, .example, .table {
+.figure, .example, .informalexample, .table {
margin: 0.125in 0.25in;
}
.figure p.title b, .example p.title b, .table p.title b {
More information about the svnbook-dev
mailing list