Documentation fixes

Fix spacing, comments, and links in doxygen documentation.
diff --git a/include/mbedtls/ecp.h b/include/mbedtls/ecp.h
index 6bcda17..9e2755f 100644
--- a/include/mbedtls/ecp.h
+++ b/include/mbedtls/ecp.h
@@ -542,7 +542,8 @@
  * \param format    Point format, should be a MBEDTLS_ECP_PF_XXX macro
  * \param p         Buffer to write to
  * \param size      Buffer size
- * \param olen      Number of bytes written to \c buf
+ * \param olen      Number of bytes written to \c buf on success,
+ *                  unspecified on failure.
  *
  * \return          0 on success
  *                  or \c MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL