undef/git-commit-vandalism
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

git-svn: clarify explanation of --destination argument

Browse Source 
The existing documentation for "-d" does not make it obvious whether
its argument is supposed to be a full svn path, a partial svn path,
the glob from the config file, or what.  Clarify the text and add an
example to get the reader started.

Reported-by: Nathan Gray <n8gray@n8gray.org>
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Eric Wong <normalperson@yhbt.net>
This commit is contained in:
Jonathan Nieder 2011-12-19 19:24:30 -06:00 committed by Eric Wong
parent eff714bdda
commit 7d82b4af1c
1 changed files with 14 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
Documentation/git-svn.txt
View File

@ -271,13 +271,15 @@ first have already been pushed into SVN.
Create a tag by using the tags_subdir instead of the branches_subdir Create a tag by using the tags_subdir instead of the branches_subdir
specified during git svn init. specified during git svn init.
-d;; -d<path>;;
--destination;; --destination=<path>;;
If more than one --branches (or --tags) option was given to the 'init' If more than one --branches (or --tags) option was given to the 'init'
or 'clone' command, you must provide the location of the branch (or or 'clone' command, you must provide the location of the branch (or
tag) you wish to create in the SVN repository. The value of this tag) you wish to create in the SVN repository. <path> specifies which
option must match one of the paths specified by a --branches (or path to use to create the branch or tag and should match the pattern
--tags) option. You can see these paths with the commands on the left-hand side of one of the configured branches or tags
refspecs. You can see these refspecs with the commands
+ +
git config --get-all svn-remote.<name>.branches git config --get-all svn-remote.<name>.branches
git config --get-all svn-remote.<name>.tags git config --get-all svn-remote.<name>.tags
@ -1044,6 +1046,13 @@ Multiple fetch, branches, and tags keys are supported:
tags = tags/server/*:refs/remotes/project-a/tags/* tags = tags/server/*:refs/remotes/project-a/tags/*
------------------------------------------------------------------------ ------------------------------------------------------------------------
Creating a branch in such a configuration requires disambiguating which
location to use using the -d or --destination flag:
------------------------------------------------------------------------
$ git svn branch -d branches/server release-2-3-0
------------------------------------------------------------------------
Note that git-svn keeps track of the highest revision in which a branch Note that git-svn keeps track of the highest revision in which a branch
or tag has appeared. If the subset of branches or tags is changed after or tag has appeared. If the subset of branches or tags is changed after
fetching, then .git/svn/.metadata must be manually edited to remove (or fetching, then .git/svn/.metadata must be manually edited to remove (or