Two typos and a correction [PATCH]
alex.purins at businesslink.com
Fri Sep 5 13:31:20 CDT 2008
So be it - but I disagree with relying on surrounding text to implicitly
correct a gratuitous and blatantly false statement.
Gratuitous because dropping it (and slightly rewording for better flow) to
have simply "This is why Subversion is so often used in software development
environments— it makes collaboration with other programmers easy."
would not detract one iota from the document.
False because programming is an inherently private, singular task, with
others becoming involved only on those occasions when it proves difficult
(which is admittedly all the time for some developers) or when it would take
too long done by one person.
From: C. Michael Pilato [mailto:cmpilato at red-bean.com]
Sent: Friday, September 05, 2008 09:00
To: Alex Purins
Cc: svnbook-dev at red-bean.com
Subject: Re: Two typos and a correction [PATCH]
Alex Purins wrote:
> Index: src/en/book/ch02-basic-usage.xml
> --- src/en/book/ch02-basic-usage.xml (revision 3286)
> +++ src/en/book/ch02-basic-usage.xml (working copy)
> @@ -1691,7 +1691,7 @@
> result, and attempt your commit again.</para>
> <para>That covers the basic work cycle for using Subversion.
> - Subversion offerse many other features that you can use
> + Subversion offers many other features that you can use
> to manage your repository and working copy, but most of your
> day-to-day use of Subversion will involve only the commands
> that we've discussed so far in this chapter. We will,
I fixed this already in r3287 (the revision just after the one from which
your diff was made).
> Index: src/en/book/ch03-advanced-topics.xml
> --- src/en/book/ch03-advanced-topics.xml (revision 3286)
> +++ src/en/book/ch03-advanced-topics.xml (working copy)
> @@ -652,7 +652,7 @@
> <para>But even if you haven't checked out a working copy from
> - that repository, you can still affect the property change by
> + that repository, you can still effect the property change by
> providing the repository's root URL:</para
Ah. *That* English oddity again...
> Index: src/en/book/ch00-preface.xml
> --- src/en/book/ch00-preface.xml (revision 3286)
> +++ src/en/book/ch00-preface.xml (working copy)
> @@ -784,7 +784,7 @@
> documents (usually over a network) and keep track of who made
> which changes, then Subversion is also appropriate. This is
> why Subversion is so often used in software development
> - environments— programming is an inherently social
> + environments— programming of large projects is an
> inherently social
> activity, and Subversion makes it easy to collaborate with
> other programmers. Of course, there's a cost to using
> Subversion as well: administrative overhead. You'll need to
I know what you're trying to get at, but I don't think adding these words
adds value. It's implied by the remainder of the sentence that the social
aspect comes into play by virtue of there being "other programmers".
C. Michael Pilato <cmpilato at red-bean.com> | http://cmpilato.blogspot.com/
"The Christian ideal has not been tried and found wanting. It has
been found difficult; and left untried." -- G. K. Chesterton
More information about the svnbook-dev