# HG changeset patch
# User William Ehlhardt <williamehlhardt@gmail.com>
# Date 1180043127 0
# Node ID 3bccbafea8c13c6822f119555d30517893ef77ff
# Parent  bf516a0c430e27d54a0dba3fcc3a9ca5521392ee
- Completed SslConnection fields docs
- Noted lack of code in purple_ssl_init

diff -r bf516a0c430e -r 3bccbafea8c1 libpurple/sslconn.c
--- a/libpurple/sslconn.c	Thu May 24 06:44:57 2007 +0000
+++ b/libpurple/sslconn.c	Thu May 24 21:45:27 2007 +0000
@@ -246,6 +246,8 @@
 void
 purple_ssl_init(void)
 {
+	/* This doesn't do anything at the moment. All the actual init work
+	 * is handled by purple_ssl_is_supported upon demand. */
 }
 
 void
diff -r bf516a0c430e -r 3bccbafea8c1 libpurple/sslconn.h
--- a/libpurple/sslconn.h	Thu May 24 06:44:57 2007 +0000
+++ b/libpurple/sslconn.h	Thu May 24 21:45:27 2007 +0000
@@ -52,16 +52,19 @@
 	void *connect_cb_data;
 	/** Callback triggered once the SSL handshake is complete */
 	PurpleSslInputFunction connect_cb;
-	/** TODO: Document me! */
+	/** Callback triggered if there is an error during connection */
 	PurpleSslErrorFunction error_cb;
 	/** Data passed to PurpleSslConnection::recv_cb() */
-	/* TODO: Is this stuff even used?? */
 	void *recv_cb_data;
+	/** User-defined callback executed when the SSL connection receives data */
 	PurpleSslInputFunction recv_cb;
 
 	/** File descriptor used to refer to the socket */
 	int fd;
+	/** Glib event source ID; used to refer to the received data callback 
+	 * in the glib eventloop */
 	int inpa;
+	/** Data related to the underlying TCP connection */
 	PurpleProxyConnectData *connect_data;
 
 	/** Internal connection data managed by the SSL backend (GnuTLS/LibNSS/whatever) */