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

0 files changed, 0 insertions, 0 deletions