Version Control With Subversion Source

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.

Import syntax is now: svn import [PATH] URL. Parent directories in
URL are created as necessary. Testsuite and documentation updated as
well. Patch by David Kimdon <dwhedon@...>. Reviewed and with
some mods by cmpilato.

This completes issues #933 (svn import syntax is confusing; merge 1st
and 3rd arguments) and #735 (import should 'mkdir -p').

* subversion/include/svn_client.h
(svn_client_import): Remove 'new_entry' argument. Trailing entries
in URL that do not exist in the repository are considered to be a
new path to create.

* subversion/libsvn_client/commit.c
(import): Interpret 'new_entry' as a path to be created in the
repository within which the actual import will take place.
(get_ra_editor): Return an error if 'base_url' does not correspond
to a repository path.
(svn_client_import): If the first attempt to open a repository
session fails due to a non-existent URL, back up a directory and
try again. This allows us to create 'new_entry' dynamically
rather than requiring an argument.

* subversion/clients/cmdline/import-cmd.c
(svn_cl__import): 'import' now takes at most two rather than three
arguments. PATH now comes before URL.

* subversion/tests/clients/cmdline/basic_tests.py :
(basic_import): Update single file import test so parent directories
are created to hold the actual import.
(basic_import_executable, basic_import_ignores): Update usage of
'svn import'.

* subversion/tests/clients/cmdline/svntest/actions.py:
(guarantee_greek_repository): Switch the order of the import URL and
on-disk tree args.

* subversion/clients/cmdline/svn.1
* subversion/clients/cmdline/main.c
* doc/book/book/ch03.xml
* doc/book/book/ch05.xml
* doc/book/book/ch06.xml
* doc/book/book/ch08.xml
Update the import syntax descriptions.

Little book tweaks.

* book/book/ch05.xml: fix a couple of typos, and augment the server
feature-comparison list a wee bit.

Book work: revamp the 'svnserve' section, which was very out-of-date.

* book/book/ch05.xml: reorganize whole svnserve section, cover
missing topics like svn+ssh://, SVN_SSH, and others.

* book/TODO: add some things, remove some things.

* doc/book/TODO
* doc/book/book/ch06.xml
Fixup the Subversion book to not claim that .cvsignore files are
used recursively. Also, remove the TODO item regarding this change.
Patch by Roman Neuhauser <neuhauser@...>.

* doc/book/TODO: add some more items that need documenting

Revert revision 6173, as per list discussion: back to 'svn revert'
again, instead of 'svn undo', and we'll find some other way to resolve
issue #1341.