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

Re: svn commit: r957917 - /subversion/trunk/subversion/libsvn_client/status.c

From: Julian Foad <julian.foad_at_wandisco.com>
Date: Mon, 28 Jun 2010 16:17:55 +0100

I (Julian Foad) wrote:
> We should document what depth "unknown" means on svn_client_status5().
> Would something like the following work?
>
> * Get status only as deeply as @a depth indicates.
> + * If @a depth is #svn_depth_unknown, the editor will affect only the
> + * paths reported by the individual calls to svn_repos_set_path3() and
> + * svn_repos_link_path3(). See svn_repos_begin_report2() for details.

Bah - we can use plain English. This should be much better:

[[[
- * Get status only as deeply as @a depth indicates.
+ * Get status as deeply as @a depth indicates. If @a depth is
+ * #svn_depth_unknown, get the status down to the current depth of the
+ * working copy. If @depth is deeper than the working copy, include changes
+ * that would be needed to populate the working copy to that depth.
]]]

r958599.

Corrections/improvements welcome.

- Julian
Received on 2010-06-28 17:18:38 CEST

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