views:

276

answers:

4

The output of SVN merge has 4 columns of letters listed before the file name. I understand the meaning of the letters (mostly) but I can't find any information on the meanings of the columns and so only have a vague understanding based on context. Can anyone point me to the documentation on this?

Based on context I've been able to infer that column:

  1. Is about text changes to a file
  2. Seems to be related to use of the svn ignore command on a folder (or maybe it's just properties of the file?)
  3. I've never seen a letter in the third column and hence I have no idea what it means.
  4. Might be tree conflicts? This is the one I'm mostly worried about because I don't know how to handle it yet.
+3  A: 

You can find everything you need to know about subversion from http://svnbook.red-bean.com/. Your question is answered at http://svnbook.red-bean.com/en/1.5/svn.ref.svn.c.status.html.

coreyward
The question isn't answered at that page you specified. Firstly it talks about svn status, not svn merge. Also the fourth column is definitely different as my svn merge output has 'C' in the fourth column. It is possible that the first 3 columns are explained there though.
James
They use the same status codes. The status command reference explains all of the columns and status codes in all their gory detail.
coreyward
+1  A: 

With the links given by Corey, you can also look at this "Subversion Commands and Scripts". This page has detailed explanation about the svn commands. Also the detailed explanation for svn merge is available at 'svn merge'

Hope this helps.

Space
Thanks for the resource, but I have already looked over the red-bean svn book and there is no explanation of the columns in a SVN merge command. The SVN status command comes pretty close but isn't a full explanation. That "Subversion Commands and Scripts" page is a good summary too but also doesn't have what I asked for in the question. I'm guessing that the documentation for this feature simply isn't out there.
James
+1  A: 

By experimentation, the C's that shows up in the 3rd column in svn merge correspond to the C's that show up in the 7th column when I do an svn status. So, a C in the 3rd column from the merge command must correspond to the item being the victim of a tree conflict.

DNN
+2  A: 

James, I had the same issue - very frustrating not finding detailed "svn merge" info; however, in my google searches I found this posting: http://svn.haxx.se/users/archive-2008-06/0813.shtml

It indicates that the "svn merge" status letters are identical to the "svn update" status letters, which are actually documented. From the "svn help update" command:

For each updated item a line will start with a character reporting the action taken. These characters have the following meaning:

A  Added
D  Deleted
U  Updated
C  Conflict
G  Merged

A character in the first column signifies an update to the actual file, while updates to the file's properties are shown in the second column. A 'B' in the third column signifies that the lock for the file has been broken or stolen.

Brent Harsh