Re: svn commit: r1173935 - /subversion/trunk/subversion/include/private/svn_subr_private.h

Greg Stein wrote on Thu, Sep 22, 2011 at 14:25:59 -0400:
> On Thu, Sep 22, 2011 at 13:55, Daniel Shahaf <d.s_at_daniel.shahaf.name> wrote:
> > Greg Stein wrote on Thu, Sep 22, 2011 at 13:33:37 -0400:
> >...
> >> Can we get the nightly to do it? ie. for devs rather than part of official
> >> released API doc?
> >
> > This would require someone to convert all the docs in
> > subversion/include/private/ to the doxygen format.  I think between OCD
> > and scripting abilities someone can make the conversion. (if we want to
> > do it)
>
> Good point.
>
> *shrug*
>
> I just kinda used doxygen as a default. I doubt that we'd want to
> expose the spillbuf interface because it probably won't be used in any
> of our public APIs, and it doesn't directly relate to Subversion.
>

Agreed, but, as you said before, making the interface public is
orthogonal to compiling doxygen docs for it.

Would developers find it useful to have doxygen docs of the private APIs?

> Cheers,
> -g
Received on 2011-09-22 20:31:52 CEST