A English syntax error in section title
C. Michael Pilato
cmpilato at red-bean.com
Tue Nov 14 08:20:04 CST 2017
"Blocking Commits from Incapable Clients"?
I'd like not to give the impression that those clients can't do *anything*
with the server. I'd like not to have a 16-word title, too. :-)
On Tue, Nov 14, 2017 at 9:12 AM, Daniel Shahaf <danielsh at apache.org> wrote:
> C. Michael Pilato wrote on Mon, Nov 13, 2017 at 08:50:06 -0500:
> > Well, that section is not actually about blocking of merge tracking, but
> > rather about blocking commits made by clients that don't support merge
> > tracking.
> > The original sentiment is probably one best expressed using hyphens (as
> > "Blocking Merge-Tracking-Unaware Clients"), but long strings of hyphens
> > generally frowned upon. I notice that the 1.7 version of the book has
> > this title as simply "Blocking Merge-Unaware Clients", which is an
> > improvement grammatically, but still fails to reflect the scope of what's
> > really happening.
> > Maybe we should change the title of that section to reflect the *goal*
> > rather than the specific approach. Perhaps something such as "Preserving
> > Mergeinfo Integrity"?
> I rather think a negative is appropriate in this case: this section
> describes a solution to a specific problem. ("Preventing 2008-vintage
> clients from meddling" would be pretty accurate ☺.)
> How about simply "Blocking Incapable Clients"?
> @wuzhouhui: I do think a change is warranted: the section title really
> isn't very clear (it could be misparsed in other ways, too).
> > On Sun, Nov 12, 2017 at 1:36 AM, wuzhouhui <wuzhouhui14 at mails.ucas.ac.cn
> > wrote:
> > > +++ b/trunk/en/book/ch04-branching-and-merging.xml (working copy)
> > > @@ -3178,7 +3178,7 @@ D src/integer.c
> > > <!-- ============================================================
> > > -->
> > > <sect2 id="svn.branchmerge.advanced.pre1.5clients">
> > > - <title>Blocking Merge Tracking Unaware Clients</title>
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the svnbook-dev