Version Control With Subversion Source

issue #1509: Add a reminder to document that users who change the
permissions on files directly or indirectly must manually fix up their
ownership of those files.

* doc/book/TODO: Add the above reminder.

* doc/book/TODO: Note setgid directory difference for the 1.1 fork.

The book is no longer a draft.

* doc/book/Makefile (book-version): Remove "Draft" appellation.

Book tweak.

* doc/book/book/ch06.xml: reword explanation of svnserve's CRAM-MD5 authn.
Emphasize the fact that the password never travels over the network.

Book patch from Archie Cobbs <archie@...>, tweaked by me.

* doc/book/book/ch09.xml (svnlook diff): show normal output for
binary-marked files. Note that non-textual mime-types don't show
their diffs.

Wrap the legal notice in a paragraph tag to avoid warning messages
when validating.

* book.xml: Fix warning.

Fix incorrect grammar and awkward phrasing in the book.

* doc/book/book/appb.xml
(svn-ap-b-sect-1.2.1): Insert a missing "a", and complete an incomplete
phrase. Also break up a run-on sentence.
(svn-ap-b-sect-1.2.8): Remove "which" that breaks the flow of the sentence.

* doc/book/book/ch03.xml
(svn-ch-3-sect-4.2): Fix an awkward sentence by removing an unnecessary
parenthetical phrase.
(svn-ch-3-sect-4.3.1): Change "of file" to "of the file".

* doc/book/book/ch05.xml
(svn-ch-5-sect-3.1.3): Remove an unnecessary "really" and a redundant "at
this point". Rewrite several awkward sentences.

* doc/book/book/ch06.xml
(svn-ch-6-sect-3.3): Change "as user" to "as the user".
(svn-ch-6-sect-4): Remove unnecessary "which".
(svn-ch-6-sect-4.4.2): Change "user" to "the user", and change a few other
awkward phrases.

* doc/book/book/ch07.xml
(svn-ch-7-sect-1.1): Remove unnecessary "again"
(svn-ch-7-sect-1.3.1): Fix an incomplete sentence, and change "semi-colon
delimited" to "semicolon-delimited".
(svn-ch-7-sect-2.2): Change "lossage" to "loss".
(svn-ch-7-sect-2.3.3): Break up run-on sentence with a colon.

* doc/book/book/ch08.xml
(svn-ch-8-dia-2): Change "Revisioning" to "Versioning".
(svn-ch-8-sect-1.1, svn-ch-8-sect-1.2.1, svn-ch-8-sect-1.2.3): Add a few
words to make sentences read better.
(svn-ch-8-sect-6.4): Remove redundant "actually".

* doc/book/book/ch09.xml
(svn-ch-9-sect-1.2): Change "in working copy" to "in your working copy".
Capitalize "id" where it occurs. Add a few missing words and punctuation.
(svn-ch-9-sect-3.2): Fix a misleading sentence: svnlook propget shows the
property values of a file, not the value of the file itself.

Fix small inconsistencies in command line examples in the book.

* doc/book/book/appb.xml
(svn-ap-b-sect-1.2.2): Change 'svn cleanup working-copy' to just 'svn
cleanup' since the text says to run it from the top of the WC.

* doc/book/book/ch02.xml
(svn-ch-2-sect-3.1): Change 'ls -a' to 'ls -A' since . and .. are not
shown in the output.

* doc/book/book/ch03.xml
(svn-ch-3-sect-4): Change revision 3678 to revision 2499 to be
consistent with all the other examples.

* doc/book/book/ch04.xml
(svn-ch-4-sect-2.1): Change trunk/ to trunk because trailing slashes
are not used that way in other examples.
(svn-ch-4-sect-6.2): Remove . and .. from ls output (no -a was given).

Add a sentence to the svnadmin Subcommand Reference.

* doc/book/book/ch09.xml:
Explicitly state that svnadmin hotcopy is safe to run on a live repository
that is being accessed by other processes. The wording is taken almost
exactly from chapter 5.

Add a few missing mentions of first-column 'X' in the svn status output.
This fixes issue #1898.

* doc/book/book/ch03.xml
(svn-ch-3-sect-4.3.1): Add 'X' to example output of svn status.

* doc/book/book/ch09.xml:
(svn-ch-9-sect-1.2): Add 'X' to complete svn status reference.