# [PATCH 1/2] git-svn: documentation updates 3 messages from 2006-05-05 to 2006-05-05. Participants: Eric Wong. Thread: https://gitlist.dev/t/4076 ## Eric Wong, 2006-05-05 19:35 Subject: [0/2 PATCH] git-svn 1.0.0 release Message-ID: <11468577402388-git-send-email-normalperson@yhbt.net> URL: https://gitlist.dev/e/11468577402388-git-send-email-normalperson%40yhbt.net ``` It's been very solid for a long time now. I haven't run into any problems with it myself in a while, and no critical bugs that I know of exist. Labeling it 1.0.0 may make it look less scary to new users :) Thanks to all those who gave feedback. git-svn.perl | 8 +++++--- git-svn.txt | 45 ++++++++++++++++++++++++++++++++++----------- 2 files changed, 39 insertions(+), 14 deletions(-) ``` ## Eric Wong, 2006-05-05 19:35 Subject: [PATCH 1/2] git-svn: documentation updates Message-ID: <11468577403821-git-send-email-normalperson@yhbt.net> URL: https://gitlist.dev/e/11468577403821-git-send-email-normalperson%40yhbt.net In-Reply-To: <11468577402388-git-send-email-normalperson@yhbt.net> ``` * Clarify that 'init' requires an argument * Remove instances of 'SVN_URL' in the manpage, it's not an environment variable. * Refer to 'Additional Fetch Arguments' when documenting 'fetch' * document --authors-file / -A option Thanks to Pavel Roskin and Seth Falcon for bringing these issues to my attention. Signed-off-by: Eric Wong --- contrib/git-svn/git-svn.perl | 6 ++++-- contrib/git-svn/git-svn.txt | 45 ++++++++++++++++++++++++++++++++---------- 2 files changed, 38 insertions(+), 13 deletions(-) f16bddd18d55404fbaa4a88020f4d58ab2b1c620 diff --git a/contrib/git-svn/git-svn.perl b/contrib/git-svn/git-svn.perl index 7c44450..e003501 100755 --- a/contrib/git-svn/git-svn.perl +++ b/contrib/git-svn/git-svn.perl @@ -42,7 +42,8 @@ my %fc_opts = ( 'no-ignore-externals' => my %cmd = ( fetch => [ \&fetch, "Download new revisions from SVN", { 'revision|r=s' => \$_revision, %fc_opts } ], - init => [ \&init, "Initialize and fetch (import)", { } ], + init => [ \&init, "Initialize a repo for tracking" . + " (requires URL argument)", { } ], commit => [ \&commit, "Commit git revisions to SVN", { 'stdin|' => \$_stdin, 'edit|e' => \$_edit, @@ -220,7 +221,8 @@ when you have upgraded your tools and ha } sub init { - $SVN_URL = shift or croak "SVN repository location required\n"; + $SVN_URL = shift or die "SVN repository location required " . + "as a command-line argument\n"; unless (-d $GIT_DIR) { sys('git-init-db'); } diff --git a/contrib/git-svn/git-svn.txt b/contrib/git-svn/git-svn.txt index e18fcaf..f7d3de4 100644 --- a/contrib/git-svn/git-svn.txt +++ b/contrib/git-svn/git-svn.txt @@ -36,17 +36,22 @@ COMMANDS -------- init:: Creates an empty git repository with additional metadata - directories for git-svn. The SVN_URL must be specified - at this point. + directories for git-svn. The Subversion URL must be specified + as a command-line argument. fetch:: - Fetch unfetched revisions from the SVN_URL we are tracking. - refs/heads/remotes/git-svn will be updated to the latest revision. + Fetch unfetched revisions from the Subversion URL we are + tracking. refs/remotes/git-svn will be updated to the + latest revision. - Note: You should never attempt to modify the remotes/git-svn branch - outside of git-svn. Instead, create a branch from remotes/git-svn - and work on that branch. Use the 'commit' command (see below) - to write git commits back to remotes/git-svn. + Note: You should never attempt to modify the remotes/git-svn + branch outside of git-svn. Instead, create a branch from + remotes/git-svn and work on that branch. Use the 'commit' + command (see below) to write git commits back to + remotes/git-svn. + + See 'Additional Fetch Arguments' if you are interested in + manually joining branches on commit. commit:: Commit specified commit or tree objects to SVN. This relies on @@ -62,9 +67,9 @@ rebuild:: tracked with git-svn. Unfortunately, git-clone does not clone git-svn metadata and the svn working tree that git-svn uses for its operations. This rebuilds the metadata so git-svn can - resume fetch operations. SVN_URL may be optionally specified if - the directory/repository you're tracking has moved or changed - protocols. + resume fetch operations. A Subversion URL may be optionally + specified at the command-line if the directory/repository you're + tracking has moved or changed protocols. show-ignore:: Recursively finds and lists the svn:ignore property on @@ -123,6 +128,24 @@ OPTIONS repo-config key: svn.l repo-config key: svn.findcopiesharder +-A:: +--authors-file=:: + + Syntax is compatible with the files used by git-svnimport and + git-cvsimport: + +------------------------------------------------------------------------ +loginname = Joe User +------------------------------------------------------------------------ + + If this option is specified and git-svn encounters an SVN + committer name that does not exist in the authors-file, git-svn + will abort operation. The user will then have to add the + appropriate entry. Re-running the previous git-svn command + after the authors-file is modified should continue operation. + + repo-config key: svn.authors-file + ADVANCED OPTIONS ---------------- -b:: -- 1.3.2.ge3d7 ``` ## Eric Wong, 2006-05-05 19:35 Subject: [PATCH 2/2] git-svn 1.0.0 Message-ID: <11468577403171-git-send-email-normalperson@yhbt.net> URL: https://gitlist.dev/e/11468577403171-git-send-email-normalperson%40yhbt.net In-Reply-To: <11468577403821-git-send-email-normalperson@yhbt.net> ``` Signed-off-by: Eric Wong --- contrib/git-svn/git-svn.perl | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-) 3680a525691232e2f45f2bcf63458e547ff109ba diff --git a/contrib/git-svn/git-svn.perl b/contrib/git-svn/git-svn.perl index e003501..de13a96 100755 --- a/contrib/git-svn/git-svn.perl +++ b/contrib/git-svn/git-svn.perl @@ -8,7 +8,7 @@ use vars qw/ $AUTHOR $VERSION $GIT_SVN_INDEX $GIT_SVN $GIT_DIR $REV_DIR/; $AUTHOR = 'Eric Wong '; -$VERSION = '0.11.0'; +$VERSION = '1.0.0'; use Cwd qw/abs_path/; $GIT_DIR = abs_path($ENV{GIT_DIR} || '.git'); -- 1.3.2.ge3d7 ```