aboutsummaryrefslogtreecommitdiffstats
path: root/lib
diff options
context:
space:
mode:
authorAdam Hooper <adamh@src.gnome.org>2004-04-20 11:41:10 +0800
committerAdam Hooper <adamh@src.gnome.org>2004-04-20 11:41:10 +0800
commit5b8d9335abe1cb1b27eea737fa891cb3f1f4edfd (patch)
tree796a796180f8a279dda95fdd3867cc7953c52232 /lib
parenta9e1a2ff9e8ef749ea4f4e4c1f7341c9ced15c38 (diff)
downloadgsoc2013-epiphany-5b8d9335abe1cb1b27eea737fa891cb3f1f4edfd.tar
gsoc2013-epiphany-5b8d9335abe1cb1b27eea737fa891cb3f1f4edfd.tar.gz
gsoc2013-epiphany-5b8d9335abe1cb1b27eea737fa891cb3f1f4edfd.tar.bz2
gsoc2013-epiphany-5b8d9335abe1cb1b27eea737fa891cb3f1f4edfd.tar.lz
gsoc2013-epiphany-5b8d9335abe1cb1b27eea737fa891cb3f1f4edfd.tar.xz
gsoc2013-epiphany-5b8d9335abe1cb1b27eea737fa891cb3f1f4edfd.tar.zst
gsoc2013-epiphany-5b8d9335abe1cb1b27eea737fa891cb3f1f4edfd.zip
Documented EphyGlade
Diffstat (limited to 'lib')
-rw-r--r--lib/ephy-glade.c24
1 files changed, 19 insertions, 5 deletions
diff --git a/lib/ephy-glade.c b/lib/ephy-glade.c
index f6edad31a..5cd521a77 100644
--- a/lib/ephy-glade.c
+++ b/lib/ephy-glade.c
@@ -35,9 +35,25 @@ glade_signal_connect_func (const gchar *cb_name, GObject *obj,
gpointer user_data);
/**
- * ephy_widget_new: build a new widget of the provided name, with all
- * signals attached and data set to the provided parameter.
- */
+ * ephy_glade_widget_new:
+ * @file: a Glade XML file
+ * @widget_name: the name of a widget within @file
+ * @root: the returned root #GtkWidget pointer, or %NULL if not wanted
+ * @data: callback data to connect to all @root's signal callbacks
+ * @domain: the translation domain for the XML file (or %NULL for default)
+ *
+ * Builds a new #GladeXML object from the given @file with root widget
+ * @widget_name. The widget can also be aquired by passing @root, a pointer
+ * to a #GtkWidget pointer.
+ *
+ * The signal callbacks underneath the desired root widget in @file will all be
+ * automatically connected; the callback data will be @data.
+ *
+ * Libglade automatically caches @file; it is not inefficient to call
+ * ephy_glade_widget_new() several times on the same XML file.
+ *
+ * Return value: the desired #GladeXML object, or %NULL on failure
+ **/
GladeXML *
ephy_glade_widget_new (const char *file,
const char *widget_name,
@@ -48,8 +64,6 @@ ephy_glade_widget_new (const char *file,
GladeXML *gxml;
/* build the widget */
- /* note that libglade automatically caches the parsed file,
- * so we don't need to worry about the efficiency of this */
gxml = glade_xml_new (file, widget_name, domain);
g_return_val_if_fail (gxml != NULL, NULL);