[PATCH 2 of 5] Improve English for hg commands

[Martin Geisler]

Greg Ward <greg-hg at gerg.ca> writes:

Hi timeless, hi Greg!

> On Fri, Jun 5, 2009 at 6:02 AM, timeless<timeless at gmail.com> wrote:
>> # HG changeset patch
>> # User timeless <timeless at gmail.com>
>> # Date 1244202641 -7200
>> # Node ID 42f0b0bab4b61179546b419bcef8f2a8d0be0cc7
>> # Parent  7d1cbb86d3a13bb70fe4cbbf17fa8517f2e5db81
>> Improve English for hg commands

I'm very happy to see a real patch for this, thanks! I didn't look much
at the mail you sent me off list since I've been away for a conference
all week. So it's good to see a proper patch, and even better to see
Greg review it (since I'm not a native speaker).

>> [...]
>>
>>     It is possible to specify an ssh:// URL as the destination, but no
>>     .hg/hgrc and working directory will be created on the remote side.
>> -    Look at the help text for URLs for important details about ssh://
>> -    URLs.
>> +    Please see the help text for URLs for important details about
>> +    ssh:// URLs.
>
> Or even better:
>
>     Please see the help text for URLs for important details about
>     ssh:// URLs ("hg help urls").

What about this:

     Please see 'hg help urls' for important details about ssh:// URLs.

I think that is about as short and precise as it gets. And other
commands use the "see 'hg help ...'" construct too.

>>     If you want to feed the output of this command into the "xargs"
>>     command, use the -0 option to both this command and "xargs". This
>>     will avoid the problem of "xargs" treating single filenames that
>> -    contain white space as multiple filenames.
>> +    contain white space as multiple files.
>
> In my experience, "whitespace" is generally one word... like "filename".

An earlier patch replaced "filename" with "file name", so this looks
inconsistent?

-- 
Martin Geisler

VIFF (Virtual Ideal Functionality Framework) brings easy and efficient
SMPC (Secure Multiparty Computation) to Python. See: http://viff.dk/.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 196 bytes
Desc: not available
Url : http://selenic.com/pipermail/mercurial-devel/attachments/20090607/23da4f14/attachment.pgp