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

Re: Documenting use of canonical paths in external APIs

From: Daniel Rall <dlr_at_collab.net>
Date: 2007-04-14 02:14:03 CEST

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

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.