[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: Book: split up compound words

From: Julian Foad <julianfoad_at_btopenworld.com>
Date: 2004-10-22 01:54:48 CEST

C. Michael Pilato wrote:
>> <para>While it won't be the most commonly used tool at the
>> administrator's disposal, <command>svndumpfilter</command>
>> provides a very particular brand of useful
>> functionality&mdash;the ability to quickly and easily modify
>>- that dumpfile data by acting as a path-based filter. Simply
>>+ that dump file data by acting as a path-based filter. Simply
>
> This should just read "that dump data".

OK - that is better.

>> <para>To get these three projects into their own repositories,
>>- we first make a dumpfile of the whole repository:</para>
>>+ we first make a dump file of the whole repository:</para>
>
> "we first dump the whole repository:..."

Good. Thanks.

>> as <quote>viewed from 10,000 feet</quote>. For each section, we
>>- provide backreferences to relevant chapters when
>>+ provide back-references to relevant chapters when
>> possible.</para>
>
> The correct form of this particular compound word lacks the hyphen.

OK. I was just working from gut feeling and the fact that it wasn't in
my Ispell dictionary - but then nor are lots of other words. I accept
that and will omit this change.

> But I'm not fond of the sentence at all. How about:
>
> "When other locations in this book contain relevant detailed
> information, sections will refer to those locations."
>
> Or something of the sort.

Hmm... well, I don't mind if you want to change it to something vaguely
of that sort sometime, but I don't mind it how it is either.

MBK, is this OK with these changes? cmpilato seems to have picked up
the non-straightforward usages that you were concerned about. The only
remaining ugly one that I can see is: "A program for filtering
Subversion repository dump file format streams." But I don't think it's
noticeably worse expanded like that than it was contracted, so any
improvement can be a separate fix.

- Julian

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Fri Oct 22 01:55:10 2004

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.