Version Control With Subversion Source

This commit fixes two typos, and updates the rest of the registry example.

* doc/book/book/ch06.xml
Update Win32 Registry example:

Registry Sections:
(DEFAULT): changed to global
(groups, tunnel, auto-props): Added

Registry Keys:
(http-proxy-timeout): Changed to http-timeout.
(http-proxy-exceptions, neon-debug-mask, ssl-authority-files,
ssl-trust-default-ca, ssl-client-cert-file,
ssl-client-cert-password): Added to the "global" section.

(diff-cmd, diff3-cmd, diff3-has-program-arg): Added to the
"helpers" section.

(log-encoding, use-commit-times, template-root,
enable-auto-props): Added to the "miscellany" section.

Whatever the reason, it feels like the season
For purging nonsensical goo.
Trade "strict"-ness for stopping on encountered copies
And evenly blame the world, too.

* subversion/clients/cmdline/main.c
(svn_cl__options): Add new --stop-on-copy (svn_cl__stop_on_copy_opt) option.
(svn_cl__cmd_table): Lose the --strict option for 'svn blame' -- it
just doesn't make any sense to support that. Also, use the new
--stop-on-copy option instead of --strict for 'svn log'.
(main): Parse new --stop-on-copy option.

* subversion/clients/cmdline/cl.h
(svn_cl__longopt_t): Sort these, and add new svn_cl__stop_on_copy_opt.
(svn_cl__opt_state_t): Add 'stop_on_copy' member.

* subversion/clients/cmdline/blame-cmd.c
(svn_cl__blame): Update call to svn_client_blame.

* subversion/include/svn_client.h
* subversion/libsvn_client/blame.c
(svn_client_blame): Remove 'strict_node_history' parameter.

* subversion/clients/cmdline/log-cmd.c
(svn_cl__log): Use the --stop-on-copy option instead of --strict.

* subversion/tests/clients/cmdline/getopt_tests_data/svn_help_log_switch_stdout
Update test data.

* subversion/doc/book/book/ch08.xml
Update documentation for --strict and --stop-on-copy.

Fix a few typos in ch04 of the book.

Patch provided by Mason Thomas <mlt_svn@...>. Thanks, Mason!

Customize the book's HTML stylesheets so that <refentry> elements
which are children of <sect1> or <sect2> elements are represented
in the Table of Contents.

Move the book XSL customization parameters out of the Makefile into a
customization layer. This will allow for more extensive customization.

* doc/book/Makefile
(XSL_HTML, XSL_HTML_CHUNK): Point to customization layer.
(BOOK_HTML_XSLTPROC_OPTS): Remove --stringparam argument.

* doc/book/tools/html-stylesheet.xsl
New file. Customization layer for single-page html.

* doc/book/tools/chunk-stylesheet.xsl
New file. Customization layer for multiple-page html.

Minor fixes to the book.

* doc/book/Makefile
Remove an unused variable.

* doc/book/book/appd.xml
* doc/book/book/ch08.xml
Correct "xml" to "XML".
Correct an example of svn's output.

Resolve issue #1573: Move deltification out of the commit process.

Move post-commit deltification out of the commit process, exposing a
new public interface for the task. We make use of the new interface
in 'svnadmin load', deltifying each new revision after it is created,
because if you load a huge repository, and then deltify after the
operation is completely, Berkeley DB may never recover the extra space
used by the undeltified data.

I run 'svnadmin load' using a dumpfile of the first 5599 revisions of
the Subversion repository, and without deltification after each commit
was made. Then I used 'svnadmin deltify -r1:HEAD' on the database.
The combined clock-times for these operations was 160 minutes. The
combined logfile generation was 970 logfiles. The size of the
'strings' table after it was all said and done was 456 Megabytes --
which was exactly the same size it was *before* I ran the standalone
deltification. After the deltification, db_stat reported that I had
91,000 free pages in my 'strings' table.

Then I made 'svnadmin load' do the post-revision-creation
deltification, and re-ran my test (of course, this time without the
extra 'svnadmin deltify' command). Clock-time was 165 minutes.
Logfile generation, 970 logfiles. But the 'strings' table size was a
shockingly mere 80 Megabytes -- and db_stat reported only 110 free
pages.

The moral of the story: to keep your repository small, deltify early
and often.

* subversion/include/svn_fs.h
(svn_fs_deltify_revision): New.

* subversion/libsvn_fs/tree.c
(svn_fs_commit_txn): No longer perform post-commit predecessor
deltification.
(struct rev_get_txn_id_args): New baton.
(txn_body_rev_get_txn_id, svn_fs_deltify_revision): New functions.

* subversion/svnadmin/main.c
Sort subcommand function prototypes in alphabetical order, and add
one for svnadmin_deltify.
(cmd_table): Add 'deltify' subcommand ... again.
(subcommand_deltify): New (sorta).

* subversion/libsvn_repos/load.c
(close_revision): Explicitly deltify predecessors of paths changed
in each revision of the repository load.

* subversion/tests/libsvn_fs/fs-test.c
(file_integrity_helper): Deltify after each revision, because these
tests were written long ago partially to address problems that
occured during deltification.

* subversion/libsvn_repos/repos.c
(create_hooks): Add a call to 'svnadmin deltify' in the post-commit
hook template.

* doc/book/TODO
Add a TODO note about fixing the book with respect to deltification
stuffs.

Make the "rN" convention for revision numbers official:

* subversion/clients/cmdline/log-cmd.c
(log_message_receiver): Use "r" instead of "rev " when printing
revision numbers, and use pipe instead of colon as the first
separator, for consistency.

* subversion/tests/clients/cmdline/log_tests.py
(parse_log_output): Adjust accordingly.

* tools/dev/svn-dev.el
(svn-log-msg-boundary-regexp): Same.

* doc/book/book/ch03.xml,
doc/book/book/ch04.xml,
doc/book/book/ch08.xml: Same.

Merge /branches/partial-authz-dev to /trunk, r7571:7672.
See the branch for full log messages.

Here's my nutshell summary of the new 'partial read-authz feature':

If a client checks out or updates a tree, a server authz system now
has the ability to selectively deny read-access on arbitrary files and
dirs by supplying a authz_read_func to svn_repos_dir_delta(). In this
situation, dir_delta() will call new absent_file|dir editor
functions instead of the usual [open|add] functions. The DAV layer
now marshals these messages over the network, and libsvn_wc marks the
appropriate wc entries as 'absent'. Entries marked 'absent' are
essentially treated like 'deleted' ones; most client commands can't
see them at all. (But 'svn up' *does* report them to the server, in
case read-access is re-granted.)

(There are still a couple of small wc bugs, specifically triggered by
repeated granting/ungranting of read-access to files. They'll be
fixed RSN.)

Final note: this change upgrades working copies from format 2 to
format 3 'in place'. Format 1 wc's are no longer supported.

The use of the word "switch" after each switch (e.g. -u switch) could
be misconstrued to imply that the switch takes an argument. It also
clutters up the text unnecessarily. Remove it.

Patch provided by "John R. Daily" <jdaily@...>.

* doc/book/book/appa.xml: Be consistent.