[svnbook commit] r1353 - trunk/src/en/book
cmpilato
svnbook-dev at red-bean.com
Wed May 25 13:59:20 CDT 2005
Author: cmpilato
Date: Wed May 25 13:59:19 2005
New Revision: 1353
Modified:
trunk/src/en/book/ch05.xml
Log:
* src/en/book/ch05.xml
Lose the svnshell.py section.
Modified: trunk/src/en/book/ch05.xml
==============================================================================
--- trunk/src/en/book/ch05.xml (original)
+++ trunk/src/en/book/ch05.xml Wed May 25 13:59:19 2005
@@ -1617,124 +1617,6 @@
</sect3>
- <sect3 id="svn-reposadmin-maint-tk-svnshell.py">
- <title>svnshell.py</title>
-
- <para>The Subversion source tree also comes with a shell-like
- interface to the repository. The
- <command>svnshell.py</command> Python script (located in
- <filename>tools/examples/</filename> in the source tree)
- uses Subversion's language bindings (so you must have
- those properly compiled and installed in order for this
- script to work) to connect to the repository and filesystem
- libraries.</para>
-
- <para>Once started, the program behaves similarly to a shell
- program, allowing you to browse the various directories in
- your repository. Initially, you are
- <quote>positioned</quote> in the root directory of the
- <literal>HEAD</literal> revision of the repository, and
- presented with a command prompt. You can use the
- <literal>help</literal> command at any time to display a
- list of available commands and what they do.</para>
-
- <screen>
-$ svnshell.py /path/to/repos
-<rev: 2 />$ help
-Available commands:
- cat FILE : dump the contents of FILE
- cd DIR : change the current working directory to DIR
- exit : exit the shell
- ls [PATH] : list the contents of the current directory
- lstxns : list the transactions available for browsing
- setrev REV : set the current revision to browse
- settxn TXN : set the current transaction to browse
- youngest : list the youngest browsable revision number
-<rev: 2 />$
-</screen>
-
- <para>Navigating the directory structure of your repository is
- done in the same way you would navigate a regular Unix or
- Windows shell—using the <literal>cd</literal> command.
- At all times, the command prompt will show you what revision
- (prefixed by <literal>rev:</literal>) or transaction
- (prefixed by <literal>txn:</literal>) you are currently
- examining, and at what path location in that revision or
- transaction. You can change your current revision or
- transaction with the <literal>setrev</literal> and
- <literal>settxn</literal> commands, respectively. As in a
- Unix shell, you can use the <literal>ls</literal> command to
- display the contents of the current directory, and you can
- use the <literal>cat</literal> command to display the
- contents of a file.</para>
-
- <example id="svn-reposadmin-maint-tk-svnshell.py-ex-1">
- <title>Using svnshell to Navigate the Repository</title>
-
- <screen>
-<rev: 2 />$ ls
- REV AUTHOR NODE-REV-ID SIZE DATE NAME
-----------------------------------------------------------------------------
- 1 sally < 2.0.1> Nov 15 11:50 A/
- 2 harry < 1.0.2> 56 Nov 19 08:19 iota
-<rev: 2 />$ cd A
-<rev: 2 /A>$ ls
- REV AUTHOR NODE-REV-ID SIZE DATE NAME
-----------------------------------------------------------------------------
- 1 sally < 4.0.1> Nov 15 11:50 B/
- 1 sally < a.0.1> Nov 15 11:50 C/
- 1 sally < b.0.1> Nov 15 11:50 D/
- 1 sally < 3.0.1> 23 Nov 15 11:50 mu
-<rev: 2 /A>$ cd D/G
-<rev: 2 /A/D/G>$ ls
- REV AUTHOR NODE-REV-ID SIZE DATE NAME
-----------------------------------------------------------------------------
- 1 sally < e.0.1> 23 Nov 15 11:50 pi
- 1 sally < f.0.1> 24 Nov 15 11:50 rho
- 1 sally < g.0.1> 24 Nov 15 11:50 tau
-<rev: 2 /A>$ cd ../..
-<rev: 2 />$ cat iota
-This is the file 'iota'.
-Added this text in revision 2.
-
-<rev: 2 />$ setrev 1; cat iota
-This is the file 'iota'.
-
-<rev: 1 />$ exit
-$
-</screen>
- </example>
-
- <para>As you can see in the previous example, multiple
- commands may be specified at a single command prompt,
- separated by a semicolon. Also, the shell understands the
- notions of relative and absolute paths, and will properly
- handle the <literal>.</literal> and
- <literal>..</literal> special path components.</para>
-
- <para>The <literal>youngest</literal> command displays the
- youngest revision. This is useful for determining the range
- of valid revisions you can use as arguments to the
- <literal>setrev</literal> command—you are allowed to
- browse all the revisions (recalling that they are named with
- integers) between 0 and the youngest, inclusively.
- Determining the valid browsable transactions isn't quite as
- pretty. Use the <command>lstxns</command> command to list
- the transactions that you are able to browse. The list of
- browsable transactions is the same list that
- <command>svnadmin lstxns</command> returns, and the same
- list that is valid for use with <command>svnlook</command>'s
- <option>--transaction</option> option.</para>
-
- <para>Once you've finished using the shell, you can exit
- cleanly by using the <command>exit</command> command.
- Alternatively, you can supply an end-of-file
- character—Control-D (though some Win32 Python
- distributions use the Windows Control-Z convention
- instead).</para>
-
- </sect3>
-
<sect3 id="svn-reposadmin-maint-tk-bdbutil">
<title>Berkeley DB Utilities</title>
More information about the svnbook-dev
mailing list