Re: svn commit: r9712 - in trunk/subversion: clients/cmdline include libsvn_subr

[email protected] wrote:

> +/**
>+ * @since New in 1.1.
>+ *
>+ * Parse a working-copy or url in @a path, looking for an "@" sign, e.g.
>+ *
>+ *       foo/bar/baz-velwz/[email protected]
>+ *       http://blah/[email protected]
>+ *       blarg/[email protected]
>+ *
>+ * If an "@" is found, return the two halves in @a *truepath and @a
>+ * *rev, allocating from @a pool.
>+ *
>+ * If no "@" is found, set @a *truepath to @a path and @a *rev to kind
>+ * 'unspecified'.
>+ */
>  
>
This docstring needs a brief description. Right now, that brief 
description will end with "e.g." :-)
Also, be careful about using plain @ in doxygen docstrings; escape it 
instead (\@ or @@).

-- Brane