CVSROOT: /cvs
Module name: src
Changes by: t...@cvs.openbsd.org 2021/01/09 03:50:02
Modified files:
lib/libssl/man : SSL_get_shared_ciphers.3
Log message:
Update SSL_get_shared_ciphers() documentation for ssl_lib.c r1.240
>From schwarze, who explains:
* Even though i wrote the original version of our documentation
for this function, i now think the design of this function is so
atrocious that it is better to call out the main limitations
up front (server side only and silent truncation) rather than
first giving the impression that it achieves something it
actually doesn't and then later try to row back in a piece-meal
manner.
* Using a .Bl list for failure conditions in the RETURN VALUES
section is no doubt unusual, but the conditions are so numerous
and some of them are so surprising that i think it makes sense
in this case. If a function is badly designed and has surprising
properties, precision and clarity in the description are even
more important than usual, and conciseness is better sacrificed.
* Adding .Xr SSL_get_ciphers 3 seems helpful.
ok beck inoguchi jsing tb
