Johan Herland
7091a2d0bf
Documentation/git-svn: Promote the use of --prefix in docs + examples
...
Currently, the git-svn defaults to using an empty prefix, which ends
up placing the SVN-tracking refs directly in refs/remotes/*. This
placement runs counter to Git's convention of placing remote-tracking
branches in refs/remotes/$remote/*.
Furthermore, combining git-svn with "regular" Git remotes run the risk
of clobbering refs under refs/remotes (e.g. if you have a git remote
called "tags" with a "v1" branch, it will overlap with the git-svn's
tracking branch for the "v1" tag from Subversion.
Even though the git-svn refs stored in refs/remotes/* are not "proper"
remote-tracking branches (since they are not covered by a proper git
remote's refspec), they clearly represent a similar concept, and would
benefit from following the same convention.
For example, if git-svn tracks Subversion branch "foo" at
refs/remotes/foo, and you create a local branch refs/heads/foo to add
some commits to be pushed back to Subversion (using "git svn dcommit),
then it is clearly unhelpful of Git to throw
warning: refname 'foo' is ambiguous.
every time you checkout, rebase, or otherwise interact with the branch.
At this time, the user is better off using the --prefix=foo/ (the
trailing slash is important) to git svn init/clone, to cause the
SVN-tracking refs to be placed at refs/remotes/foo/* instead of
refs/remotes/*. This patch updates the documentation to encourage
use of --prefix.
This is also in preparation for changing the default value of --prefix
at some point in the future.
Cc: Eric Wong <normalperson@yhbt.net >
Signed-off-by: Johan Herland <johan@herland.net >
Signed-off-by: Eric Wong <normalperson@yhbt.net >
2013-10-12 22:30:39 +00:00
..
2013-09-04 15:03:03 -07:00
2013-09-20 12:42:02 -07:00
2013-09-17 11:42:54 -07:00
2013-02-02 21:46:52 -08:00
2013-02-01 13:53:25 -08:00
2013-08-06 14:34:43 -07:00
2013-04-03 16:14:19 -07:00
2013-08-01 13:13:52 -07:00
2013-09-20 12:39:05 -07:00
2013-02-17 15:25:52 -08:00
2012-04-26 13:19:06 -07:00
2013-07-22 11:23:27 -07:00
2010-08-20 10:53:56 -07:00
2013-09-06 14:49:06 -07:00
2013-07-21 22:51:45 -07:00
2013-04-22 13:34:31 -07:00
2013-06-27 09:37:12 -07:00
2011-07-06 14:26:26 -07:00
2013-02-01 13:53:33 -08:00
2013-02-01 13:53:33 -08:00
2013-05-17 12:09:21 -07:00
2013-07-22 16:06:48 -07:00
2013-02-14 10:29:01 -08:00
2013-08-06 14:34:43 -07:00
2013-09-09 11:03:01 -07:00
2013-02-01 13:53:33 -08:00
2013-09-17 11:42:51 -07:00
2013-09-04 12:23:25 -07:00
2013-09-12 15:40:29 -07:00
2013-07-13 10:19:37 -07:00
2013-09-12 14:39:34 -07:00
2011-03-11 10:59:16 -05:00
2013-06-27 14:37:21 -07:00
2012-09-03 15:53:37 -07:00
2011-07-06 14:26:26 -07:00
2011-07-06 14:26:26 -07:00
2013-07-24 19:16:13 -07:00
2013-07-15 08:35:32 -07:00
2012-06-19 11:35:19 -07:00
2013-03-25 15:01:22 -07:00
2013-05-17 12:09:21 -07:00
2013-09-09 14:50:36 -07:00
2013-04-10 13:27:26 -07:00
2012-08-08 12:11:54 -07:00
2013-02-01 13:53:33 -08:00
2013-02-01 13:53:33 -08:00
2013-09-06 14:49:06 -07:00
2013-02-01 13:53:33 -08:00
2013-02-05 16:13:32 -08:00
2013-02-05 16:13:32 -08:00
2013-05-17 12:09:21 -07:00
2013-09-04 15:03:03 -07:00
2011-07-06 14:26:26 -07:00
2013-05-20 15:50:44 -07:00
2011-05-26 22:15:39 -07:00
2013-08-28 15:17:18 -07:00
2013-05-17 12:09:21 -07:00
2013-06-22 23:36:48 -07:00
2013-09-17 11:42:51 -07:00
2013-09-09 14:30:01 -07:00
2013-02-01 13:53:33 -08:00
2013-03-25 13:46:42 -07:00
2013-05-17 12:09:21 -07:00
2013-01-21 16:26:26 -08:00
2013-08-05 11:32:19 -07:00
2011-07-06 14:26:26 -07:00
2013-05-17 12:09:21 -07:00
2013-09-04 12:35:34 -07:00
2011-07-06 14:26:26 -07:00
2013-05-17 12:09:21 -07:00
2013-02-01 13:53:33 -08:00
2013-02-01 13:53:33 -08:00
2013-04-03 07:43:29 -07:00
2013-04-13 22:27:06 -07:00
2013-02-01 13:53:33 -08:00
2011-07-06 14:26:26 -07:00
2011-07-06 14:26:26 -07:00
2013-05-28 08:07:20 -07:00
2013-02-01 13:53:33 -08:00
2013-02-01 13:53:33 -08:00
2011-10-16 11:09:35 -07:00
2013-08-06 14:26:26 -07:00
2012-08-06 14:04:16 -07:00
2013-04-15 11:08:37 -07:00
2013-06-23 00:33:58 -07:00
2011-03-11 10:59:16 -05:00
2013-05-17 12:09:21 -07:00
2011-07-06 14:26:26 -07:00
2012-08-31 11:45:33 -07:00
2013-08-09 14:19:59 -07:00
2013-04-15 11:08:37 -07:00
2011-07-06 14:26:26 -07:00
2013-09-04 15:02:56 -07:00
2013-09-05 14:24:52 -07:00
2013-02-01 13:53:33 -08:00
2013-05-17 12:09:21 -07:00
2013-02-01 13:53:33 -08:00
2011-07-06 14:26:26 -07:00
2013-08-06 14:10:35 -07:00
2013-09-04 15:03:03 -07:00
2012-10-25 06:15:56 -04:00
2013-07-03 13:27:15 -07:00
2013-04-15 11:08:37 -07:00
2011-07-06 14:26:26 -07:00
2013-07-18 16:23:46 -07:00
2011-07-06 14:26:26 -07:00
2013-04-15 11:08:37 -07:00
2011-07-06 14:26:26 -07:00
2011-07-06 14:26:26 -07:00
2013-07-18 16:23:51 -07:00
2013-09-04 12:45:48 -07:00
2013-09-17 11:42:51 -07:00
2013-02-01 13:53:33 -08:00
2012-01-06 12:44:01 -08:00
2013-09-06 14:49:06 -07:00
2011-09-06 11:42:12 -07:00
2013-05-29 14:23:04 -07:00
2011-07-06 14:26:26 -07:00
2013-04-12 12:00:52 -07:00
2013-02-01 13:53:33 -08:00
2013-02-01 14:12:34 -08:00
2013-02-07 14:41:45 -08:00
2013-06-22 23:35:17 -07:00
2012-02-28 14:55:39 -08:00
2013-04-15 11:08:37 -07:00
2011-07-06 14:26:26 -07:00
2011-07-06 14:26:26 -07:00
2012-04-26 13:19:06 -07:00
2013-07-19 10:15:09 -07:00
2013-08-05 08:19:47 -07:00
2013-08-30 10:08:13 -07:00
2013-09-06 14:49:06 -07:00
2013-08-06 14:11:00 -07:00
2013-07-18 16:01:30 -07:00
2013-02-01 13:53:33 -08:00
2012-03-28 11:18:35 -07:00
2011-09-11 21:52:18 -07:00
2013-03-13 10:46:07 -07:00
2013-03-09 23:21:35 -08:00
2013-04-21 23:11:02 -07:00
2013-04-15 11:08:37 -07:00
2013-04-15 11:08:37 -07:00
2013-07-22 11:23:56 -07:00
2013-07-17 17:50:56 -07:00
2011-03-11 10:59:16 -05:00
2013-08-14 09:53:43 -07:00
2013-04-01 09:19:30 -07:00
2013-02-05 16:13:32 -08:00
2013-07-15 10:28:48 -07:00
2013-10-12 22:30:39 +00:00
2012-10-21 12:17:38 -07:00
2013-07-31 12:38:21 -07:00
2012-04-26 13:19:06 -07:00
2013-04-12 12:00:52 -07:00
2011-07-06 14:26:26 -07:00
2011-07-06 14:26:26 -07:00
2013-05-17 12:09:21 -07:00
2013-09-09 09:54:37 -07:00
2011-07-06 14:26:26 -07:00
2013-02-01 13:53:33 -08:00
2013-02-01 13:53:33 -08:00
2013-02-01 13:53:33 -08:00
2013-04-15 11:08:37 -07:00
2013-04-15 11:08:37 -07:00
2013-06-21 09:05:15 -07:00
2013-08-13 09:01:54 -07:00
2011-07-06 14:26:26 -07:00
2013-09-20 12:35:42 -07:00
2013-02-01 13:53:33 -08:00
2013-09-04 15:03:03 -07:00
2013-08-13 09:01:52 -07:00
2013-02-01 13:53:33 -08:00
2013-09-06 14:49:06 -07:00
2013-06-03 10:53:11 -07:00
2013-02-01 13:53:33 -08:00
2013-04-15 11:08:37 -07:00
2013-02-05 16:13:32 -08:00
2013-02-01 13:53:33 -08:00
2013-02-01 13:53:33 -08:00
2013-02-01 13:53:33 -08:00
2013-09-12 14:41:50 -07:00
2013-06-09 13:45:32 -07:00
2013-02-01 13:53:33 -08:00
2013-04-15 11:08:37 -07:00
2013-02-01 13:53:33 -08:00
2013-07-04 21:52:15 -07:00
2013-07-22 16:06:48 -07:00
2013-02-01 13:53:33 -08:00
2013-09-17 11:42:51 -07:00
2013-02-01 13:53:33 -08:00
2013-02-01 13:53:33 -08:00
2011-11-08 13:37:10 -08:00
2010-09-09 16:17:59 -07:00
2013-08-06 14:48:02 -07:00
2013-01-05 23:41:42 -08:00
2013-06-17 13:11:56 -07:00
2013-02-07 14:42:16 -08:00
2013-07-03 15:36:30 -07:00
2013-04-05 10:57:23 -07:00
2013-04-23 11:22:48 -07:00
2013-08-05 08:19:47 -07:00
2013-05-12 15:23:48 -07:00
2013-08-05 13:00:20 -07:00
2013-09-20 12:38:10 -07:00
2011-11-22 18:16:59 -08:00
2013-08-01 13:13:52 -07:00
2013-02-01 13:53:33 -08:00
2013-07-21 22:51:24 -07:00
2012-08-07 14:30:52 -07:00
2013-09-17 11:42:54 -07:00