changeset 17230:4248f884451f

Clarify documentation
author William Ehlhardt <williamehlhardt@gmail.com>
date Thu, 24 May 2007 04:43:39 +0000
parents b765fdcde59e
children a7887e79b723
files libpurple/sslconn.h
diffstat 1 files changed, 5 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/libpurple/sslconn.h	Thu May 24 04:04:36 2007 +0000
+++ b/libpurple/sslconn.h	Thu May 24 04:43:39 2007 +0000
@@ -63,6 +63,7 @@
  * SSL implementation operations structure.
  *
  * Every SSL implementation must provide all of these and register it.
+ * These should not be called directly! Instead, use the purple_ssl_* functions.
  * @see purple_ssl_set_ops
  */
 typedef struct
@@ -76,7 +77,10 @@
 	/** Sets up the SSL connection for a PurpleSslConnection once
      *  the TCP connection has been established */
 	void (*connectfunc)(PurpleSslConnection *gsc);
-	/** Destroys the SSL connection provided */
+	/** Destroys the internal data of the SSL connection provided.
+	 *  Freeing gsc itself is left to purple_ssl_close()
+	 *
+	 */
 	void (*close)(PurpleSslConnection *gsc);
 	/** Reads data from a connection (like POSIX read())
 	 * @param gsc	Connection context