Bunch of documentation tidying for the ssl api, and add a doxycomment to
PurpleSslErrorType so that it actually shows up in the HTML docs.

Does anyone know why documentation of enums shows each value twice? It's
really annoying.