git-svn: Expand documentation for --follow-parent
Describe what the option --follow-parent does, and what happens if it is set or unset. Signed-off-by: Sebastian Leske <sebastian.leske@sleske.name> Acked-by: Eric Wong <normalperson@yhbt.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Sebastian Leske committed
Nov 30, 2012 at 08:16 UTC
0d35bfe1beb7e6254742b2c1d0fb002abdfab8e9
1 file changed
+12
-3
Documentation/git-svn.txt
+12
-3
@@ -628,10 +628,19 @@ ADVANCED OPTIONS
628
Default: "svn"
629
630
--follow-parent::
631
+ This option is only relevant if we are tracking branches (using
632
+ one of the repository layout options --trunk, --tags,
633
+ --branches, --stdlayout). For each tracked branch, try to find
634
+ out where its revision was copied from, and set
635
+ a suitable parent in the first git commit for the branch.
636
This is especially helpful when we're tracking a directory
632
- that has been moved around within the repository, or if we
633
- started tracking a branch and never tracked the trunk it was
634
- descended from. This feature is enabled by default, use
637
+ that has been moved around within the repository. If this
638
+ feature is disabled, the branches created by 'git svn' will all
639
+ be linear and not share any history, meaning that there will be
640
+ no information on where branches were branched off or merged.
641
+ However, following long/convoluted histories can take a long
642
+ time, so disabling this feature may speed up the cloning
643
+ process. This feature is enabled by default, use
644
--no-follow-parent to disable it.
645
+
646
[verse]