Re: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-22 Thread Daniel Shahaf
Hyrum Wright wrote on Wed, Sep 22, 2010 at 21:07:10 +0100: > On Wed, Sep 22, 2010 at 8:40 PM, Daniel Shahaf > wrote: > > Hyrum Wright wrote on Wed, Sep 22, 2010 at 12:08:41 +0100: > >> On Wed, Sep 22, 2010 at 11:33 AM, Daniel Shahaf > >> wrote: > >> > [1] For the [out] parameter, can we have @p

RE: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-22 Thread Bert Huijben
> -Original Message- > From: hy...@hyrumwright.org [mailto:hy...@hyrumwright.org] On Behalf Of > Hyrum Wright > Sent: woensdag 22 september 2010 22:07 > To: Daniel Shahaf > Cc: Julian Foad; dev@subversion.apache.org > Subject: Re: svn commit: r998296 - > /sub

Re: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-22 Thread Hyrum Wright
On Wed, Sep 22, 2010 at 8:40 PM, Daniel Shahaf wrote: > Hyrum Wright wrote on Wed, Sep 22, 2010 at 12:08:41 +0100: >> On Wed, Sep 22, 2010 at 11:33 AM, Daniel Shahaf >> wrote: >> > [1] For the [out] parameter, can we have @param[out,optional] and >> > @param[out,mandatory] notations, or do we ha

Re: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-22 Thread Daniel Shahaf
Hyrum Wright wrote on Wed, Sep 22, 2010 at 12:14:35 +0100: > On Wed, Sep 22, 2010 at 11:14 AM, Daniel Shahaf > wrote: > > Julian Foad wrote on Wed, Sep 22, 2010 at 09:43:26 +0100: > >> So perhaps we should aim to say: > >> > >>     * Output the content of a specified revision of a file > >>     *

Re: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-22 Thread Daniel Shahaf
Hyrum Wright wrote on Wed, Sep 22, 2010 at 12:08:41 +0100: > On Wed, Sep 22, 2010 at 11:33 AM, Daniel Shahaf > wrote: > > [1] For the [out] parameter, can we have @param[out,optional] and > > @param[out,mandatory] notations, or do we have to say "may be NULL" > > in the prose?) > > @param[out] i

Re: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-22 Thread Hyrum Wright
On Wed, Sep 22, 2010 at 11:14 AM, Daniel Shahaf wrote: > Julian Foad wrote on Wed, Sep 22, 2010 at 09:43:26 +0100: >> Hyrum Wright wrote: >> > On Tue, Sep 21, 2010 at 10:25 PM, Daniel Shahaf >> > wrote: >> > > hwri...@apache.org wrote on Fri, Sep 17, 2010 at 20:04:53 -: >> > >> * subversion/

Re: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-22 Thread Hyrum Wright
On Wed, Sep 22, 2010 at 11:33 AM, Daniel Shahaf wrote: > And another stab: > > /** >  * Checkout a working copy from a repository. >  * >  * @param[out] result_rev >  *              If non-NULL, the value of the revision checked out form >  *              the repository [1].  (Useful when @a revis

Re: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-22 Thread Daniel Shahaf
And another stab: /** * Checkout a working copy from a repository. * * @param[out] result_rev * If non-NULL, the value of the revision checked out form * the repository [1]. (Useful when @a revision is of * a kind other than #svn_opt_revision_number.)

Re: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-22 Thread Daniel Shahaf
Julian Foad wrote on Wed, Sep 22, 2010 at 09:43:26 +0100: > Hyrum Wright wrote: > > On Tue, Sep 21, 2010 at 10:25 PM, Daniel Shahaf > > wrote: > > > hwri...@apache.org wrote on Fri, Sep 17, 2010 at 20:04:53 -: > > >> * subversion/include/svn_client.h > > >> (svn_client_cat2): Rewrite docstr

Re: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-22 Thread Julian Foad
Hyrum Wright wrote: > On Tue, Sep 21, 2010 at 10:25 PM, Daniel Shahaf > wrote: > > hwri...@apache.org wrote on Fri, Sep 17, 2010 at 20:04:53 -: > >> * subversion/include/svn_client.h > >> (svn_client_cat2): Rewrite docstring (see r997639). [...] > >> * > >> * A brief word on operative a

Re: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-21 Thread Hyrum Wright
On Tue, Sep 21, 2010 at 10:25 PM, Daniel Shahaf wrote: > hwri...@apache.org wrote on Fri, Sep 17, 2010 at 20:04:53 -: >> Author: hwright >> Date: Fri Sep 17 20:04:53 2010 >> New Revision: 998296 >> >> URL: http://svn.apache.org/viewvc?rev=998296&view=rev >> Log: >> * subversion/include/svn_cli

Re: svn commit: r998296 - /subversion/trunk/subversion/include/svn_client.h

2010-09-21 Thread Daniel Shahaf
hwri...@apache.org wrote on Fri, Sep 17, 2010 at 20:04:53 -: > Author: hwright > Date: Fri Sep 17 20:04:53 2010 > New Revision: 998296 > > URL: http://svn.apache.org/viewvc?rev=998296&view=rev > Log: > * subversion/include/svn_client.h > (svn_client_cat2): Rewrite docstring (see r997639). >