Fix a bunch of gtkdoc/giscan warnings

6 files changed, 11 insertions, 12 deletions

diff --git a/gtk/channel-main.c b/gtk/channel-main.c
index a64aa89..40d27cc 100644
--- a/gtk/channel-main.c
+++ b/gtk/channel-main.c
@@ -593,7 +593,8 @@ static void spice_main_channel_class_init(SpiceMainChannelClass *klass)
      * SpiceMainChannel::main-clipboard-request:
      * @main: the #SpiceMainChannel that emitted the signal
      * @types: the VD_AGENT_CLIPBOARD request type
-     * Returns: %TRUE if the request is successful
+     *
+     * Return value: %TRUE if the request is successful
      *
      * Request clipbard data from the client.
      *
@@ -614,7 +615,8 @@ static void spice_main_channel_class_init(SpiceMainChannelClass *klass)
      * SpiceMainChannel::main-clipboard-selection-request:
      * @main: the #SpiceMainChannel that emitted the signal
      * @types: the VD_AGENT_CLIPBOARD request type
-     * Returns: %TRUE if the request is successful
+     *
+     * Return value: %TRUE if the request is successful
      *
      * Request clipbard data from the client.
      *
diff --git a/gtk/smartcard-manager.c b/gtk/smartcard-manager.c
index 8e22e6c..ab3229f 100644
--- a/gtk/smartcard-manager.c
+++ b/gtk/smartcard-manager.c
@@ -241,7 +241,7 @@ static SpiceSmartcardManager *spice_smartcard_manager_new(void)
 /* public api                                                         */
 
 /**
- * spice_smartcard_manager_get
+ * spice_smartcard_manager_get:
  *
  * #SpiceSmartcardManager is a singleton, use this function to get a pointer
  * to it. A new SpiceSmartcardManager instance will be created the first
@@ -397,7 +397,7 @@ static guint smartcard_monitor_add(SmartcardSourceFunc callback,
 #define SPICE_SOFTWARE_READER_NAME "Spice Software Smartcard"
 
 /**
- * spice_smartcard_reader_is_software
+ * spice_smartcard_reader_is_software:
  * @reader: a #SpiceSmartcardReader
  *
  * Tests if @reader is a software (emulated) smartcard reader.
@@ -528,7 +528,7 @@ gboolean spice_smartcard_manager_init_finish(SpiceSession *session,
 }
 
 /**
- * spice_smartcard_manager_insert_card
+ * spice_smartcard_manager_insert_card:
  * @manager: a #SpiceSmartcardManager
  *
  * Simulates the insertion of a smartcard in the guest. Valid certificates
@@ -552,7 +552,7 @@ gboolean spice_smartcard_manager_insert_card(SpiceSmartcardManager *manager)
 }
 
 /**
- * spice_smartcard_manager_remove_card
+ * spice_smartcard_manager_remove_card:
  * @manager: a #SpiceSmartcardManager
  *
  * Simulates the removal of a smartcard in the guest. At the moment, only
diff --git a/gtk/spice-channel.h b/gtk/spice-channel.h
index 52ecd97..4b2af33 100644
--- a/gtk/spice-channel.h
+++ b/gtk/spice-channel.h
@@ -37,7 +37,6 @@ typedef struct _SpiceMsgOut SpiceMsgOut;
 
 /**
  * SpiceChannelEvent:
- *
  * @SPICE_CHANNEL_NONE: no event, or ignored event
  * @SPICE_CHANNEL_OPENED: connection is authentified and ready
  * @SPICE_CHANNEL_CLOSED: connection is closed normally (sent if channel was ready)
diff --git a/gtk/spice-option.c b/gtk/spice-option.c
index 56ec795..9ae1381 100644
--- a/gtk/spice-option.c
+++ b/gtk/spice-option.c
@@ -115,7 +115,7 @@ static gboolean parse_usbredir_filter(const gchar *option_name,
 
 
 /**
- * spice_get_option_group:
+ * spice_get_option_group: (skip)
  *
  * Returns: (transfer full): a #GOptionGroup for the commandline
  * arguments specific to Spice.  You have to call
diff --git a/gtk/spice-session.c b/gtk/spice-session.c
index fac7682..0e405bc 100644
--- a/gtk/spice-session.c
+++ b/gtk/spice-session.c
@@ -894,7 +894,7 @@ static void spice_session_class_init(SpiceSessionClass *klass)
      * hardware smartcard reader. If it's set to a NULL-terminated string
      * array containing the names of 3 valid certificates, these will be
      * used to simulate a smartcard in the guest
-     * @see_also: spice_smartcard_manager_insert_card()
+     * See also spice_smartcard_manager_insert_card()
      *
      * Since: 0.7
      **/
@@ -944,7 +944,7 @@ static void spice_session_class_init(SpiceSessionClass *klass)
                           G_PARAM_STATIC_STRINGS));
 
     /**
-     * SpiceSession::inhibit-keyboard-grab
+     * SpiceSession::inhibit-keyboard-grab:
      *
      * This boolean is set by the usbredir channel to indicate to #SpiceDisplay
      * that the keyboard grab should be temporarily released, because it is
diff --git a/gtk/spice-session.h b/gtk/spice-session.h
index 4895288..b07f525 100644
--- a/gtk/spice-session.h
+++ b/gtk/spice-session.h
@@ -34,7 +34,6 @@ G_BEGIN_DECLS
 
 /**
  * SpiceSessionVerify:
- *
  * @SPICE_SESSION_VERIFY_PUBKEY: verify certificate public key matching
  * @SPICE_SESSION_VERIFY_HOSTNAME: verify certificate hostname matching
  * @SPICE_SESSION_VERIFY_SUBJECT: verify certificate subject matching
@@ -49,7 +48,6 @@ typedef enum {
 
 /**
  * SpiceSessionMigration:
- *
  * @SPICE_SESSION_MIGRATION_NONE: no migration going on
  * @SPICE_SESSION_MIGRATION_SWITCHING: the session is switching host (destroy and reconnect)
  * @SPICE_SESSION_MIGRATION_MIGRATING: the session is migrating seamlessly (reconnect)