Version Control With Subversion Source

Kill 'svnadmin createtxn'. Cruft today, gone tomorrow.

* subversion/svnadmin/main.c
(subcommand_createtxn): Buh-bye.
(cmd_table): Remove junk related to the 'createtxn' subcommand.

* subversion/tests/clients/cmdline/svnadmin_tests.py
(create_txn): Remove (there is no more 'createtxn').
(remove_txn): Remove (I dunno how to force the creation of a
dangling, uncommitted transaction).
(test_list): Lose references to removed tests.

* subversion/doc/book/book/ch05.xml
Try to get the svnadmin subcommands list back into sync with the app.

Applied patch by Vincent Lefèvre.

* doc/book/book/ch08.xml
Corrected grammar in the "Examples" section.

Improve the book Makefile so it updates when it should and doesn't when it
shouldn't. It was always updating book-html-chunk, and never updating the
embedded revision number.

* doc/book/Makefile
Re-check the output of "svnversion" every time, but only update version.xml
if the revision number has changed. (Previously version.xml was never
updated unless it had been deleted.)
Only rebuild book-html-chunk if it is older than its (main) source files.
(Previously it was re-built every time.)
The image files are now dependencies of most targets.

* doc/book/book/ch07.xml
Corrected grammar in the "Get the Source Code" section.

Clarify. Rinse. Repeat.

* ch04.xml: Added footnotes about copy/move being single repository
only, as well as info and an xref on --relocate.

Miscellaneous minor fixes to the book.

* doc/book/book/appa.xml
Option name for "non-recursive" is "-N" not "-n".
Output of "svn status" no longer begins with "_".

* doc/book/book/appc.xml
Apply "<command>" style to program name "tethereal".
Fix capitalisation.

* doc/book/book/ch02.xml
* doc/book/book/ch03.xml
* doc/book/book/ch06.xml
Fix capitalisation, punctuation, etc.

Working through my book TODO list:

- Documented how to use 'svn co' to restart an interrupted checkout.

- Documented new 'svn st' symbol for incomplete directories ("!")

- Mentioned that killing $EDITOR without saving changes gives the
option to abort a commit.

- Pointed out that 'svn rm URL URL URL [...]' is now a single commit.
Same with 'svn mkdir dir1 dir2 dir3 [...]'

- Clarified that 'svn copy/move' *only* works within a single
repository. cross-repository copying is a post-1.0 feature.

- Documented 'svn switch --relocate'.

- 'svn import' syntax changed. Updated everywhere.

- Clarified that 'svn st -u' only adds an asterisk; it does *not* make
the entire record reflect the repository's version of the file.

* doc/book/TODO: Remove done items. Switched them to past tense and
added them to the commit message above. Phear my mAd SKillz!!1!!
* doc/book/book/appc.xml: Tweaks.
* doc/book/book/ch05.xml: Tweaks.
* doc/book/book/ch08.xml: Tweaks.

- "Quick Walkthrough" modified (Added information about ra_svn).
- Russian translation of "Quick Walkthrough" added.

Mostly finish issue #1445: give 'svn checkout/update/revert' the
optional ability to set last-commit timestamps on working files. This
ability is turned off by default, and be activated by a new runtime
config variable: "[miscellany] --> use-commit-times = yes". These
four commands either all use current timestamps, or all use commit
timestamps.

'svn export' already sets last-commit timestampss, so the rest of this
issue is simply waiting for a new apache (apr) release; at that point,
we simply uncomment the code in svn_io_set_file_affected_time(), and
poof, the issue is done.

* libsvn_wc/update_editor.c
(struct edit_baton): new 'use_commit_times' boolean field.
(make_editor): take 'use_commit_times' argument.
(svn_wc_get_switch_editor): take 'use_commit_times' arg.
(svn_wc_get_update_editor): take 'use_commit_times' arg.

(struct file_baton): new 'last_changed_date' field.
(change_file_prop): if use_commit_times, cache file's last-changed-date.
(install_file): take new 'timestamp_string' argument, and if
non-NULL, write a log command to set timestamp on final working file.
(close_file): pass fb->last_changed_date into install_file().
(svn_wc_add_repos_file): pass NULL into install_file().

* include/svn_wc.h
(svn_wc_get_update_editor, svn_wc_get_switch_editor, svn_wc_revert):
take new 'use_commit_times' arg.

* libsvn_wc/log.h
(SVN_WC__LOG_SET_TIMESTAMP): new log command.
(SVN_WC__LOG_ATTR_TIMESTAMP): new log attribute.

* libsvn_wc/log.c
(log_do_file_readonly): unrelated cleanup -- remove unused args!
(start_handler): dispatch SET_TIMESTAMP and READONLY commands correctly.
(log_do_file_timestamp): new function which sets timestamp.

* include/svn_config.h
(SVN_CONFIG_OPTION_USE_COMMIT_TIMES): new run-time config variable
in [miscellany] section of config file.

* libsvn_subr/config_file.c
(svn_config_ensure): document new variable in default config file.

* libsvn_client/switch.c
(svn_client_switch): look for new config variable, pass into
svn_wc_get_switch_editor().

* libsvn_client/update.c
(svn_client__update_internal): look for new config variable, pass
into svn_wc_get_update_editor().

* libsvn_wc/adm_ops.c
(svn_wc_revert): new 'use_commit_times' arg, pass to revert_admin_things().
(revert_admin_things): new 'use_commit_times' arg -- use it to set
timestamp on a working file that is copied back out from text-base.

* libsvn_client/revert.c
(svn_client_revert): look for new config variable, pass to svn_wc_revert().

* doc/book/TODO: note need to doc new variable.

Book and FAQ: update the information on using a Windows drive letter in a
"file:" URL. Supercedes the patch in issue 1306, so closing that issue.

* doc/book/book/appc.xml
Replace the FAQ about working around the inability to specify a drive letter
with one that points to the section on how to do it.
* doc/book/book/ch02.xml
Give the "Repository URLs" side bar an "id" so I can create links to it.
Correct, update and explain the examples of using a drive letter in a URL.
* www/project_faq.html
Replace the FAQ about working around the inability to specify a drive letter
with one that gives a brief example of how to do it and a link to the book.