summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorLibravatar Matthias Urlichs <smurf@smurf.noris.de>2005-10-11 18:13:30 +0200
committerLibravatar Matthias Urlichs <smurf@smurf.noris.de>2005-10-11 18:13:30 +0200
commit25f6f325d7a8f7cb686a9ffd9fa2c00b3aa85a60 (patch)
treebbbae48b900cb02baf7e5d7153fb8757e362086e /Documentation
parentsvn import: remove some CVS cruft (diff)
downloadtgif-25f6f325d7a8f7cb686a9ffd9fa2c00b3aa85a60.tar.xz
svn import: Add direct HTTP access
Some SVN repositories that are accessible through HTTP don't like when I retrieve files using SVN methods ("internal server error"). Therefore, I added an option to get the contents using (persistent) HTTP directly. This also reduces round-trip time, from two or three requests down to one. Also corrected error handling a bit. Signed-Off-By: Matthias Urlichs <smurf@smurf.noris.de>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/git-svnimport.txt28
1 files changed, 26 insertions, 2 deletions
diff --git a/Documentation/git-svnimport.txt b/Documentation/git-svnimport.txt
index 047f8f3346..a27a83596c 100644
--- a/Documentation/git-svnimport.txt
+++ b/Documentation/git-svnimport.txt
@@ -9,10 +9,11 @@ git-svnimport - Import a SVN repository into git
SYNOPSIS
--------
-'git-svnimport' [ -o <branch-for-HEAD> ] [ -h ] [ -v ]
+'git-svnimport' [ -o <branch-for-HEAD> ] [ -h ] [ -v ] [ -d | -D ]
[ -C <GIT_repository> ] [ -i ] [ -u ] [-l limit_nr_changes]
[ -b branch_subdir ] [ -t trunk_subdir ] [ -T tag_subdir ]
- [ -s start_chg ] [ -m ] [ -M regex ] [ <SVN_repository_URL> ]
+ [ -s start_chg ] [ -m ] [ -M regex ]
+ <SVN_repository_URL> [ <path> ]
DESCRIPTION
@@ -82,9 +83,32 @@ When importing incementally, you might need to edit the .git/svn2git file.
-v::
Verbosity: let 'svnimport' report what it is doing.
+-d::
+ Use direct HTTP requests if possible. The "<path>" argument is used
+ only for retrieving the SVN logs; the path to the contents is
+ included in the SVN log.
+
+-D::
+ Use direct HTTP requests if possible. The "<path>" argument is used
+ for retrieving the logs, as well as for the contents.
++
+There's no safe way to automatically find out which of these options to
+use, so you need to try both. Usually, the one that's wrong will die
+with a 40x error pretty quickly.
+
<SVN_repository_URL>::
The URL of the SVN module you want to import. For local
repositories, use "file:///absolute/path".
++
+If you're using the "-d" or "-D" option, this is the URL of the SVN
+repository itself; it usually ends in "/svn".
+
+<SVN_repository_URL>::
+ The URL of the SVN module you want to import. For local
+ repositories, use "file:///absolute/path".
+
+<path>
+ The path to the module you want to check out.
-h::
Print a short usage message and exit.