diff --git a/doc/en/Glade/XML.xml b/doc/en/Glade/XML.xml
index fbe592015..1ba446375 100644
--- a/doc/en/Glade/XML.xml
+++ b/doc/en/Glade/XML.xml
@@ -218,8 +218,16 @@
- To be added
- To be added
+ Automatically connect signals
+
+
+ This method uses gmodule's introspective features to look
+ at the application's symbol table. From here it tries to
+ match the signal handler names given in the interface
+ description with symbols in the application and connects
+ the signals.
+
+
@@ -234,12 +242,16 @@
- To be added
- To be added: an object of type 'string'
- To be added: an object of type 'string'
- To be added: an object of type 'string'
- To be added: an object of type 'bool'
- To be added
+
+ This routine can be used by bindings (such as gtk--) to help
+ construct a object, if it is
+ needed.
+
+ the XML filename
+ the root widget node, or
+ the translation domain, or
+ if construction succeeded
+
@@ -250,9 +262,14 @@
- To be added
- To be added: an object of type 'Gtk.AccelGroup'
- To be added
+
+ This function is used to get the current
+ . If there isn't one, a new one
+ is created and bound to the current toplevel window (if a
+ toplevel has been set).
+
+ the current
+
@@ -268,12 +285,14 @@
- To be added
- To be added: an object of type 'Gtk.Widget'
- To be added: an object of type 'Gtk.Widget'
- To be added: an object of type 'string'
- To be added: an object of type 'string'
- To be added
+
+ This sets the packing property on container of widget with
+ to
+ the container widget.
+ the contained child
+ the name of the property
+ its stringified value
+
@@ -286,10 +305,30 @@
- To be added
- To be added: an object of type 'Glade.WidgetInfo'
- To be added: an object of type 'Gtk.Widget'
- To be added
+
+ This function is not intended for people who just use
+ libglade.
+
+ the structure for the widget.
+ the newly created widget.
+
+
+ This function is not intended for people who just use
+ libglade. Instead it is for people extending it (it is
+ designed to be called in the child build routine defined
+ for the parent widget). It first checks the type of the
+ widget from the class tag, then calls the corresponding
+ widget creation routine. This routine sets up all the
+ settings specific to that type of widget. Then general
+ widget settings are performed on the widget. Then it sets
+ up accelerators for the widget, and extracts any signal
+ information for the widget. Then it checks to see if
+ there are any child widget nodes for this widget, and if
+ so calls the widget's build routine, which will create the
+ children with this function and add them to the widget in
+ the appropriate way. Finally it returns the widget.
+
+
@@ -302,10 +341,19 @@
- To be added
- To be added: an object of type 'string'
- To be added: an object of type 'string'
- To be added
+
+ This function resolves a relative pathname, using the
+ directory of the XML file as a base.
+
+ a filename
+ The absolute filename
+
+
+ This function resolves a relative pathname, using the
+ directory of the XML file as a base. If the pathname is
+ absolute, then the original filename is returned.
+
+
@@ -318,9 +366,16 @@
- To be added
- To be added: an object of type 'Glade.XMLConnectFunc'
- To be added
+
+ This function is similar to
+ except that it will try to connect all signals in the
+ interface, not just a single named handler. It can be
+ thought of the interpeted language binding version of
+ , except that it does not
+ require gmodule to function correctly.
+
+ the function used to connect the signals.
+
@@ -335,11 +390,24 @@
- To be added
- To be added: an object of type 'Gtk.Widget'
- To be added: an object of type 'string'
- To be added: an object of type 'string'
- To be added
+ Used to set properties on s
+ the property the widget to set the property on.
+ the name of the property.
+ the name of the widget used as the value for the property.
+
+
+ Some widgets have properties of type . These are
+ represented as the widget name in the glade file. When
+ constructing the interface, the widget specified as the
+ value for a property may not exist yet.
+
+
+ Rather than setting the property directly, this function
+ should be used. It will perform the name to conversion,
+ and if the widget is yet to be constructed, defer setting the
+ property until the widget is constructed.
+
+
@@ -359,8 +427,7 @@
the beginning of a widget name
a of widgets whose name starts
- with
-
+ with
@@ -397,7 +464,7 @@
- To be added
+ GParamSpec needs to be wrapped
To be added: an object of type 'IntPtr'
To be added: an object of type 'string'
To be added: an object of type 'GLib.Value'
@@ -416,10 +483,17 @@
- To be added
- To be added: an object of type 'string'
- To be added: an object of type 'Glade.XMLConnectFunc'
- To be added
+
+ This function is similar to , except
+ that it allows you to give an arbitrary function that will
+ be used for actually connecting the signals. This is mainly
+ useful for writers of interpreted language bindings, or
+ applications where you need more control over the signal
+ connection process.
+
+ the name of the signal handler that we want to connect.
+ the function to use to connect the signals.
+
@@ -529,18 +603,6 @@
-
-
- Property
-
- Gtk.Widget
-
-
- To be added
- To be added: an object of type 'Gtk.Widget'
- To be added
-
-
Property
@@ -561,10 +623,20 @@
- To be added
+
+ This is used while the tree is being built to set the toplevel window that
+ is currently being built.
+
To be added: an object of type 'Gtk.Window'
To be added: an object of type 'Gtk.Window'
- To be added
+
+
+ This is used while the tree is being built to set the
+ toplevel window that is currently being built. It is
+ mainly used to enable 's to be bound to the
+ correct window, but could have other uses.
+
+
@@ -593,12 +665,22 @@
- To be added
+
+ Creates an object from a
+
a
- a
- a
- a
- To be added
+
+ the widget node to start building from, or .
+
+
+ the translation domain for the XML file
+ ( is the default)
+
+
+ the newly created object, or
+ if the operation failed.
+
+
@@ -612,13 +694,27 @@
- To be added
- a
- a
- a
- a
- a
- To be added
+
+ Creates an object from an
+
+
+
+ an , or
+ to use the current assembly
+
+ the name of the resource in
+
+ the widget node to start building from, or .
+
+
+ the translation domain for the XML file
+ ( is the default)
+
+
+ the newly created object, or
+ if the operation failed.
+
+