Version Control With Subversion Source

* doc/book/TODO: new file. I'm tired of keeping this list to myself.

* ch07.xml: invalid xml in book source; add missing </para>.

Fix various grammar, typos, and no longer correct things in the book
documentation. Patch and log message graciously provided by David
Summers <david@...>.

* doc/book/book/ch03.xml : Grammar fix.

* doc/book/book/ch04.xml : Make example match commentary.

* doc/book/book/ch05.xml : Grammar fix.

* doc/book/book/ch07.xml : Grammar fix. Authentication data is no longer
stored in the .svn/auth working copy directories.

* doc/book/book/ch08.xml : Fix typo on "Revision".
Take out "+" in example prompt and program response.

Continue issue #730: restartable checkouts.

Make 'svn status' recognize incomplete directories. Also, fix a
buglet related to the new 'incomplete' flags, only now revealed by
'svn status'.

Mauve Bikeshed: show a "!" for incomplete dirs, just like missing
items, so that users realize that 'svn up' needs to be run.

[ People are still arguming, but let's try this out for a little
while. If we come up with a different consensus, or if this causes
disaster/confusion, we can always change it. ]

* libsvn_wc/entries.c, entries.h (svn_wc__entries_init): if 0 or -1 is
passed in as a revnum, then do *not* mark THIS_DIR as incomplete;
it's just a new directory being scheduled for addition.

* libsvn_wc/update_editor.c (close_directory): egads, stop having
close_directory() bump the directory revnum! this is old cruft, no
longer necessary, since the legitimate revnum is already installed
by open_dir() or add_dir().

* libsvn_wc/status.c (assemble_status): notice incompleteness in the
same place we recognize absence.

* svn_wc.h (enum svn_wc_status_kind): new 'incomplete' status enum.

* cmdline/status.c (generate_status_code): show a '!' for incompleteness.

* cmdline/main.c (svn_cl__cmd_table): augment 'svn help' description.

* book/ch03.xml, ch08.xml: update book's description of '!', and what
to do when you see it.

Ignore generated version.xml

Patch provided (with a small tweak) by"Bruce A. Mah"
<bmah@...>

Automatically include a version number in renditions of the book,
as reported by svnversion.

* doc/book/Makefile
($(BOOK_VERSION_SOURCE)): Generate a version.xml
file that defines the output of svnversion as an XML entity.
($(BOOK_HTML_TARGET), book-html-chunk, $(BOOK_PDF_TARGET),
$(BOOK_PS_TARGET)): Depend on the generated version.xml file.
book-clean: Remove the generated version.xml file.

* doc/book/book/book.xml: Include the generated version.xml file
and insert its svn.version entity in an appropriate place in the
title page.

Patch to license-type and URL for svnup, thanks to Patrick Mayweg.

* doc/book/book/appe.xml
Update svnup entry to correct license-type and URL.

I'm tired of newbies being burned by comparing 'trunk' and 'branch' when
merging a branch back into the trunk. Fitz, cmpilato... any chance we
could upload a new version to the svnbook.red-bean.com? :-)

* ch04.xml: add a new subsection to the chapter on 'svn merge', and do
a tiny bit of reorg on other subsections. describe the common
use-case of merging an entire branch back into trunk.

Patch from Francois Beausoleil:

* doc/book/book/ch06.xml: Use `license' instead of `foo' property.

Found one spelling mistake in svn_version.h that led to a spelling
mistake bug hunt.