----- Original Message ----- > From: "dE" <de.tec...@gmail.com> > To: openssl-dev@openssl.org > Sent: Monday, 13 October, 2014 5:38:28 AM > Subject: Re: CIPHER STRINGS > > On 10/13/14 01:13, Viktor Dukhovni wrote: > > On Sun, Oct 12, 2014 at 11:36:01PM +0530, dE wrote: > > > >> A command line tool. Like openssl list-ciphersuits > > My own preference in this case is complete and accurate documentation. > > > >> This'll also avoid updating the man page with long descriptive text. > > Even if a command-line tool is created, complete and accurate > > documentation is not optional. > > > > Problem with the documentation is that it's not complete. Many of these > don't specify what does the algo do (auth, digest etc...). > > They're basically just writing the obvious with some notices about > openSSL specific implementation. > > So if you dont know about the algo, you've to google it anyway.
backporting documentation fixes is much easier that code fixes (some distributions even have mechanisms to update just the man pages without need of issuing a new binary package) speaking of which, I did recently update ciphers man page on 1.0.1 branch with the intended goal to make it aligned with code actually shipping and more explicit with what different options do. If you think that it still has some unclear parts I'll gladly hear about them. See here for the current version: https://github.com/openssl/openssl/blob/OpenSSL_1_0_1-stable/doc/apps/ciphers.pod If the man page in your distro doesn't include those changes, open a bug report against the distro, we can't help much with this though. -- Regards, Hubert Kario ______________________________________________________________________ OpenSSL Project http://www.openssl.org Development Mailing List openssl-dev@openssl.org Automated List Manager majord...@openssl.org
