Version Control With Subversion Source

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.

Introduce --force-log command-line client option.

* subversion/clients/cmdline/main.c
(svn_cl__options): Add '--force-log' option.
(svn_cl__cmd_table): Make "commit", "copy", "delete", "import",
"mkdir", and "move" take --force-log. Also, "commit" no longer
needs --force.
(main): Parse the --force-log option. Also, instead of recommending
that folks add --force when their log message -F sources are
versioned files or -m messages are path names, recommend the new
--force-log.

* subversion/clients/cmdline/cl.h
(svn_cl__force_log_opt): New.
(svn_cl__opt_state_t): Add 'force_log' member.

* subversion/tests/clients/cmdline/log_tests.py
(versioned_log_message): Replace use of --force with --force-log.

* doc/book/book/ch08.xml
Add --force-log description, and update the usage notes for
subcommands that use it.