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

Re: svn commit: r17521 - trunk/subversion/clients/cmdline

From: Malcolm Rowe <malcolm-svn-dev_at_farside.org.uk>
Date: 2005-11-26 18:15:46 CET

Hi Julian,

On Sat, Nov 26, 2005 at 11:19:27AM -0600, julianfoad@tigris.org wrote:
> * subversion/clients/cmdline/main.c
> (svn_cl__cmd_table): Modify help text for pdel, pedit, pget, plist, pset:
> Use plural "props" in "propget", as in the other commands.
>

The use of 'prop' vs 'props' is still inconsistent after this change:

> " 1. Removes versioned props in working copy.\n"
> + " 2. Removes unversioned remote prop on repos revision.\n"
>
> " 1. Edits versioned props in working copy.\n"
> + " 2. Edits unversioned remote prop on repos revision.\n"
>
> + " 1. Prints versioned props. If specified, REV determines in which\n"
> " 2. Prints unversioned remote prop on repos revision.\n"

In general, the summary of the command is in the imperative ("Remove a
property"), while the detailed descriptions vary in their generality:

  1. [This function generally] Removes versioned props in working copy.
  2. [This function, when used, ] Removes [an] unversioned remove prop on...

We need to work out if we're describing what the function does in general,
or documenting what it does specifically (and shouldn't that preposition
be 'from' in both cases, btw?)

Regards,
Malcolm

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Sat Nov 26 18:16:51 2005

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.