Make SSL_read and SSL_write return the old behaviour and document it.

Backport of beacb0f0, revert of
fa4c3745



Fixes: #1903

Reviewed-by: Matt Caswell <matt@openssl.org>

GH: #1967