> I propose that OpenSSL move to DocBook, an XML format, for its > documentation. DocBook (www.docbook.org) is an XML language for > structured/technical documentation.
You can also include unformatted external documents, e.g. configuration files and source code. I've used that on a few projects -- it makes it trivial to update examples without needing to edit the docbook source itself. (In fact, iirc some of it was internal documentation for openssl! It was stuff like demonstrating the contents of an X509 certificate or a config file suitable for autopopulating a server certificate via xxx_value= fields.) Bear ______________________________________________________________________ OpenSSL Project http://www.openssl.org Development Mailing List [email protected] Automated List Manager [EMAIL PROTECTED]
