summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/patchqueue/merge_patch.mdwn62
1 files changed, 62 insertions, 0 deletions
diff --git a/doc/patchqueue/merge_patch.mdwn b/doc/patchqueue/merge_patch.mdwn
new file mode 100644
index 000000000..2dcd9914e
--- /dev/null
+++ b/doc/patchqueue/merge_patch.mdwn
@@ -0,0 +1,62 @@
+svn's merge command has three twisty little syntaxes, none
+very DWIM-ish. For merging one file, apparently it is helpful
+to specify that file itself. [This patch][] does that.
+
+[This patch]: http://ikidev.betacantrips.com/patches/merge.patch
+
+The bug that this fixes is hard to demonstrate without
+generating a lot of noise, but you can get the idea by
+finding a file that was committed in a subdirectory and
+merging a change with it.
+
+ [apu]$ emacs one/test.mdwn
+ [apu]$ svn add one/test.mdwn
+ A one/test.mdwn
+ [apu]$ svn commit -m "Another test case for merging."
+ Adding one/test.mdwn
+ Transmitting file data .
+ Committed revision 42.
+ [apu]$ emacs one/test.mdwn
+ [apu]$ svn commit -m "Change."
+ Sending one/test.mdwn
+ Transmitting file data .
+ Committed revision 43.
+ svn merge -r38:39 ~/ikidevwc/patches/merge.patch
+ [apu]$ svn merge -r42:43 one/test.mdwn
+ svn: Cannot replace a directory from within
+ [apu]$ svn merge -r42:43 ~/ikidevwc/one/test.mdwn
+ svn: Cannot replace a directory from within`
+
+CGI.pm does a command much like the last one. However:
+
+ [apu]$ svn merge -r43:42 ~/ikidevwc/one/test.mdwn
+ svn: Cannot replace a directory from within
+ [apu]$ svn merge -r43:42 ~/ikidevwc/one/test.mdwn ~/ikidevwc/one/test.mdwn
+ U /home/glasserc/ikidevwc/one/test.mdwn
+
+In other words, merging works only when you specify
+the file, or, alternately:
+
+ [apu]$ cd one
+ [apu]$ svn merge -r42:43 ~/ikidevwc/one/test.mdwn
+ G test.mdwn
+
+... if you're in the same directory as the file. Note that if
+a file called "test.mdwn" happens to be where you are, it'll get
+changed! I think this is what is meant in `svn help merge` when
+it says:
+
+ If WCPATH is omitted, a default value of '.' is assumed, unless
+ the sources have identical basenames that match a file within '.':
+ in which case, the differences will be applied to that file.
+
+So, to conclude: when merging two revisions of a file, either specify
+the file, or be in the same directory as a file with the same name.
+This patch makes the former always happen, whereas previously the
+second would sometimes not happen. It also obviates the call to chdir.
+
+Source: [this message][] on the svn-user list.
+
+[this message]: http://svn.haxx.se/users/archive-2005-03/0926.shtml
+
+--Ethan \ No newline at end of file