Separate the glib and gobject bindings in the manual.

2008-08-02  Johan Dahlin  <johan@gnome.org>

    * docs/Makefile.am:
    * docs/reference/pyglib-constants.xml:
    * docs/reference/pyglib-functions.xml:
    * docs/reference/pyglib-maincontext.xml:
    * docs/reference/pyglib-mainloop.xml:
    * docs/reference/pygobject-classes.xml:
    * docs/reference/pygobject-constants.xml:
    * docs/reference/pygobject-functions.xml:
    * docs/reference/pygobject-maincontext.xml:
    * docs/reference/pygobject-mainloop.xml:
    Separate the glib and gobject bindings in the manual.


svn path=/trunk/; revision=910

1 files changed, 2 insertions, 761 deletions

diff --git a/docs/reference/pygobject-functions.xml b/docs/reference/pygobject-functions.xml
index c0c6234..a35afec 100644
--- a/docs/reference/pygobject-functions.xml
+++ b/docs/reference/pygobject-functions.xml
@@ -86,63 +86,6 @@ linkend="function-gobject--new">gobject.new</link></methodname>
 	<methodparam><parameter>...</parameter></methodparam>
   </methodsynopsis><methodsynopsis language="python">
 	<methodname><link
-linkend="function-gobject--idle-add">gobject.idle_add</link></methodname>
-	<methodparam><parameter>callback</parameter></methodparam>
-	<methodparam><parameter>...</parameter></methodparam>
-  </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--timeout-add">gobject.timeout_add</link></methodname>
-	<methodparam><parameter>interval</parameter></methodparam>
-	<methodparam><parameter>callback</parameter></methodparam>
-	<methodparam><parameter>...</parameter></methodparam>
-  </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--io-add-watch">gobject.io_add_watch</link></methodname>
-	<methodparam><parameter>fd</parameter></methodparam>
-	<methodparam><parameter>condition</parameter></methodparam>
-	<methodparam><parameter>callback</parameter></methodparam>
-	<methodparam><parameter>...</parameter></methodparam>
-  </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--source-remove">gobject.source_remove</link></methodname>
-	<methodparam><parameter>tag</parameter></methodparam>
-  </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--main-context-default">gobject.main_context_default</link></methodname>
-	<methodparam></methodparam>
-      </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--markup-escape-text">gobject.markup_escape_text</link></methodname>
-	<methodparam><parameter role="keyword">text</parameter></methodparam>
-      </methodsynopsis><methodsynopsis language="python">
-        <methodname><link linkend="function-gobject--child-watch-add">gobject.child_watch_add</link></methodname>
-        <methodparam><parameter role="keyword">pid</parameter></methodparam>
-        <methodparam><parameter role="keyword">function</parameter></methodparam>
-        <methodparam><parameter role="keyword">data</parameter><initializer>None</initializer></methodparam>
-        <methodparam><parameter role="keyword">priority</parameter><initializer>gobject.PRIORITY_DEFAULT</initializer></methodparam>
-      </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--spawn-async">gobject.spawn_async</link></methodname>
-	<methodparam><parameter role="keyword">argv</parameter></methodparam>
-	<methodparam><parameter role="keyword">envp</parameter><initializer>None</initializer></methodparam>
- 	<methodparam><parameter role="keyword">working_directory</parameter><initializer>None</initializer></methodparam>
-	<methodparam><parameter role="keyword">flags</parameter><initializer>0</initializer></methodparam>
- 	<methodparam><parameter role="keyword">child_setup</parameter><initializer>None</initializer></methodparam>
-	<methodparam><parameter role="keyword">user_data</parameter><initializer>None</initializer></methodparam>
- 	<methodparam><parameter role="keyword">standard_input</parameter><initializer>None</initializer></methodparam>
-	<methodparam><parameter role="keyword">standard_output</parameter><initializer>None</initializer></methodparam>
- 	<methodparam><parameter role="keyword">standard_error</parameter><initializer>None</initializer></methodparam>
-     </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--get-current-time">gobject.get_current_time</link></methodname>
-      </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--main-depth">gobject.main_depth</link></methodname>
-      </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--threads-init">gobject.threads_init</link></methodname>
-      </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
 linkend="function-gobject--signal-accumulator-true-handled">gobject.signal_accumulator_true_handled</link></methodname>
       </methodsynopsis><methodsynopsis language="python">
 	<methodname><link
@@ -161,19 +104,8 @@ linkend="function-gobject--remove-emission-hook">gobject.remove_emission_hook</l
 	<methodname><link
 linkend="function-gobject---install-metaclass">gobject._install_metaclass</link></methodname>
  	<methodparam><parameter>metaclass</parameter></methodparam>
-      </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--filename-display-name">gobject.filename_display_name</link></methodname>
- 	<methodparam><parameter>filename</parameter></methodparam>
-      </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--filename-display-basename">gobject.filename_display_basename</link></methodname>
- 	<methodparam><parameter>filename</parameter></methodparam>
-      </methodsynopsis><methodsynopsis language="python">
-	<methodname><link
-linkend="function-gobject--filename-from-utf8">gobject.filename_from_utf8</link></methodname>
- 	<methodparam><parameter>utf8string</parameter></methodparam>
-      </methodsynopsis></programlisting>
+      </methodsynopsis>
+    </programlisting>
 
   </refsect1>
 
@@ -816,593 +748,6 @@ properties.</para>
 
     </refsect2>
 
-    <refsect2 id="function-gobject--idle-add">
-      <title>gobject.idle_add</title>
-
-      <programlisting><methodsynopsis language="python">
-	  <methodname>gobject.idle_add</methodname>
-	  <methodparam><parameter>callback</parameter></methodparam>
-	  <methodparam><parameter>...</parameter></methodparam>
-	</methodsynopsis></programlisting>
-      <variablelist>
-	<varlistentry>
-	  <term><parameter>callback</parameter>&nbsp;:</term>
-	  <listitem><simpara>a function to call when
-<literal>PyGTK</literal> is idle</simpara></listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><parameter>...</parameter>&nbsp;:</term>
-	  <listitem><simpara>optionals arguments to be passed to
-<parameter>callback</parameter></simpara></listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
-	  <listitem><simpara>an integer ID</simpara></listitem>
-	</varlistentry>
-      </variablelist>
-
-      <para>The <function>gobject.idle_add</function>() function adds a
-function (specified by <parameter>callback</parameter>) to be called
-whenever there are no higher priority events pending to the default main
-loop. The function is given the default idle priority,
-<literal>gobject.PRIORITY_DEFAULT_IDLE</literal>. Additional arguments to
-pass to <parameter>callback</parameter> can be specified after
-<parameter>callback</parameter>. The idle priority can be specified as a
-keyword-value pair with the keyword "priority". If
-<parameter>callback</parameter> returns <literal>FALSE</literal> it is
-automatically removed from the list of event sources and will not be called
-again.</para>
-
-    </refsect2>
-
-    <refsect2 id="function-gobject--timeout-add">
-      <title>gobject.timeout_add</title>
-
-      <programlisting><methodsynopsis language="python">
-	  <methodname>gobject.timeout_add</methodname>
-	  <methodparam><parameter>interval</parameter></methodparam>
-	  <methodparam><parameter>callback</parameter></methodparam>
-	  <methodparam><parameter>...</parameter></methodparam>
-	</methodsynopsis></programlisting>
-      <variablelist>
-	<varlistentry>
-	  <term><parameter>interval</parameter>&nbsp;:</term>
-	  <listitem><simpara>the time between calls to the function, in
-milliseconds </simpara></listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><parameter>callback</parameter>&nbsp;:</term>
-	  <listitem><simpara>the function to call</simpara></listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><parameter>...</parameter>&nbsp;:</term>
-	  <listitem><simpara>zero or more arguments that will be passed to
-<parameter>callback</parameter></simpara></listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
-	  <listitem><simpara>an integer ID of the event
-source</simpara></listitem>
-	</varlistentry>
-      </variablelist>
-
-      <para>The <function>gobject.timeout_add</function>() function sets a
-function (specified by <parameter>callback</parameter>) to be called at
-regular intervals (specified by <parameter>interval</parameter>, with the
-default priority, <literal>gobject.PRIORITY_DEFAULT</literal>. Additional
-arguments to pass to <parameter>callback</parameter> can be specified after
-<parameter>callback</parameter>. The idle priority may be specified as a
-keyword-value pair with the keyword "priority".</para>
-
-      <para>The function is called repeatedly until it returns
-<literal>FALSE</literal>, at which point the timeout is automatically
-destroyed and the function will not be called again. The first call to the
-function will be at the end of the first interval. Note that timeout
-functions may be delayed, due to the processing of other event sources. Thus
-they should not be relied on for precise timing. After each call to the
-timeout function, the time of the next timeout is recalculated based on the
-current time and the given interval (it does not try to 'catch up' time lost
-in delays).</para>
-
-    </refsect2>
-
-    <refsect2 id="function-gobject--io-add-watch">
-      <title>gobject.io_add_watch</title>
-
-      <programlisting><methodsynopsis language="python">
-	  <methodname>gobject.io_add_watch</methodname>
-	  <methodparam><parameter>fd</parameter></methodparam>
-	  <methodparam><parameter>condition</parameter></methodparam>
-	  <methodparam><parameter>callback</parameter></methodparam>
-	  <methodparam><parameter>...</parameter></methodparam>
-	</methodsynopsis></programlisting>
-      <variablelist>
-	<varlistentry>
-	  <term><parameter>fd</parameter>&nbsp;:</term>
-	  <listitem><simpara>a Python file object or an integer file
-descriptor ID</simpara></listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><parameter>condition</parameter>&nbsp;:</term>
-	  <listitem><simpara>a condition mask</simpara></listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><parameter>callback</parameter>&nbsp;:</term>
-	  <listitem><simpara>a function to call</simpara></listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><parameter>...</parameter>&nbsp;:</term>
-	  <listitem><simpara>additional arguments to pass to
-<parameter>callback</parameter></simpara></listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
-	  <listitem><simpara>an integer ID of the event source</simpara></listitem>
-	</varlistentry>
-      </variablelist>
-
-      <para>The <function>gobject.io_add_watch</function>() function
-arranges for the file (specified by <parameter>fd</parameter>) to be
-monitored by the main loop for the specified
-<parameter>condition</parameter>. <parameter>fd</parameter> may be a Python
-file object or an integer file descriptor. The value of condition is a
-combination of:</para>
-
-      <variablelist>
-	<varlistentry>
-	  <term><literal>gobject.IO_IN</literal></term>
-	  <listitem>
-	    <simpara>There is data to read.</simpara>
-	  </listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><literal>gobject.IO_OUT</literal></term>
-	  <listitem>
-	    <simpara>Data can be written (without blocking). </simpara>
-	  </listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><literal>gobject.IO_PRI</literal></term>
-	  <listitem>
-	    <simpara>There is urgent data to read.</simpara>
-	  </listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><literal>gobject.IO_ERR</literal></term>
-	  <listitem>
-	    <simpara>Error condition.</simpara>
-	  </listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><literal>gobject.IO_HUP</literal></term>
-	  <listitem>
-	    <simpara>Hung up (the connection has been broken, usually for
-pipes and sockets).</simpara>
-	  </listitem>
-	</varlistentry>
-      </variablelist>
-
-      <para>Additional arguments to pass to <parameter>callback</parameter>
-can be specified after <parameter>callback</parameter>. The idle priority
-may be specified as a keyword-value pair with the keyword "priority". The
-signature of the callback function is:</para>
-
-      <programlisting>
-  def callback(source, cb_condition, ...)
-</programlisting>
-
-      <para>where <parameter>source</parameter> is
-<parameter>fd</parameter>, the file descriptor;
-<parameter>cb_condition</parameter> is the condition that triggered the
-signal; and, <parameter>...</parameter> are the zero or more arguments that
-were passed to the <function>gobject.io_add_watch</function>()
-function.</para>
-
-      <para>If the callback function returns <literal>FALSE</literal> it
-will be automatically removed from the list of event sources and will not be
-called again. If it returns <literal>TRUE</literal> it will be called again
-when the condition is matched.</para>
-
-    </refsect2>
-
-    <refsect2 id="function-gobject--source-remove">
-      <title>gobject.source_remove</title>
-
-      <programlisting><methodsynopsis language="python">
-	  <methodname>gobject.source_remove</methodname>
-	  <methodparam><parameter>tag</parameter></methodparam>
-	</methodsynopsis></programlisting>
-      <variablelist>
-	<varlistentry>
-	  <term><parameter>tag</parameter>&nbsp;:</term>
-	  <listitem><simpara>an integer ID</simpara></listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
-	  <listitem><simpara><literal>TRUE</literal> if the event source was
-removed</simpara></listitem>
-	</varlistentry>
-      </variablelist>
-
-      <para>The <function>gobject.source_remove</function>() function
-removes the event source specified by tag (as returned by the <link
-linkend="function-gobject--idle-add"><function>gobject.idle_add</function>()</link>, 
-<link
-linkend="function-gobject--timeout-add"><function>gobject.timeout_add</function></link>() 
-and <link
-linkend="function-gobject--io-add-watch"><function>gobject.io_add_watch</function>()</link> 
-functions)</para>
-
-    </refsect2>
-
-    <refsect2 id="function-gobject--main-context-default">
-      <title>gobject.main_context_default</title>
-
-      <programlisting><methodsynopsis language="python">
-	  <methodname>gobject.main_context_default</methodname>
-	  <methodparam></methodparam>
-	</methodsynopsis></programlisting>
-      <variablelist>
-	<varlistentry>
-	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
-	  <listitem><simpara>the default gobject.MainContext
-object</simpara></listitem>
-	</varlistentry>
-      </variablelist>
-
-      <para>The <function>gobject.main_context_default</function>() function
-returns the default gobject.MainContext object.</para>
-
-    </refsect2>
-
-    <refsect2 id="function-gobject--markup-escape-text">
-      <title>gobject.markup_escape_text</title>
-
-      <programlisting><methodsynopsis language="python">
-	  <methodname>gobject.markup_escape_text</methodname>
-	  <methodparam><parameter>text</parameter></methodparam>
-	</methodsynopsis></programlisting>
-      <variablelist>
-	<varlistentry>
-	  <term><parameter>text</parameter>&nbsp;:</term>
-	  <listitem><simpara>the UTF-8 string to be
-escaped</simpara></listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
-	  <listitem><simpara>the escaped text</simpara></listitem>
-	</varlistentry>
-      </variablelist>
-
-      <note>
-        <para>This function is available in PyGTK 2.8 and above.</para>
-      </note>
-
-      <para>The <function>gobject.markup_escape_text</function>() function
-escapes the string specified by <parameter>text</parameter> so that the
-markup parser will parse it verbatim. Less than, greater than, ampersand,
-etc. are replaced with the corresponding entities. This function would
-typically be used when writing out a file to be parsed with the markup
-parser.</para>
-
-      <para>Note that this function doesn't protect whitespace and line
-endings from being processed according to the XML rules for normalization of
-line endings and attribute values.</para>
-
-    </refsect2>
-
-    <refsect2 id="function-gobject--child-watch-add">
-      <title>gobject.child_watch_add</title>
-      
-      <programlisting><methodsynopsis language="python">
-        <methodname>gobject.child_watch_add</methodname>
-        <methodparam><parameter role="keyword">pid</parameter></methodparam>
-        <methodparam><parameter role="keyword">function</parameter></methodparam>
-        <methodparam><parameter role="keyword">data</parameter><initializer>None</initializer></methodparam>
-        <methodparam><parameter role="keyword">priority</parameter><initializer>gobject.PRIORITY_DEFAULT</initializer></methodparam>
-	</methodsynopsis></programlisting>
-      <variablelist role="params">
-        <varlistentry>
-          <term><parameter role="keyword">pid</parameter>&nbsp;:</term>
-          <listitem><simpara>process id of a child process to watch</simpara></listitem>
-        </varlistentry>
-        <varlistentry><term><parameter role="keyword">function</parameter>&nbsp;:</term>
-          <listitem><simpara>the function to call</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><parameter role="keyword">data</parameter>&nbsp;:</term>
-          <listitem><simpara>the optional data to pass to
-<parameter>function</parameter></simpara></listitem>
-        </varlistentry>
-         <varlistentry>
-          <term><parameter role="keyword">priority</parameter>&nbsp;:</term>
-          <listitem><simpara>the priority of the idle source - one of the
-<xref linkend="gobject-priority-constants"
-endterm="gobject-priority-constants-title"></xref></simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><emphasis>Returns</emphasis>&nbsp;:</term>
-          <listitem><simpara>the id of event source.</simpara></listitem>
-        </varlistentry>
-      </variablelist>
-      <note>
-        <para>This function is available in PyGTK 2.6 and above.</para>
-      </note>
-
-      <para>The <function>gobject.child_watch_add</function>() function sets
-the function specified by <parameter>function</parameter> to be called with
-the user data specified by <parameter>data</parameter> when the child
-indicated by <parameter>pid</parameter> exits. The signature for the
-callback is:</para>
-
-      <programlisting>
-def callback(pid, condition, user_data)
-</programlisting>
-
-      <para>where <parameter>pid</parameter> is is the child process id,
-<parameter>condition</parameter> is the status information about the child
-process and <parameter>user_data</parameter> is <parameter>data</parameter>
-PyGTK supports only a single callback per process id.</para>
-
-    </refsect2>
-
-    <refsect2 id="function-gobject--spawn-async">
-      <title>gobject.spawn_async</title>
-      
-      <programlisting><methodsynopsis language="python">
-        <methodname>gobject.spawn_async</methodname>
-          <methodparam><parameter role="keyword">argv</parameter></methodparam>
-          <methodparam><parameter role="keyword">envp</parameter><initializer>None</initializer></methodparam>
-          <methodparam><parameter role="keyword">working_directory</parameter><initializer>None</initializer></methodparam>
-          <methodparam><parameter role="keyword">flags</parameter><initializer>0</initializer></methodparam>
-          <methodparam><parameter role="keyword">child_setup</parameter><initializer>None</initializer></methodparam>
-          <methodparam><parameter role="keyword">user_data</parameter><initializer>None</initializer></methodparam>
-          <methodparam><parameter role="keyword">standard_input</parameter><initializer>None</initializer></methodparam>
-          <methodparam><parameter role="keyword">standard_output</parameter><initializer>None</initializer></methodparam>
-          <methodparam><parameter role="keyword">standard_error</parameter><initializer>None</initializer></methodparam>
- 	</methodsynopsis></programlisting>
-      <variablelist role="params">
-        <varlistentry>
-          <term><parameter role="keyword">argv</parameter>&nbsp;:</term>
-          <listitem><simpara>a sequence of strings containing the arguments
-of the child process</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><parameter role="keyword">envp</parameter>&nbsp;:</term>
-          <listitem><simpara>the child's environment or
-<literal>None</literal> to inherit the parent's
-environment.</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><parameter role="keyword">working_directory</parameter>&nbsp;:</term>
-          <listitem><simpara>the child's current working directory, or
-<literal>None</literal> to inherit parent's</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><parameter role="keyword">flags</parameter>&nbsp;:</term>
-          <listitem><simpara>flags from the <xref
-linkend="gobject-spawn-flag-constants"
-endterm="gobject-spawn-flag-constants-title"></xref>.</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><parameter role="keyword">child_setup</parameter>&nbsp;:</term>
-          <listitem><simpara>a function to run in the child just before
-calling <function>exec</function>()</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><parameter role="keyword">user_data</parameter>&nbsp;:</term>
-          <listitem><simpara>the user data for the
-<parameter>child_setup</parameter> function</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><parameter role="keyword">standard_input</parameter>&nbsp;:</term>
-          <listitem><simpara>if <literal>TRUE</literal> return the file
-descriptor for the child's stdin</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><parameter role="keyword">standard_output</parameter>&nbsp;:</term>
-          <listitem><simpara>if <literal>TRUE</literal> return the file
-descriptor for the child's stdout</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><parameter role="keyword">standard_error</parameter>&nbsp;:</term>
-          <listitem><simpara>if <literal>TRUE</literal> return the file
-descriptor for the child's stderr</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><emphasis>Returns</emphasis>&nbsp;:</term>
-          <listitem><simpara>a 4-tuple containing the child's process id and
-the stdin, stdout and stderr file descriptor integers.</simpara></listitem>
-        </varlistentry>
-      </variablelist>
-      <note>
-        <para>This function is available in PyGTK 2.6 and above.</para>
-      </note>
-
-      <para>The <function>gobject.spawn_async</function>() function executes
-a child program asynchronously (your program will not block waiting for the
-child to exit). The child program is specified by the only argument that
-must be provided, <parameter>argv</parameter>. <parameter>argv</parameter>
-should be a sequence of strings, to be passed as the argument vector for the
-child. The first string in <parameter>argv</parameter> is of course the name
-of the program to execute. By default, the name of the program must be a
-full path; the <envar>PATH</envar> shell variable will only be searched if
-you pass the <literal>gobject.SPAWN_SEARCH_PATH</literal> flag in
-<parameter>flags</parameter>. The function returns a 4-tuple containing the
-child's process id and the file descriptors for the child's stdin, stdout
-and stderr. The stdin, stdout and stderr file descriptors are returned only
-ofthe corresponding <parameter>standard_input</parameter>,
-<parameter>standard_output</parameter> or
-<parameter>standard_error</parameter> params are
-<literal>TRUE</literal>.</para>
-
-      <para>On Windows, the low-level child process creation API
-(<function>CreateProcess</function>()) doesn't use argument vectors, but a
-command line. The C runtime library's <function>spawn*</function>() family
-of functions (which <link
-linkend="function-gobject--spawn-async"><function>gobject.spawn_async</function>()</link>
-eventually calls) paste the argument vector elements into a command line,
-and the C runtime startup code does a corresponding reconstruction of an
-argument vector from the command line, to be passed to
-<function>main</function>(). Complications arise when you have argument
-vector elements that contain spaces of double quotes. The
-<function>spawn*</function>() functions don't do any quoting or escaping,
-but on the other hand the startup code does do unquoting and unescaping in
-order to enable receiving arguments with embedded spaces or double
-quotes. To work around this asymmetry, the <link
-linkend="function-gobject--spawn-async"><function>gobject.spawn_async</function>()</link>
-function will do quoting and escaping on argument vector elements that need
-it before calling the C runtime <function>spawn</function>()
-function.</para>
-
-      <para><parameter>envp</parameter> is a sequence of strings, where each
- string has the form <literal>KEY=VALUE</literal>. This will become the
- child's environment. If <parameter>envp</parameter> is
- <parameter>None</parameter> or not specified, the child inherits its
- parent's environment.</para>
-
-      <para><parameter>flags</parameter> should be the bitwise
-<literal>OR</literal> of the <xref linkend="gobject-spawn-flag-constants"
-endterm="gobject-spawn-flag-constants-title"></xref> you want to affect the
-function's behaviour. The <literal>gobject.SPAWN_DO_NOT_REAP_CHILD</literal>
-flag means that the child will not automatically be reaped; you must use a
-GChildWatch source to be notified about the death of the child
-process. Eventually you must call g_spawn_close_pid() on the child_pid, in
-order to free resources which may be associated with the child process. (On
-Unix, using a GChildWatch source is equivalent to calling
-<function>waitpid</function>() or handling the <literal>SIGCHLD</literal>
-signal manually. On Windows, calling g_spawn_close_pid() is equivalent to
-calling <function>CloseHandle</function>() on the process handle
-returned).</para>
-
-      <para><literal>gobject.SPAWN_LEAVE_DESCRIPTORS_OPEN</literal> means
-that the parent's open file descriptors will be inherited by the child;
-otherwise all descriptors except stdin/stdout/stderr will be closed before
-calling <function>exec</function>() in the
-child. <literal>gobject.SPAWN_SEARCH_PATH</literal> means that
-<parameter>argv</parameter>[0] need not be an absolute path, it will be
-looked for in the user's
-<envar>PATH</envar>. <literal>gobject.SPAWN_STDOUT_TO_DEV_NULL</literal>
-means that the child's standard output will be discarded, instead of going
-to the same location as the parent's standard output. If you use this flag,
-<parameter>standard_output</parameter> must be
-<literal>None</literal>. <literal>gobject.SPAWN_STDERR_TO_DEV_NULL</literal>
-means that the child's standard error will be discarded, instead of going to
-the same location as the parent's standard error. If you use this flag,
-<parameter>standard_error</parameter> must be
-<literal>None</literal>. <literal>gobject.SPAWN_CHILD_INHERITS_STDIN</literal>
-means that the child will inherit the parent's standard input (by default,
-the child's standard input is attached to
-<filename>/dev/null</filename>). If you use this flag,
-<parameter>standard_input</parameter> must be
-<literal>None</literal>. <literal>gobject.SPAWN_FILE_AND_ARGV_ZERO</literal>
-means that the first element of <parameter>argv</parameter> is the file to
-execute, while the remaining elements are the actual argument vector to pass
-to the file. Normally the <link
-linkend="function-gobject--spawn-async"><function>gobject.spawn_async</function>()</link>
-function uses <parameter>argv</parameter>[0] as the file to execute, and
-passes all of <parameter>argv</parameter> to the child.</para>
-
-      <para><parameter>child_setup</parameter> and
-<parameter>user_data</parameter> are a function and user data. On POSIX
-platforms, the function is called in the child after GLib has performed all
-the setup it plans to perform (including creating pipes, closing file
-descriptors, etc.) but before calling <function>exec</function>(). That is,
-<parameter>child_setup</parameter> is called just before calling
-<function>exec</function>() in the child. Obviously actions taken in this
-function will only affect the child, not the parent. On Windows, there is no
-separate <function>fork</function>() and <function>exec</function>()
-functionality. Child processes are created and run right away with one API
-call,
-<function>CreateProcess</function>(). <parameter>child_setup</parameter> is
-called in the parent process just before creating the child process. You
-should carefully consider what you do in <parameter>child_setup</parameter>
-if you intend your software to be portable to Windows.</para>
-
-      <para>The returned child process id can be used to send signals to the
-child, or to wait for the child if you specified the
-<literal>gobject.SPAWN_DO_NOT_REAP_CHILD</literal> flag.  On Windows, child
-pid will be returned only if you specified the
-<literal>gobject.SPAWN_DO_NOT_REAP_CHILD</literal> flag.</para>
-
-      <para>The caller of the <link
-linkend="function-gobject--spawn-async"><function>gobject.spawn_async</function>()</link>
-must close any returned file descriptors when they are no longer in
-use.</para>
-
-      <para>If <parameter>standard_input</parameter> is
-<literal>None</literal>, the child's standard input is attached to
-<filename>/dev/null</filename> unless
-<literal>gobject.SPAWN_CHILD_INHERITS_STDIN</literal> is set.</para>
-
-      <para>If <parameter>standard_error</parameter> is
-<literal>None</literal>, the child's standard error goes to the same
-location as the parent's standard error unless
-<literal>gobject.SPAWN_STDERR_TO_DEV_NULL</literal> is set.</para>
-
-      <para>If <parameter>standard_output</parameter> is
-<literal>None</literal>, the child's standard output goes to the same
-location as the parent's standard output unless
-<literal>gobject.SPAWN_STDOUT_TO_DEV_NULL</literal> is set.</para>
-
-      <para>If an error occurs, the gobject.GError exception will be
-raised.</para>
-
-    </refsect2>
-
-    <refsect2 id="function-gobject--get-current-time">
-      <title>gobject.get_current_time</title>
-      
-      <programlisting><methodsynopsis language="python">
-        <methodname>gobject.get_current_time</methodname>
-	</methodsynopsis></programlisting>
-      <variablelist role="params">
-        <varlistentry>
-          <term><emphasis>Returns</emphasis>&nbsp;:</term>
-          <listitem><simpara>the current time as the number of seconds and
-microseconds from the epoch.</simpara></listitem>
-        </varlistentry>
-      </variablelist>
-      <note>
-        <para>This function is available in PyGTK 2.8 and above.</para>
-      </note>
-
-      <para>The <function>gobject.get_current_time</function>() function
-reurns the current time of day as the number of seconds and microseconds
-from the epoch.</para>
-
-    </refsect2>
-
-    <refsect2 id="function-gobject--main-depth">
-      <title>gobject.main_depth</title>
-      
-      <programlisting><methodsynopsis language="python">
-        <methodname>gobject.main_depth</methodname>
-	</methodsynopsis></programlisting>
-      <variablelist role="params">
-        <varlistentry>
-          <term><emphasis>Returns</emphasis>&nbsp;:</term>
-          <listitem><simpara>the depth of the stack of calls to the main
-context.</simpara></listitem>
-        </varlistentry>
-      </variablelist>
-      <note>
-        <para>This function is available in PyGTK 2.8 and above.</para>
-      </note>
-
-      <para>The <function>main_depth</function>() function returns the depth
-of the stack of calls in the main context. That is, when called from the
-toplevel, it gives 0. When called from within a callback from the <link
-linkend="method-gobjectmaincontext--iteration"><methodname>gobject.MainContext.iteration</methodname>()</link>
-method (or the <link
-linkend="method-gobjectmainloop--run"><methodname>gobject.MainLoop.run</methodname>()</link>
-method, etc.) it returns 1. When called from within a callback to a
-recursive call to the <link
-linkend="method-gobjectmaincontext--iteration"><methodname>gobject.MainContext.iteration</methodname>()</link>
-method), it returns 2. And so forth.</para>
-
-    </refsect2>
-
     <refsect2 id="function-gobject--threads-init">
       <title>gobject.threads_init</title>
       
@@ -1554,110 +899,6 @@ method), it returns 2. And so forth.</para>
 
     </refsect2>
 
-    <refsect2 id="function-gobject--filename-display-name">
-      <title>gobject.filename_display_name</title>
-      
-      <programlisting><methodsynopsis language="python">
-        <methodname>gobject.filename_display_name</methodname>
-        <methodparam><parameter>filename</parameter></methodparam>
-	</methodsynopsis></programlisting>
-      <variablelist role="params">
-        <varlistentry>
-          <term><emphasis>filename</emphasis>&nbsp;:</term>
-          <listitem><simpara>a pathname in the file name
-          encoding</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><emphasis>Returns</emphasis>&nbsp;:</term>
-          <listitem><simpara>an UTF8 rendition of
-          <parameter>filename</parameter>.</simpara></listitem>
-        </varlistentry>
-      </variablelist>
-      <note>
-        <para>This function is available in PyGTK 2.10 and above.</para>
-      </note>
-
-      <para>The <function>filename_display_name</function>() function
-      converts a filename into a valid UTF-8 string. The conversion is not
-      necessarily reversible, so you should keep the original around and use
-      the return value of this function only for display purposes. Unlike
-      g_filename_to_utf8(), the result is guaranteed to be non-None even if
-      the filename actually isn't in the file name encoding.</para>
-
-      <para>If you know the whole pathname of the file you should use the
-      <link
-      linkend="function-gobject--filename-display-basename"><function>gobject.filename_display_basename</function>()</link>
-      function, since that allows location-based translation of
-      filenames.</para>
-
-    </refsect2>
-
-    <refsect2 id="function-gobject--filename-display-basename">
-      <title>gobject.filename_display_basename</title>
-      
-      <programlisting><methodsynopsis language="python">
-        <methodname>gobject.filename_display_basename</methodname>
-        <methodparam><parameter>filename</parameter></methodparam>
-	</methodsynopsis></programlisting>
-      <variablelist role="params">
-        <varlistentry>
-          <term><emphasis>filename</emphasis>&nbsp;:</term>
-          <listitem><simpara>an absolute pathname in the file name
-          encoding</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><emphasis>Returns</emphasis>&nbsp;:</term>
-          <listitem><simpara>an UTF8 rendition of
-          <parameter>filename</parameter>.</simpara></listitem>
-        </varlistentry>
-      </variablelist>
-      <note>
-        <para>This function is available in PyGTK 2.10 and above.</para>
-      </note>
-
-      <para>The <function>filename_display_basename</function>() function
-      returns the display basename for the particular filename, guaranteed
-      to be valid UTF-8. The display name might not be identical to the
-      filename, for instance there might be problems converting it to UTF-8,
-      and some files can be translated in the display.</para>
-
-      <para>You must pass the whole absolute pathname to this functions so
-      that translation of well known locations can be done.</para>
-
-      <para>This function is preferred over the <link
-      linkend="function-gobject--filename-display-name"><function>gobject.filename_display_name</function>()</link>
-      function if you know the whole path, as it allows translation.</para>
-
-    </refsect2>
-
-    <refsect2 id="function-gobject--filename-from-utf8">
-      <title>gobject.filename_from_utf8</title>
-      
-      <programlisting><methodsynopsis language="python">
-        <methodname>gobject.filename_from_utf8</methodname>
- 	<methodparam><parameter>utf8string</parameter></methodparam>
-	</methodsynopsis></programlisting>
-      <variablelist role="params">
-        <varlistentry>
-          <term><emphasis>utf8string</emphasis>&nbsp;:</term>
-          <listitem><simpara>a UTF-8 encoded string.</simpara></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><emphasis>Returns</emphasis>&nbsp;:</term>
-          <listitem><simpara>a filename encoded in the GLib filename
-          encoding.</simpara></listitem>
-        </varlistentry>
-      </variablelist>
-      <note>
-        <para>This function is available in PyGTK 2.10 and above.</para>
-      </note>
-
-      <para>The <function>filename_from_utf8</function>() function converts
-      a string from UTF-8 to the encoding GLib uses for filenames. Note that
-      on Windows GLib uses UTF-8 for filenames.</para>
-
-    </refsect2>
-
   </refsect1>
 
 </refentry>