git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH] remove noise and inaccuracies from git-svn docs
@ 2011-04-18 14:46 Stefan Sperling
  2011-04-18 16:26 ` Matthieu Moy
  0 siblings, 1 reply; 16+ messages in thread
From: Stefan Sperling @ 2011-04-18 14:46 UTC (permalink / raw)
  To: git; +Cc: Stefan Sperling

---
 Documentation/git-svn.txt |   16 +++++++---------
 1 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/Documentation/git-svn.txt b/Documentation/git-svn.txt
index ea8fafd..a3b4c91 100644
--- a/Documentation/git-svn.txt
+++ b/Documentation/git-svn.txt
@@ -757,10 +757,9 @@ use `git svn rebase` to update your work branch instead of `git pull` or
 when committing into SVN, which can lead to merge commits reversing
 previous commits in SVN.
 
-DESIGN PHILOSOPHY
------------------
-Merge tracking in Subversion is lacking and doing branched development
-with Subversion can be cumbersome as a result.  While 'git svn' can track
+MERGE TRACKING
+--------------
+While 'git svn' can track
 copy history (including branches and tags) for repositories adopting a
 standard layout, it cannot yet represent merge history that happened
 inside git back upstream to SVN users.  Therefore it is advised that
@@ -770,16 +769,15 @@ compatibility with SVN (see the CAVEATS section below).
 CAVEATS
 -------
 
-For the sake of simplicity and interoperating with a less-capable system
-(SVN), it is recommended that all 'git svn' users clone, fetch and dcommit
+For the sake of simplicity and interoperating with Subversion,
+it is recommended that all 'git svn' users clone, fetch and dcommit
 directly from the SVN server, and avoid all 'git clone'/'pull'/'merge'/'push'
 operations between git repositories and branches.  The recommended
 method of exchanging code between git branches and users is
 'git format-patch' and 'git am', or just 'dcommit'ing to the SVN repository.
 
 Running 'git merge' or 'git pull' is NOT recommended on a branch you
-plan to 'dcommit' from.  Subversion does not represent merges in any
-reasonable or useful fashion; so users using Subversion cannot see any
+plan to 'dcommit' from because Subversion users cannot see any
 merges you've made.  Furthermore, if you merge or pull from a git branch
 that is a mirror of an SVN branch, 'dcommit' may commit to the wrong
 branch.
@@ -829,7 +827,7 @@ Renamed and copied directories are not detected by git and hence not
 tracked when committing to SVN.  I do not plan on adding support for
 this as it's quite difficult and time-consuming to get working for all
 the possible corner cases (git doesn't do it, either).  Committing
-renamed and copied files are fully supported if they're similar enough
+renamed and copied files is fully supported if they're similar enough
 for git to detect them.
 
 CONFIGURATION
-- 
1.7.3.5

^ permalink raw reply related	[flat|nested] 16+ messages in thread

end of thread, other threads:[~2011-05-05 20:34 UTC | newest]

Thread overview: 16+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-04-18 14:46 [PATCH] remove noise and inaccuracies from git-svn docs Stefan Sperling
2011-04-18 16:26 ` Matthieu Moy
2011-04-18 17:55   ` Junio C Hamano
2011-04-19  9:06     ` Stefan Sperling
2011-04-19  9:31     ` Stefan Sperling
2011-04-19 11:19       ` Michael J Gruber
2011-04-19 12:00         ` Stefan Sperling
2011-04-19 12:24           ` Michael J Gruber
2011-04-19 15:59             ` Piotr Krukowiecki
2011-05-05 19:13               ` git-svn and a new svn remote helper Matthew L Daniel
2011-05-05 20:25                 ` Sverre Rabbelier
2011-05-05 20:32                   ` Matthew Daniel
2011-05-05 20:33                     ` Sverre Rabbelier
2011-04-28 17:34       ` [PATCH] remove noise and inaccuracies from git-svn docs Stefan Sperling
2011-04-28 17:57         ` Michael Schubert
2011-04-29 10:39           ` Stefan Sperling

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).