Version Control With Subversion Source

I don't believe the word "logfile" is a real word, so changing to
"log file". Sleepycat's web page on log files has the words
separated.

* doc/book/book/ch03.xml,
doc/book/book/ch05.xml,
doc/book/book/ch06.xml,
doc/book/book/ch08.xml,
doc/book/book/appc.xml:
s/logfile/log file/.

Patch from Mason Thomas <mlt_svn@...>:

Fix a few things in the Subversion book.

* doc/book/book/ch03.xml: Fix typos and internal consistency. Change
a section heading because "Other Frequently Used Commands" really
aren't frequently used.

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.