(PE-3489) Document preference of SSL functions from jvm-ca

This commit adds a section header comment and notes in the docstrings
of the SSL functions that mention the jvm-ca library should be preferred.