Version Control With Subversion Source

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.

As of revision 5618, repositories and working copies now use
README.txt instead of README, and they use local eol style in those
files. This revision makes the analogous change to
~/.subversion/README, and adjusts the book for all of these changes
(thanks to Mike Pilato for reminding me of the docs):

* subversion/libsvn_subr/config_impl.h
(SVN_CONFIG__USR_README_FILE): Add .txt extension.

* subversion/libsvn_subr/config_file.c
(svn_config_ensure): Use APR_EOL_STR instead of "\n".

* doc/book/book/ch05.xml, doc/book/book/ch06.xml,
doc/book/book/ch08.xml: Use the new filenames.

* ch06.xml: fix copy-n-pasto in sidebar.

Fix issue 1227.

* doc/book/book/ch08.xml
correct typo, 'svn create' should be 'svnadmin create'.

Submitted By: Dmitriy Popkov