From: "Graham Leggett" <minf...@sharp.fm>

Use the source: while not the easiest to read it is the most accurate
documentation available at any given time. (No, this is not a
justification for a lack of or bad documentation).

The objection, and it's a major one, to reverse engineering the API from the source is that the source doesn't tell you what the contract is - it doesn't tell you what this API guarantees to deliver, it only tells you what the current version's implementation actually does. So if you rely on the implementation of the current version your code will break when the next version does something different, which is not the case if you're writing to a published and documented API as you won't be accidentally relying on non-guaranteed implementation details.

Tim Ward - Brett Ward Limited - 07801 703 600
www.brettward.co.uk
______________________________________________________________________
OpenSSL Project                                 http://www.openssl.org
User Support Mailing List                    openssl-users@openssl.org
Automated List Manager                           majord...@openssl.org

Reply via email to