Q: code and documentation inconsistency

[David MacCormack <dj...@maccormack.net>]

Hi.  There seems to be an inconsistency between the documentation for 
apr_file_open() then the implementation (at least for UNIX).  The docs 
state (under Remarks):
     *arg1 must point to a valid file_t, or NULL (in which case it will be
     allocated)

This implies that it will reuse the given apr_file_t* struct if the 
pointer is non NULL.  However, looking at /apr/trunk/file_io/unix/open.c
it is clearly allocating a new structure every time.  So my question is,
which is the correct/intended behavior?  What the docs say or what the 
current implementation is?

Thanks,

Dave