Version Control With Subversion Source

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.

Assuming "svn help list" is accurate, the output does not include a
column indicating the presence of properties; remove that from the
book.

While we're at it, change "updated" to "modified", since we're talking
about changes on the server, not in the working copy.

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

* doc/book/book/ch03.xml: Update docs.

Undo earlier search/replace error from rename of sample project
"write" to project "calc". Patch provided by "John R. Daily"
<jdaily@...>.

* doc/book/book/ch04.xml: Fix silly mistake.

* ch04.xml: wording clarification from Joe Drew <hoserhead@...>.