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


Reply via email to