/soc/2013/ankitkv/gobjectification: 821aa4bcb6fa: Fix a bunch of...

Ankit Vani a at nevitus.org
Tue Feb 4 07:11:20 EST 2014


Changeset: 821aa4bcb6fa436673c748b29e7a011532d8e0b3
Author:	 Ankit Vani <a at nevitus.org>
Date:	 2014-02-04 17:39 +0530
Branch:	 gtkdoc-conversion
URL: https://hg.pidgin.im/soc/2013/ankitkv/gobjectification/rev/821aa4bcb6fa

Description:

Fix a bunch of gtk-doc warnings in finch

diffstat:

 finch/gntblist.c                |   2 +-
 finch/gntconn.c                 |   2 +-
 finch/gntrequest.c              |  15 ++++++++-------
 finch/libgnt/gnt-skel.c         |   2 +-
 finch/libgnt/gntbindable.c      |   6 +++---
 finch/libgnt/gntbox.c           |   2 +-
 finch/libgnt/gntbutton.c        |   2 +-
 finch/libgnt/gntcheckbox.c      |   2 +-
 finch/libgnt/gntclipboard.c     |   2 +-
 finch/libgnt/gntcolors.c        |   2 +-
 finch/libgnt/gntcombobox.c      |   2 +-
 finch/libgnt/gntentry.c         |   2 +-
 finch/libgnt/gntfilesel.c       |   2 +-
 finch/libgnt/gntkeys.c          |   4 ++--
 finch/libgnt/gntlabel.c         |   2 +-
 finch/libgnt/gntline.c          |   2 +-
 finch/libgnt/gntmain.c          |   8 ++++----
 finch/libgnt/gntmenu.c          |   2 +-
 finch/libgnt/gntmenuitem.c      |   2 +-
 finch/libgnt/gntmenuitemcheck.c |   2 +-
 finch/libgnt/gntprogressbar.c   |   2 +-
 finch/libgnt/gntslider.c        |   2 +-
 finch/libgnt/gntstyle.c         |   2 +-
 finch/libgnt/gnttextview.c      |   4 ++--
 finch/libgnt/gnttree.c          |   2 +-
 finch/libgnt/gntutils.c         |   2 +-
 finch/libgnt/gntwidget.c        |   2 +-
 finch/libgnt/gntwindow.c        |   2 +-
 finch/libgnt/gntwm.c            |   4 ++--
 29 files changed, 44 insertions(+), 43 deletions(-)

diffs (truncated from 350 to 300 lines):

diff --git a/finch/gntblist.c b/finch/gntblist.c
--- a/finch/gntblist.c
+++ b/finch/gntblist.c
@@ -154,7 +154,7 @@ static int color_away;
 static int color_offline;
 static int color_idle;
 
-/**
+/*
  * Buddy List Manager functions.
  */
 
diff --git a/finch/gntconn.c b/finch/gntconn.c
--- a/finch/gntconn.c
+++ b/finch/gntconn.c
@@ -40,7 +40,7 @@ typedef struct {
 	guint timeout;
 } FinchAutoRecon;
 
-/**
+/*
  * Contains accounts that are auto-reconnecting.
  * The key is a pointer to the PurpleAccount and the
  * value is a pointer to a FinchAutoRecon.
diff --git a/finch/gntrequest.c b/finch/gntrequest.c
--- a/finch/gntrequest.c
+++ b/finch/gntrequest.c
@@ -67,7 +67,7 @@ setup_request_window(const char *title, 
 	return window;
 }
 
-/**
+/*
  * If the window is closed by the wm (ie, without triggering any of
  * the buttons, then do some default callback.
  */
@@ -89,12 +89,13 @@ action_performed(GntWidget *button, gpoi
 			 NULL);
 }
 
-/**
- * window: this is the window
- * userdata: the userdata to pass to the primary callbacks
- * cb: the callback
- * data: data for the callback
- * (text, primary-callback) pairs, ended by a NULL
+/*
+ * setup_button_box:
+ * @win: this is the window
+ * @userdata: the userdata to pass to the primary callbacks
+ * @cb: the callback
+ * @data: data for the callback
+ * @...: (text, primary-callback) pairs, ended by a NULL
  *
  * The cancellation callback should be the last callback sent.
  */
diff --git a/finch/libgnt/gnt-skel.c b/finch/libgnt/gnt-skel.c
--- a/finch/libgnt/gnt-skel.c
+++ b/finch/libgnt/gnt-skel.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntbindable.c b/finch/libgnt/gntbindable.c
--- a/finch/libgnt/gntbindable.c
+++ b/finch/libgnt/gntbindable.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
@@ -283,7 +283,7 @@ gnt_bindable_get_gtype(void)
 	return type;
 }
 
-/**
+/*
  * Key Remaps
  */
 const char *
@@ -304,7 +304,7 @@ gnt_bindable_remap_keys(GntBindable *bin
 	return (remap ? remap : text);
 }
 
-/**
+/*
  * Actions and Bindings
  */
 gboolean
diff --git a/finch/libgnt/gntbox.c b/finch/libgnt/gntbox.c
--- a/finch/libgnt/gntbox.c
+++ b/finch/libgnt/gntbox.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntbutton.c b/finch/libgnt/gntbutton.c
--- a/finch/libgnt/gntbutton.c
+++ b/finch/libgnt/gntbutton.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntcheckbox.c b/finch/libgnt/gntcheckbox.c
--- a/finch/libgnt/gntcheckbox.c
+++ b/finch/libgnt/gntcheckbox.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntclipboard.c b/finch/libgnt/gntclipboard.c
--- a/finch/libgnt/gntclipboard.c
+++ b/finch/libgnt/gntclipboard.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntcolors.c b/finch/libgnt/gntcolors.c
--- a/finch/libgnt/gntcolors.c
+++ b/finch/libgnt/gntcolors.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntcombobox.c b/finch/libgnt/gntcombobox.c
--- a/finch/libgnt/gntcombobox.c
+++ b/finch/libgnt/gntcombobox.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntentry.c b/finch/libgnt/gntentry.c
--- a/finch/libgnt/gntentry.c
+++ b/finch/libgnt/gntentry.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntfilesel.c b/finch/libgnt/gntfilesel.c
--- a/finch/libgnt/gntfilesel.c
+++ b/finch/libgnt/gntfilesel.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntkeys.c b/finch/libgnt/gntkeys.c
--- a/finch/libgnt/gntkeys.c
+++ b/finch/libgnt/gntkeys.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
@@ -201,7 +201,7 @@ const char *gnt_key_lookup(const char *k
 	return k.name;
 }
 
-/**
+/*
  * The key-bindings will be saved in a tree. When a keystroke happens, GNT will
  * find the sequence that matches a binding and return the length.
  * A sequence should not be a prefix of another sequence. If it is, then only
diff --git a/finch/libgnt/gntlabel.c b/finch/libgnt/gntlabel.c
--- a/finch/libgnt/gntlabel.c
+++ b/finch/libgnt/gntlabel.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntline.c b/finch/libgnt/gntline.c
--- a/finch/libgnt/gntline.c
+++ b/finch/libgnt/gntline.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntmain.c b/finch/libgnt/gntmain.c
--- a/finch/libgnt/gntmain.c
+++ b/finch/libgnt/gntmain.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
@@ -61,11 +61,11 @@
 #include <ctype.h>
 #include <errno.h>
 
-/**
+/*
  * Notes: Interesting functions to look at:
- * 	scr_dump, scr_init, scr_restore: for workspaces
+ * scr_dump, scr_init, scr_restore: for workspaces
  *
- * 	Need to wattrset for colors to use with PDCurses.
+ * Need to wattrset for colors to use with PDCurses.
  */
 
 static GIOChannel *channel = NULL;
diff --git a/finch/libgnt/gntmenu.c b/finch/libgnt/gntmenu.c
--- a/finch/libgnt/gntmenu.c
+++ b/finch/libgnt/gntmenu.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntmenuitem.c b/finch/libgnt/gntmenuitem.c
--- a/finch/libgnt/gntmenuitem.c
+++ b/finch/libgnt/gntmenuitem.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntmenuitemcheck.c b/finch/libgnt/gntmenuitemcheck.c
--- a/finch/libgnt/gntmenuitemcheck.c
+++ b/finch/libgnt/gntmenuitemcheck.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntprogressbar.c b/finch/libgnt/gntprogressbar.c
--- a/finch/libgnt/gntprogressbar.c
+++ b/finch/libgnt/gntprogressbar.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntslider.c b/finch/libgnt/gntslider.c
--- a/finch/libgnt/gntslider.c
+++ b/finch/libgnt/gntslider.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gntstyle.c b/finch/libgnt/gntstyle.c
--- a/finch/libgnt/gntstyle.c
+++ b/finch/libgnt/gntstyle.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
diff --git a/finch/libgnt/gnttextview.c b/finch/libgnt/gnttextview.c
--- a/finch/libgnt/gnttextview.c
+++ b/finch/libgnt/gnttextview.c
@@ -1,4 +1,4 @@
-/**
+/*
  * GNT - The GLib Ncurses Toolkit
  *
  * GNT is the legal property of its developers, whose names are too numerous
@@ -720,7 +720,7 @@ int gnt_text_view_get_lines_above(GntTex
 	return above;
 }
 
-/**
+/*
  * XXX: There are quite possibly more than a few bugs here.
  */
 int gnt_text_view_tag_change(GntTextView *view, const char *name, const char *text, gboolean all)
diff --git a/finch/libgnt/gnttree.c b/finch/libgnt/gnttree.c
--- a/finch/libgnt/gnttree.c
+++ b/finch/libgnt/gnttree.c
@@ -1,4 +1,4 @@



More information about the Commits mailing list