On Wed, 11 Apr 2007, Hyrum K. Wright wrote:
> Daniel Rall wrote:
> > On Wed, 11 Apr 2007, Hyrum K. Wright wrote:
> >
> >> Daniel Rall wrote:
> > ...
> >>> I asked Erik where we document this important API usage fact, but he
> >>> wasn't sure. Do we document this anywhere? If not, I suggest
> >>> documenting it in hacking.html.
> >> Would documenting it in the header files also be useful? After all, it
> >> is something which the API consumers should be aware of. The header
> >> files are what outlines our API specification, and this seems part of
> >> that spec.
> >
> > I first thought of the header files (I'd personally like to see it
> > documented there). I suppose a sweep through svn_client.h would be a
> > sufficient, combined with a note in hacking.html?
>
> Or even just a note at the top of svn_client.h. Something similar to
> "you must call apr_initialize() before using any of this stuff." Come
> to think of it, that's not documented in svn_client.h either.
>
> I agree that it should also be mentioned in hacking.html.
I took care of hacking.html in r24575. Can people take a look?
If it looks okay, I'll try something similar in svn_client.h.
> -Hyrum (who has often thought it might be nice to have a separate
> "hacking with Subversion" document, in addition to the existing "hacking
> on Subversion" document)
+1
- application/pgp-signature attachment: stored
Received on Sat Apr 14 02:15:28 2007