Re: apr_pools.h docstring help

2009-05-07 Thread Jeff Trawick
On Thu, May 7, 2009 at 10:55 AM, Edmund Wong wrote: > Jeff Trawick wrote: > > Shouldn't APR_POOL_DECLARE_ACCESSOR(file) become >>> >>> APR_DECLARE(apr_pool_t *) apr_file_pool_get(apr_file_t *thefile); ? >>> >> >> >> yes, it does; so that part of the comment is incorrect >> >> (perhaps someone wi

Re: apr_pools.h docstring help

2009-05-07 Thread Edmund Wong
Jeff Trawick wrote: Shouldn't APR_POOL_DECLARE_ACCESSOR(file) become APR_DECLARE(apr_pool_t *) apr_file_pool_get(apr_file_t *thefile); ? yes, it does; so that part of the comment is incorrect (perhaps someone will care to adjust the doc; note that the name of the dummy parameter isn't impor

Re: apr_pools.h docstring help

2009-05-07 Thread Jeff Trawick
On Thu, May 7, 2009 at 9:47 AM, Edmund Wong wrote: > Given the following declaration: > > #define APR_POOL_DECLARE_ACCESSOR(type) \ >APR_DECLARE(apr_pool_t *) apr_##type##_pool_get \ >(const apr_##type##_t *the##type) > > In the docstring above it, it says: > > APR_POOL_DECLARE_ACCESS

apr_pools.h docstring help

2009-05-07 Thread Edmund Wong
Hi, I am in the process of learning C and Subversion's internals and as a prerequisite, I need to understand apr and its pools. That stated, reading on the apr_pools.h file, I've come across a docstring that I hope someone here can clarify. Given the following declaration: #define APR_POOL_DEC