Version Control With Subversion Source

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.

Patch contributed by Joel Rosdahl.

Various minor grammar and typographical changes to the Subversion
book.

* doc/book/book/appa.xml
* doc/book/book/appc.xml
* doc/book/book/appd.xml
* doc/book/book/appe.xml
* doc/book/book/ch02.xml
* doc/book/book/ch03.xml
* doc/book/book/ch05.xml
* doc/book/book/ch08.xml
* doc/book/book/glossary.xml

Made use of parentheses, quotes and commas consistent (using
"logical quoting"):

Like this: Not like this:
----------------------------------------
Foo (fie fum). Foo (fie fum.)
Foo "fie fum". Foo "fie fum."
Foo (fie), fum. Foo (fie,) fum.
Foo "fie", fum. Foo "fie," fum.
(Foo fie fum.) (Foo fie fum).
Foo (fie fum). Foo (Fie fum).

Added a missing space after a </quote>.

Corrected name of the extra files created when a merge conflict has
been detected.

Removed some left-over closing parentheses.

Use "an svn [...]" instead of "a svn [...]". There was a mixture of both.

Some other minor grammar fixes.

Improvements to the book.

* doc/book/book/ch01.xml
Split the list of programs into client-side and server-side.

* doc/book/book/ch03.xml
Fix an example of "svn resolved" usage.

* doc/book/book/ch08.xml
Use simpler syntax for indicating repeatable arguments, to match the built-in
help (issue 1377, r6525).
Move "propset" and "revert" subcommands to restore alphabetical order.
Fix simple errors in a few synopsis lines.
Demote the warning that "svnadmin" refers to the repository by a path rather
than a URL to a normal paragraph, because no danger is involved and to bring
it in line with the corresponding note for "svnlook".

* doc/book/book/appc.xml
Fix mark-up of an email address ("<email>" instead of "<address>").