From 419fc3fc7f5528a5236af70e8a0cc04a83a9e127 Mon Sep 17 00:00:00 2001
From: Gergely Polonkai <gergely@polonkai.eu>
Date: Fri, 21 Jun 2013 13:56:41 +0200
Subject: [PATCH] Documentation fix for WmudPlayer

---
 docs/reference/wmud/wmud-docs.sgml    |  1 +
 docs/reference/wmud/wmud-sections.txt | 23 +++++++++++++++++++++++
 wmud/wmudplayer.c                     |  6 +++---
 wmud/wmudplayer.h                     |  3 ++-
 4 files changed, 29 insertions(+), 4 deletions(-)

diff --git a/docs/reference/wmud/wmud-docs.sgml b/docs/reference/wmud/wmud-docs.sgml
index e1e44c5..9c9d409 100644
--- a/docs/reference/wmud/wmud-docs.sgml
+++ b/docs/reference/wmud/wmud-docs.sgml
@@ -19,6 +19,7 @@
     <!--xi:include href="xml/types.xml"/-->
     <xi:include href="xml/utils.xml"/>
     <xi:include href="xml/wmudclient.xml"/>
+    <xi:include href="xml/wmudplayer.xml"/>
     <xi:include href="xml/configuration.xml"/>
     <xi:include href="xml/maintenance-thread.xml"/>
     <xi:include href="xml/game-thread.xml"/>
diff --git a/docs/reference/wmud/wmud-sections.txt b/docs/reference/wmud/wmud-sections.txt
index 4b53fb4..e23a003 100644
--- a/docs/reference/wmud/wmud-sections.txt
+++ b/docs/reference/wmud/wmud-sections.txt
@@ -42,6 +42,29 @@ wmud_client_state_get_type
 <TITLE>WmudPlayer</TITLE>
 <FILE>wmudplayer</FILE>
 WmudPlayer
+WmudPlayerPrivate
+WMUD_IS_PLAYER
+WMUD_IS_PLAYER_CLASS
+WMUD_PLAYER
+WMUD_PLAYER_CLASS
+WMUD_PLAYER_GET_CLASS
+WMUD_TYPE_PLAYER
+wmud_player_get_cpassword
+wmud_player_get_email
+wmud_player_get_fail_count
+wmud_player_get_id
+wmud_player_get_player_name
+wmud_player_get_registered
+wmud_player_get_type
+wmud_player_increase_fail_count
+wmud_player_new
+wmud_player_password_valid
+wmud_player_reset_fail_count
+wmud_player_set_cpassword
+wmud_player_set_email
+wmud_player_set_id
+wmud_player_set_player_name
+wmud_player_set_registered
 </SECTION>
 
 <SECTION>
diff --git a/wmud/wmudplayer.c b/wmud/wmudplayer.c
index 6599fc8..b8d3411 100644
--- a/wmud/wmudplayer.c
+++ b/wmud/wmudplayer.c
@@ -195,7 +195,7 @@ wmud_player_dup(WmudPlayer *self)
 
 /**
  * wmud_player_password_valid:
- * @client:   The client to be authenticated
+ * @player:   The client to be authenticated
  * @password: The password in clear text
  *
  * Tries to authenticate a client with the name stored in the player object,
@@ -204,8 +204,8 @@ wmud_player_dup(WmudPlayer *self)
  * Return value: %TRUE if the password is valid, %FALSE otherwise.
  */
 gboolean
-wmud_player_password_valid(WmudPlayer *self, const gchar *password)
+wmud_player_password_valid(WmudPlayer *player, const gchar *password)
 {
-	return (g_strcmp0(crypt(password, self->priv->cpassword), self->priv->cpassword) == 0);
+	return (g_strcmp0(crypt(password, player->priv->cpassword), player->priv->cpassword) == 0);
 }
 
diff --git a/wmud/wmudplayer.h b/wmud/wmudplayer.h
index 83b7e41..5af01a5 100644
--- a/wmud/wmudplayer.h
+++ b/wmud/wmudplayer.h
@@ -36,6 +36,7 @@ typedef struct _WmudPlayerPrivate WmudPlayerPrivate;
 
 struct _WmudPlayer
 {
+	/*< private >*/
 	GObject  parent_instance;
 
 	/*< private >*/
@@ -63,7 +64,7 @@ gchar *wmud_player_get_email(WmudPlayer *player);
 void wmud_player_set_id(WmudPlayer *player, guint32 id);
 guint32 wmud_player_get_id(WmudPlayer *player);
 WmudPlayer *wmud_player_dup(WmudPlayer *player);
-gboolean wmud_player_password_valid(WmudPlayer *self, const gchar *password);
+gboolean wmud_player_password_valid(WmudPlayer *player, const gchar *password);
 
 #endif /* __WMUD_WMUDPLAYER_H__ */