"Ralf S. Engelschall" wrote:
>
> In article <[EMAIL PROTECTED]> you wrote:
> > On Mon, 9 Aug 1999, Ralf S. Engelschall wrote:
> >>
> >> OpenSSL 0.9.4 is now out and everyone can again keep on hacking for 0.9.5 (or
> >> is it now finally time to start thinking about 1.0.0?). I'd like to thank all
> >> OpenSSL developers and all OpenSSL contributors for their efforts. Let's hope
> >> 0.9.4 is as stable (or even more stable) as the previous releases.
> >
> > IMO a major goal for 1.0.0 should be cleaning up the API such that future
> > releases may be binary compatible.
> >
> > Documentation would be very nice as well.
>
> I agree.
>
> > I would be happy to assist in
> > writing API docs, but we should decide on a documentation standard.
> >
> > The GNOME people are getting good results with documents embedded in
> > the code itself. Using these API and developer documents are
> > automatically generated. Would the OpenSSL developers be interested in
> > adopting something similar?
>
> Ben already tried Doxygen some time ago. And there are various similar
> approaches. Seems we've to evaluate most of them before we should stick with
> one. Ben, what were your latest experiences at this corner? I ask, because
> I've to admit that I've still not found a tool for any of my projects which
> makes me really happy. But doxygen was certainly still one of the better
> ones...
I got no further: I can only take so much negativity before I give up.
I'm still convinced that inline docco is the only kind with any hope,
and doxygen did a reasonably good job. Other suggestions are welcome, of
course, particularly if accompanied by experience.
Cheers,
Ben.
--
http://www.apache-ssl.org/ben.html
"My grandfather once told me that there are two kinds of people: those
who work and those who take the credit. He told me to try to be in the
first group; there was less competition there."
- Indira Gandhi
______________________________________________________________________
OpenSSL Project http://www.openssl.org
Development Mailing List [EMAIL PROTECTED]
Automated List Manager [EMAIL PROTECTED]
