#64 Mistakes in 'svn Subcommands' : 'svn status'

[Anonymous]

Originally created by: chris...@gmail.com

The description states "The first seven columns …", isn't this nine columns now?

Following "The first column indicates that an item was added, deleted, or otherwise changed:" there is no 'G'
(merged) info.

Following "The sixth column is populated with lock information:" the K, O, T & B keys should be in single quotes (&
appear to be in the wrong font).  Also the description for ' ' would make more sense as "When --show-updates (-
u) is used, *this means* the file is not locked, otherwise this only means that the file is not locked in this working
copy."  (The *'s added to draw your attention.)

This is based on [r3643] of the PDF page 274.

It might also be useful to include the names that appear in the XML output alongside the characters.
Also noting things like "'C' - 'conflicted' - see also svn resolve/resolved" and "'X' - 'external' - see also svn
propset, svn:externals & Externals Definitions" would be informative.  After all this is the "Complete Reference" :-).

PS It's a shame that 'svn Subcommands' is 3 levels deep in the PDF's contents.

[Anonymous]

Originally posted by: cmpilato

(No comment was entered for this change.)

Owner: cmpilato

[Anonymous]

Originally posted by: cmpilato

Commenting in reverse order:

Yes, it is a shame that the reference chapter is atrociously formatted.  I'd like to remedy that somehow, and am considering breaking each major Reference section into its own appendix.

I like the idea of noting not only the letter code, but XML descriptive string, too.

I'll look into "The sixth column..." bit.

There actually is no 'G' status.  I mean, it exists in the Subversion codebase, but is unused.

Finally, no, there are seven local status columns, not nine.

Labels: Milestone-en-1.7

[Anonymous]

Originally posted by: chris...@gmail.com

> Finally, no, there are seven local status columns, not nine.

OK, but perhaps that should be stated/explained in the book, as it actually lists 9 columns.

Also `svn help status` (v1.6.15) displays, in the 'Example output:' section, the wrong number of columns in the first example and the 'out-of-date information' in the wrong column in examples 2 & 3.

[Anonymous]

Originally posted by: cmpilato

I think you're mentally lumping the local and remote status indication columns together.  The book says:

   The first seven columns ...

   The eighth column is always blank.

   The out-of-date information appears in the ninth column ...

As I said, there are seven *local status* columns.  The ninth column pertains to remote status, not local status.  The book is absolutely correct on this.

You are correct that the 'svn' 1.6.x binary's own built-in usage message is wrong, though.  I've filed http://subversion.tigris.org/issues/show_bug.cgi?id=3962 in the Subversion project's issue tracker.

[Anonymous]

Originally posted by: cmpilato

Bumping these out of the 1.7 milestone, not because I don't want to attack them in that timeframe, but because they don't necessarily block the completion of the 1.7 doc task.

Labels: Milestone-whenever

[Anonymous]

Originally posted by: cmpilato

(No comment was entered for this change.)

Owner: ---

[Anonymous]

Originally posted by: cmpilato

Integrated the suggestions that I cared to keep in [r4368].  I /may/ work in the XML status names at some point in the future, but I wasn't happy with the presentation when I did so naively today.  At any rate, closing this as Fixed.

Labels: -Milestone-whenever Milestone-en-1.8
Status: Fixed