On Feb 2, 2013, at 2:46 AM, Matt Caswell wrote:
I have previously submitted a largish patch for documentation around
the OpenSSL EC library. Unfortunately there seems little interest in
it, and it has been hanging around in RT for some while:
https://rt.openssl.org/Ticket/Display.html?id=2799 (username guest,
password guest)
This documentation is in the POD format used by OpenSSL so isn't
ideal for a direct conversion onto the wiki. However it seems a
shame for it to be inaccessible so I've published it onto your
wikibooks site anyway.
I agree on both counts. Ideally, the actual API documentation should
be maintained by the OpenSSL project, so it can be version-controlled
along with the source, and the documentation can be installed as man
pages. Ultimately, my vision for the OpenSSL wikibook is that it
focus more on "what would you use these functions for, and how would
you use them together" rather than "these are the arguments and return
values." Something that explains a bit more of the "big picture" and
real-world usage. I see it more as a replacement for the out-of-date
O'Reilly book, rather than a replacement for the OpenSSL manpages.
However, at this point, I am very happy to have content of any sort in
the wikibook, and I thank you for your contribution!
I've reorganized the table of contents a bit, so that all of your
pages are directly accessible from the table of contents. (Again,
this man-page style format isn't quite what I'm looking for in the
long term, but I'm quite happy to have it for now!)
Thanks so much for contributing,
--Patrick
