Version Control With Subversion Source

Some clarifications and minor corrections to the Subversion book.
Patch from Julian Foad <julianfoad@...>.

* doc/book/book/ch03.xml:
Change wording to encourage users to issue "svn resolve" rather than
removing the temporary files manually. Change of emphasis for clarity.
Insert a missing word.

* doc/book/book/ch08.xml:
Explain why "ci" and not "co" is the abbreviation for "commit". Fix
spelling.

* doc/book/book/ch02.xml:
* doc/book/book/ch04.xml:
* doc/book/book/ch05.xml:
* doc/book/book/ch06.xml:
* doc/book/book/ch07.xml:
Grammer/typo/spelling/mdash fixes.

Fix WebDAV RFC number. Noted by Tez Kamihira.

* doc/book/book/ch07.xml: Change "RFC 3256" to "RFC 3253."

* notes/webdav-general-summary: Likewise.

Remove out-of-date comments.

* doc/book/book/appa.xml, doc/book/book/ch04.xml,
doc/book/book/ch06.xml: Remove out-of-date comments.

Resolves Issue #1076:
- print 'I' (not '?') for ignored files when named explicitly on the
command line, or when --no-ignores is used.
- print nothing for nonexistent files (unversioned and do not exist on disk)

* subversion/include/svn_wc.h
(enum svn_wc_status_kind): Add status kind svn_wc_status_ignored.

* subversion/libsvn_wc/status.c
(assemble_status): Set text_status to svn_wc_status_ignored
for ignored files.
(collect_ignore_patterns): New function, extracted from
add_unversioned_items.
(add_unversioned_item): New function, extracted from
add_unversioned_items.
(add_unversioned_items): Extract helper functions mentioned above.
(svn_wc_statuses): If there is no entry for PATH, handle it
correctly as an unversioned item.

* subversion/clients/cmdline/status.c
(generate_status_code): Return 'I' for svn_wc_status_ignored.
(svn_cl__print_status_list): Skip printing items whose status is
svn_wc_status_none.

* subversion/clients/cmdline/main.c
(svn_cl__cmd_table): Add 'I' to output of 'svn help status'.

* subversion/tests/clients/cmdline/stat_tests.py
(status_for_unignored_file)
[renamed from status_blank_for_unignored_file]: Check that text
status is 'I' for a file marked ignored, if specified explicitly
or --no-ignores is given.
(status_for_nonexistent_file): Check that no output is given for a
file that is not versioned and does not exist.

* doc/book/book/ch06.xml
Give example of using 'svn status --no-ignore'

* doc/book/book/ch08.xml
Add explanation of 'I' to 'svn status' reference

Patch from Mason Thomas.

* doc/book/book/ch00.xml: Correct English usage.

Patch from Larry Shatzer.

* doc/book/book/ch03.xml: Conform to O'Reilly Style Guide.

* doc/book/book/ch06.xml: Likewise.

* doc/book/book/ch07.xml: Likewise.

* doc/book/book/appd.xml: Likewise.

Patch from Larry Shatzer.

* doc/book/book/ch07.xml: Conform to the O'Reilly Style Guide.

* doc/book/book/appd.xml: Likewise.

Patch from Brian Denny <brian@...>:

Resolves issue #785:

* merge-cmd.c (svn_cl__merge): If no target path was specified, try to
infer it from the source path(s).

* main.c (svn_cl__cmd_table): Document the new use case in the output
of 'svn help merge'. Also, refer to arguments as two "sources" and
a wc "target". [rewritten by sussman]

* merge_tests.py (merge_with_implicit_target): New test function.
Merges a file, specifying a revision range and source file/URL but
no target path. [docstring tweaked by sussman; also move #1176
docstring into issue comment, so docstring fits on one line during run.]

* ch04.xml: Explain the conditions under which 'svn merge' can infer a
target path. [tweaked by sussman]

* ch08.xml: Document the new use case in the reference section for
'svn merge', copying from 'svn help merge' text. Add an example.
[tweaked by sussman]

Little doc tweaks.

* README: the documentation is not in info format, nor is it built
automatically anymore. update with Subversion Book information.

* doc/book/book/appd.xml: it's RFC 3253, not 3256. :-)

Patch from Larry Shatzer. Fix issue #1189:

* doc/book/book/ch08.xml: Add <command> tags around svn commands.