search

noxxi / p5-io-socket-ssl

IO::Socket::SSL Perl Module
36 stars 62 forks source link

close documentation has been better #162

Open abraxxa opened 1 week ago

abraxxa commented 1 week ago

While trying to find out how to properly close a TLS connection I came across SSL_fast_shutdown in the docs but couldn't find an example how to set it, in the socket constructor or as parameter of the close method call.

Search the net brought up the old version 1.965 docs in https://manpages.ubuntu.com/manpages/trusty/man3/IO::Socket::SSL.3pm.html which contains a much better explanation of the close method in my opinion.

What was the reason for the doc rewrite? Can we improve it?

Thanks!

abraxxa commented 1 week ago

The old documentation also mentions the auto-closing nature while the current documentation doesn't: https://manpages.ubuntu.com/manpages/trusty/man3/IO::Socket::SSL.3pm.html#limitations Why was this removed?