diff --git a/docs/reference/wmud/wmud-docs.sgml b/docs/reference/wmud/wmud-docs.sgml
index bd55512..e1e44c5 100644
--- a/docs/reference/wmud/wmud-docs.sgml
+++ b/docs/reference/wmud/wmud-docs.sgml
@@ -18,6 +18,7 @@
wMUD hackers' guide
+
diff --git a/docs/reference/wmud/wmud-sections.txt b/docs/reference/wmud/wmud-sections.txt
index 199bfb7..4b53fb4 100644
--- a/docs/reference/wmud/wmud-sections.txt
+++ b/docs/reference/wmud/wmud-sections.txt
@@ -2,7 +2,40 @@
WmudClient
wmudclient
WmudClient
+WmudClientPrivate
WmudClientState
+WmudClientYesnoCallback
+WMUD_CLIENT
+WMUD_CLIENT_CLASS
+WMUD_CLIENT_GET_CLASS
+WMUD_IS_CLIENT
+WMUD_IS_CLIENT_CLASS
+WMUD_TYPE_CLIENT
+WMUD_TYPE_CLIENT_STATE
+wmud_client_close
+wmud_client_get_bademail
+wmud_client_get_buffer
+wmud_client_get_buffer_length
+wmud_client_get_last_recv_age
+wmud_client_get_login_fail_count
+wmud_client_get_player
+wmud_client_get_socket
+wmud_client_get_socket_source
+wmud_client_get_state
+wmud_client_get_type
+wmud_client_get_yesno_callback
+wmud_client_increase_login_fail_count
+wmud_client_new
+wmud_client_newchar_answer
+wmud_client_quitanswer
+wmud_client_set_authenticated
+wmud_client_set_bademail
+wmud_client_set_context
+wmud_client_set_player
+wmud_client_set_socket
+wmud_client_set_state
+wmud_client_set_yesno_callback
+wmud_client_state_get_type
diff --git a/wmud/wmudclient.c b/wmud/wmudclient.c
index fb4ae4c..7b50d6d 100644
--- a/wmud/wmudclient.c
+++ b/wmud/wmudclient.c
@@ -25,7 +25,7 @@
/**
* SECTION:wmudclient
* @short_description: wMUD Client
- * @inclide: wmudclient.h
+ * @include: wmudclient.h
*
* #WmudClient is for storing an active client connection
**/
@@ -232,7 +232,7 @@ wmud_client_send(WmudClient *self, const gchar *fmt, ...)
/**
* wmud_client_close:
- * @client: the client whose connection should be dropped
+ * @self: the client whose connection should be dropped
* @send_goodbye: if set to %TRUE, we will send a nice good-bye message to the
* client before dropping the connection
*
@@ -330,10 +330,17 @@ wmud_client_set_bademail(WmudClient *self, gboolean bademail)
self->priv->bademail = bademail;
}
+/**
+ * wmud_client_get_bademail:
+ * @client: the client whose bad e-mail status is to be retrieved
+ *
+ * Gets the bad e-mail status, e.g if the player on the other side entered a
+ * syntactically bad e-mail address
+ */
gboolean
-wmud_client_get_bademail(WmudClient *self)
+wmud_client_get_bademail(WmudClient *client)
{
- return self->priv->bademail;
+ return client->priv->bademail;
}
void
diff --git a/wmud/wmudclient.h b/wmud/wmudclient.h
index 5f157bf..230b15e 100644
--- a/wmud/wmudclient.h
+++ b/wmud/wmudclient.h
@@ -19,14 +19,6 @@
#ifndef __WMUD_WMUDCLIENT_H__
#define __WMUD_WMUDCLIENT_H__
-/**
- * SECTION:wmudclient
- * @short_description: wMUD Client
- * @inclide: wmudclient.h
- *
- * #WmudClient is for storing an active client connection
- **/
-
#include
#include
#include
@@ -42,20 +34,26 @@
/**
* WmudClient:
- * @parent_instance: the parent GObject instance
*
* A connected game client
*/
typedef struct _WmudClient WmudClient;
typedef struct _WmudClientClass WmudClientClass;
typedef struct _WmudClientPrivate WmudClientPrivate;
+
+/**
+ * WmudClientYesnoCallback:
+ * @client: the client who is waiting for the answer
+ * @answer: the answer itself, where TRUE means yes and FALSE means no
+ *
+ * A callback function used by yes/no questions
+ */
typedef void (*WmudClientYesnoCallback)(WmudClient *client, gboolean answer);
struct _WmudClient
{
- GObject parent_instance;
-
/*< private >*/
+ GObject parent_instance;
WmudClientPrivate *priv;
};
@@ -88,4 +86,3 @@ guint32 wmud_client_get_last_recv_age(WmudClient *client);
void wmud_client_set_context(WmudClient *client, GMainContext *context);
#endif /* __WMUD_WMUDCLIENT_H__ */
-