Rene Hollan wrote:

Oh, you need to dig deeper, to understand the semantics and not just the syntax of those APIs.

I didn't say using the source as documentation was convenient, but it is possible, to any degree of detail you want.

To wit: given the source code, it is possible to create documentation to any degree of convenience. But, given some instance of external documentation and no source, it is not possible to improve the convenience factor of that documentation to an arbitrary degree.

Suggesting what people who donate their time DO is rather like herding cats. Some like coding and others like documenting and some like both. Perhaps instead of an admonition that the project needs better documentation, a question regarding who is willing to contribute to said better documentation is more in order.


unluckily, those of us who most need the docs are least able to contribute, as I haven't the foggiest notion how to properly use any of the APIs at present. I suppose I need to get the ORA book and start reading, as eventually I"m going to be helping another development team at work with getting an SSL connection going that needs to use a client certificate stored on a PKCS#11 PKI token, so I'll be sorting out how to use libssl w/ opensc's engine-pkcs11 module, who's documentation is just about as non-existant as that of openssl. this task was very easy in Java, as Java's SecureSocket hides all the complexity, up to and including full support for PKCS#11 plugins.



.




______________________________________________________________________
OpenSSL Project                                 http://www.openssl.org
User Support Mailing List                    openssl-users@openssl.org
Automated List Manager                           majord...@openssl.org

Reply via email to