Version Control With Subversion Source

* doc/book/book/ch05.xml
* doc/book/book/ch06.xml
* doc/book/book/ch07.xml
Make some fixes recommended by Garrett Rooney. Leave some TODOs as
well.

Finish issue #959 - svn:externals should cooperate with 'svn status'

* subversion/include/svn_wc.h
Re-order some stuff for dependency's sake.
(svn_wc_status_external): New.
(svn_wc_statuses): Add 'traversal_info' paramater.

* subversion/libsvn_client/client.h
* subversion/libsvn_client/externals.c
(svn_client__recognize_externals): New.

* subversion/libsvn_wc/status.c
(get_dir_status): Add 'traversal_info' parameter, and populate that
sucker when the opportunity presents itself.
(svn_wc_statuses): Add 'traversal_info' paramater. Update call to
get_dir_status().

* subversion/libsvn_client/delete.c
(svn_client__can_delete): Update call to svn_wc_statuses().

* subversion/libsvn_client/status.c
(svn_client_status): Update call to svn_wc_statuses(), passing a
traversal info structure. Then, use the new
svn_client__recognize_externals() function to fixup the status hash.

* subversion/clients/cmdline/status.c
(generate_status_code): Return 'X' for svn_wc_status_external.

* subversion/clients/cmdline/main.c
(svn_cl__cmd_table): Document the new 'X' for status output.

* subversion/doc/book/book/appa.xml
* subversion/doc/book/book/ch03.xml
Document the new 'X' status indicator.

Begin incorporating comments from Garrett Rooney's Most Excellent
Technical Adventure, umm, err, Review.

* doc/book/book/ch03.xml, doc/book/book/ch08.xml: Incorporate comments
from review.

* doc/book/TODO: reorganize book-work a bit.

* doc/book/book/appe.xml: fix URL for jsvn, at David Golpira's request.

* ch02.xml: book tweak, add svn+ssh:// to chapter 2 table.

* book/ch05.xml, TODO: fix typo, add more TODO items

Fix a few "svn import" examples in the book to use the syntax introduced in
rev 6288. Thanks to Mark Proctor <m.proctor@...> for noticing.

Note: svnbook.red-bean.com is at r6204:6215.

* doc/book/book/appc.xml
(Problems using Subversion): fix a few import examples.

Minor documentation updates contributed by Julian Foad
<julianfoad@...>. Thanks, Julian!

* doc/book/book/ch01.xml
Grammar fix.

* doc/book/book/ch05.xml
Grammar fix.

* doc/book/book/ch08.xml
Grammar fix.
Change a note that explains that not log output means no change from
a "warning" to a "tip", because it is not a dangerous situation.

* doc/README
Update quoting rules to reflect the fact that we prefer <quote>, which
is not the standard practice in texinfo.

Create 'svnadmin archive' subcommand.

Just as what used to happen with 'db_recover', a lot of users are now
running the wrong version of 'db_archive'. So we're wrapping this BDB
function in svnadmin, so it will always Just Work (correct library
version, no need to remember -a or -h flags.)

IMO, 'svnadmin archive' and 'svnadmin recover' are the only two
BDB maintenance commands that svn admins really need to know, and
hopefully svnadmin has made them easier to use.

* libsvn_fs/fs.c, svn_fs.h (svn_fs_berkeley_archive): new wrapper
around the bdb ENV->archive() function.

* svnadmin/main.c (svn_opt_subcommand_t, cmd_table): add 'archive' subcommand.
(subcommand_archive): new function.

* project_faq.html: mention 'svnadmin archive' in FAQ.

* book/ch05.xml (Berkeley DB Utilities): show example of 'svnadmin archive'.

* book/ch08.xml (svnadmin): document new subcommand.