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

Re: [PATCH] log-related public API docstring clarifications

From: C. Michael Pilato <cmpilato_at_collab.net>
Date: Wed, 04 Jun 2008 13:24:49 -0400

C. Michael Pilato wrote:
> (See the "SVN-DEV HELP NEEDED: What to do about the ra-get-log
> interface" thread for background information.)
>
> C. Michael Pilato wrote:
> > Fortunately (for us), I think the docstrings in the RA and repos layers
> > are sufficiently vague as to not imply *what* would happen if you passed
> > an empty array. So, in my opinion, we have the opportunity in 1.5.0 to
> > define that behavior (which we effectively have: empty paths == NULL
> > paths == paths with one "" member), and (now) in 1.5.1 to fix the
> > docstrings for the repos and RA functions so that this is all made
> clear.
>
> Attached is a quickie patch to our public API which, I think, accurately
> describes the state of the world. Note the @note on svn_ra_get_logs2()
> -- is that cool? Can we do this?
>

I committed this patch in r31590.

-- 
C. Michael Pilato <cmpilato_at_collab.net>
CollabNet   <>   www.collab.net   <>   Distributed Development On Demand

Received on 2008-06-04 19:25:04 CEST

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.