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...
                                       Ralf S. Engelschall
                                       [EMAIL PROTECTED]
                                       www.engelschall.com
______________________________________________________________________
OpenSSL Project                                 http://www.openssl.org
Development Mailing List                       [EMAIL PROTECTED]
Automated List Manager                           [EMAIL PROTECTED]

Reply via email to