Remove references to nonexisting functions
* glib/gmain.c: Remove references to nonexisting functions
g_source_set_callback_closure(), g_source_poll(), g_source_add()
from docs.
* glib/gdir.c (g_dir_open): Typo fix in docs.
* glib/gasyncqueue.c (g_async_queue_lock):
(g_async_queue_unref_and_unlock): Fix markup to avoid erroneous
<link>s in docs.
* glib/gwin32.c: Escape #'s leading to erroneous <link>s in docs.
* glib/gtree.c: Replace some occurances of Gtree by GTree in docs.
* glib/gstring.c (g_string_insert_unichar): Typo fix in docs.
* glib/tmpl/conversions.sgml: Add GIConv.
* glib/tmpl/main.sgml: Fix references to nonexisting functions
g_main_loop_destroy(), g_source_add(), g_source_connect().
* glib/glib-sections.txt: Add GIConv, g_str_has_prefix, g_str_has_suffix.
* glib/tmpl/linked_lists_single.sgml:
* glib/tmpl/linked_lists_double.sgml: GListAllocator doesn't exist.
* glib/glib-docs.sgml: Declare hash entity.
* glib/tmpl/macros.sgml: Escape # in #ifdef to suppress erroneous links.
* gobject/Makefile.am, gobject/gobject-docs.sgml, gobject/tmpl/*:
* glib/Makefile.am, glib/glib-docs.sgml, glib/tmpl/*: Produce XML,
not SGML.
2002-05-27 00:46:28 +02:00
|
|
|
<?xml version="1.0"?>
|
2012-04-22 22:56:07 +02:00
|
|
|
<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN'
|
|
|
|
|
'http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd' [
|
2005-04-22 12:27:37 +02:00
|
|
|
|
2010-01-07 09:22:14 +01:00
|
|
|
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
|
|
|
|
|
<!ENTITY version SYSTEM "version.xml">
|
2000-09-06 06:32:45 +02:00
|
|
|
]>
|
2010-01-07 09:22:14 +01:00
|
|
|
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
|
2000-09-06 06:32:45 +02:00
|
|
|
<bookinfo>
|
|
|
|
|
<title>GObject Reference Manual</title>
|
2009-02-06 09:09:24 +01:00
|
|
|
<releaseinfo>
|
|
|
|
|
for GObject &version;
|
|
|
|
|
The latest version of this documentation can be found on-line at
|
2014-09-18 20:31:52 +02:00
|
|
|
<ulink role="online-location" url="https://developer.gnome.org/gobject/unstable/">https://developer.gnome.org/gobject/unstable/</ulink>.
|
2009-02-06 09:09:24 +01:00
|
|
|
</releaseinfo>
|
2000-09-06 06:32:45 +02:00
|
|
|
</bookinfo>
|
|
|
|
|
|
2000-10-30 11:14:47 +01:00
|
|
|
<preface>
|
|
|
|
|
<title>Introduction</title>
|
|
|
|
|
<para>
|
2005-04-22 12:27:37 +02:00
|
|
|
Most modern programming languages come with their own native object
|
|
|
|
|
systems and additional fundamental algorithmic language constructs.
|
|
|
|
|
Just as GLib serves as an implementation of such fundamental
|
|
|
|
|
types and algorithms (linked lists, hash tables and so forth), the
|
|
|
|
|
GLib Object System provides the required implementations of a
|
2014-06-07 02:04:12 +02:00
|
|
|
flexible, extensible, and intentionally easy to map (into other
|
2007-11-13 08:10:42 +01:00
|
|
|
languages) object-oriented framework for C.
|
2005-04-22 12:27:37 +02:00
|
|
|
The substantial elements that are provided can be summarized as:
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><para>
|
|
|
|
|
A generic type system to register arbitrary single-inherited
|
|
|
|
|
flat and deep derived types as well as interfaces for
|
|
|
|
|
structured types.
|
|
|
|
|
It takes care of creation, initialization and memory management
|
|
|
|
|
of the assorted object and class structures, maintains
|
|
|
|
|
parent/child relationships and deals with dynamic implementations
|
|
|
|
|
of such types. That is, their type specific implementations are
|
|
|
|
|
relocatable/unloadable during runtime.
|
|
|
|
|
</para></listitem>
|
|
|
|
|
<listitem><para>
|
|
|
|
|
A collection of fundamental type implementations, such as integers,
|
|
|
|
|
doubles, enums and structured types, to name a few.
|
|
|
|
|
</para></listitem>
|
|
|
|
|
<listitem><para>
|
|
|
|
|
A sample fundamental type implementation to base object hierarchies
|
|
|
|
|
upon - the GObject fundamental type.
|
|
|
|
|
</para></listitem>
|
|
|
|
|
<listitem><para>
|
|
|
|
|
A signal system that allows very flexible user customization of
|
|
|
|
|
virtual/overridable object methods and can serve as a powerful
|
|
|
|
|
notification mechanism.
|
|
|
|
|
</para></listitem>
|
|
|
|
|
<listitem><para>
|
|
|
|
|
An extensible parameter/value system, supporting all the provided
|
|
|
|
|
fundamental types that can be used to generically handle object
|
|
|
|
|
properties or otherwise parameterized types.
|
|
|
|
|
</para></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</para>
|
2000-10-30 11:14:47 +01:00
|
|
|
</preface>
|
|
|
|
|
|
2005-04-22 12:27:37 +02:00
|
|
|
<part label="I">
|
|
|
|
|
<title>Concepts</title>
|
|
|
|
|
|
2010-01-07 09:47:20 +01:00
|
|
|
<xi:include href="tut_intro.xml" />
|
|
|
|
|
<xi:include href="tut_gtype.xml" />
|
|
|
|
|
<xi:include href="tut_gobject.xml" />
|
|
|
|
|
<xi:include href="tut_gsignal.xml" />
|
2005-04-22 12:27:37 +02:00
|
|
|
</part>
|
|
|
|
|
<reference label="II">
|
2000-09-06 06:32:45 +02:00
|
|
|
<title>API Reference</title>
|
2010-01-07 09:47:20 +01:00
|
|
|
|
|
|
|
|
<xi:include href="xml/gtype.xml" />
|
|
|
|
|
<xi:include href="xml/gtypeplugin.xml" />
|
|
|
|
|
<xi:include href="xml/gtypemodule.xml" />
|
|
|
|
|
<xi:include href="xml/objects.xml" />
|
|
|
|
|
<xi:include href="xml/enumerations_flags.xml" />
|
|
|
|
|
<xi:include href="xml/gboxed.xml" />
|
|
|
|
|
<xi:include href="xml/generic_values.xml" />
|
|
|
|
|
<xi:include href="xml/param_value_types.xml" />
|
|
|
|
|
<xi:include href="xml/gparamspec.xml" />
|
|
|
|
|
<xi:include href="xml/value_collection.xml" />
|
|
|
|
|
<xi:include href="xml/signals.xml" />
|
2021-08-27 22:01:00 +02:00
|
|
|
<xi:include href="xml/gsignalgroup.xml" />
|
2010-01-07 09:47:20 +01:00
|
|
|
<xi:include href="xml/gclosure.xml" />
|
|
|
|
|
<xi:include href="xml/value_arrays.xml" />
|
2010-06-04 17:17:15 +02:00
|
|
|
<xi:include href="xml/gbinding.xml" />
|
2021-08-27 01:32:32 +02:00
|
|
|
<xi:include href="xml/gbindinggroup.xml" />
|
2000-09-06 17:01:07 +02:00
|
|
|
</reference>
|
2005-04-22 12:27:37 +02:00
|
|
|
<reference label="III">
|
2003-06-18 01:08:37 +02:00
|
|
|
<title>Tools Reference</title>
|
|
|
|
|
|
2010-01-07 09:47:20 +01:00
|
|
|
<xi:include href="glib-mkenums.xml" />
|
|
|
|
|
<xi:include href="glib-genmarshal.xml" />
|
|
|
|
|
<xi:include href="gobject-query.xml" />
|
2003-06-18 01:08:37 +02:00
|
|
|
</reference>
|
2005-04-22 12:27:37 +02:00
|
|
|
|
2010-01-07 09:47:20 +01:00
|
|
|
<xi:include href="tut_howto.xml" />
|
|
|
|
|
<xi:include href="tut_tools.xml" />
|
2003-06-18 01:08:37 +02:00
|
|
|
|
2010-01-07 09:22:14 +01:00
|
|
|
<index id="api-index-full">
|
2004-05-05 19:32:12 +02:00
|
|
|
<title>Index</title>
|
2010-01-07 09:22:14 +01:00
|
|
|
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
|
2004-05-05 19:32:12 +02:00
|
|
|
</index>
|
2010-01-07 09:22:14 +01:00
|
|
|
<index id="api-index-deprecated" role="deprecated">
|
2004-05-05 19:32:12 +02:00
|
|
|
<title>Index of deprecated symbols</title>
|
2010-01-07 09:22:14 +01:00
|
|
|
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
|
2004-05-05 19:32:12 +02:00
|
|
|
</index>
|
2010-01-07 09:22:14 +01:00
|
|
|
<index id="api-index-2-2" role="2.2">
|
2004-05-05 19:32:12 +02:00
|
|
|
<title>Index of new symbols in 2.2</title>
|
2010-01-07 09:22:14 +01:00
|
|
|
<xi:include href="xml/api-index-2.2.xml"><xi:fallback /></xi:include>
|
2004-05-05 19:32:12 +02:00
|
|
|
</index>
|
2010-01-07 09:22:14 +01:00
|
|
|
<index id="api-index-2-4" role="2.4">
|
2004-05-05 19:32:12 +02:00
|
|
|
<title>Index of new symbols in 2.4</title>
|
2010-01-07 09:22:14 +01:00
|
|
|
<xi:include href="xml/api-index-2.4.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
|
|
|
|
<index id="api-index-2-6" role="2.6">
|
2004-10-26 18:13:20 +02:00
|
|
|
<title>Index of new symbols in 2.6</title>
|
2010-01-07 09:22:14 +01:00
|
|
|
<xi:include href="xml/api-index-2.6.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
|
|
|
|
<index id="api-index-2-8" role="2.8">
|
2005-07-08 17:04:29 +02:00
|
|
|
<title>Index of new symbols in 2.8</title>
|
2010-01-07 09:22:14 +01:00
|
|
|
<xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
|
|
|
|
<index id="api-index-2-10" role="2.10">
|
2005-08-26 21:28:26 +02:00
|
|
|
<title>Index of new symbols in 2.10</title>
|
2010-01-07 09:22:14 +01:00
|
|
|
<xi:include href="xml/api-index-2.10.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
|
|
|
|
<index id="api-index-2-12" role="2.12">
|
2006-04-21 18:54:15 +02:00
|
|
|
<title>Index of new symbols in 2.12</title>
|
2010-01-07 09:22:14 +01:00
|
|
|
<xi:include href="xml/api-index-2.12.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
|
|
|
|
<index id="api-index-2-14" role="2.14">
|
2006-12-29 07:12:11 +01:00
|
|
|
<title>Index of new symbols in 2.14</title>
|
2010-01-07 09:22:14 +01:00
|
|
|
<xi:include href="xml/api-index-2.14.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
|
|
|
|
<index id="api-index-2-18" role="2.18">
|
2008-10-17 01:59:50 +02:00
|
|
|
<title>Index of new symbols in 2.18</title>
|
2010-01-07 09:22:14 +01:00
|
|
|
<xi:include href="xml/api-index-2.18.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
|
|
|
|
<index id="api-index-2-22" role="2.22">
|
2009-05-04 00:04:31 +02:00
|
|
|
<title>Index of new symbols in 2.22</title>
|
2010-01-07 09:22:14 +01:00
|
|
|
<xi:include href="xml/api-index-2.22.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2010-02-22 01:48:22 +01:00
|
|
|
<index id="api-index-2-24" role="2.24">
|
|
|
|
|
<title>Index of new symbols in 2.24</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2010-06-22 23:42:30 +02:00
|
|
|
<index id="api-index-2-26" role="2.26">
|
|
|
|
|
<title>Index of new symbols in 2.26</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.26.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2010-11-24 22:00:32 +01:00
|
|
|
<index id="api-index-2-28" role="2.28">
|
|
|
|
|
<title>Index of new symbols in 2.28</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.28.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2011-08-30 03:43:50 +02:00
|
|
|
<index id="api-index-2-30" role="2.30">
|
|
|
|
|
<title>Index of new symbols in 2.30</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.30.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2011-10-15 23:31:47 +02:00
|
|
|
<index id="api-index-2-32" role="2.32">
|
|
|
|
|
<title>Index of new symbols in 2.32</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.32.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2012-04-23 02:36:49 +02:00
|
|
|
<index id="api-index-2-34" role="2.34">
|
|
|
|
|
<title>Index of new symbols in 2.34</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.34.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2013-02-03 19:26:36 +01:00
|
|
|
<index id="api-index-2-36" role="2.36">
|
|
|
|
|
<title>Index of new symbols in 2.36</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.36.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2013-05-01 06:16:25 +02:00
|
|
|
<index id="api-index-2-38" role="2.38">
|
|
|
|
|
<title>Index of new symbols in 2.38</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.38.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2014-05-31 17:32:55 +02:00
|
|
|
<index id="api-index-2-40" role="2.40">
|
|
|
|
|
<title>Index of new symbols in 2.40</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.40.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2014-08-17 22:54:22 +02:00
|
|
|
<index id="api-index-2-42" role="2.42">
|
|
|
|
|
<title>Index of new symbols in 2.42</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.42.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2014-12-01 14:16:54 +01:00
|
|
|
<index id="api-index-2-44" role="2.44">
|
|
|
|
|
<title>Index of new symbols in 2.44</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.44.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2015-09-08 14:14:13 +02:00
|
|
|
<index id="api-index-2-46" role="2.46">
|
|
|
|
|
<title>Index of new symbols in 2.46</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.46.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2018-07-30 22:13:48 +02:00
|
|
|
<index id="api-index-2-54" role="2.54">
|
|
|
|
|
<title>Index of new symbols in 2.54</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.54.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
|
|
|
|
<index id="api-index-2-56" role="2.56">
|
|
|
|
|
<title>Index of new symbols in 2.56</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.56.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2019-07-09 22:05:40 +02:00
|
|
|
<index id="api-index-2-62" role="2.62">
|
|
|
|
|
<title>Index of new symbols in 2.62</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.62.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2020-03-04 15:05:18 +01:00
|
|
|
<index id="api-index-2-66" role="2.66">
|
|
|
|
|
<title>Index of new symbols in 2.66</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.66.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2020-10-01 15:33:21 +02:00
|
|
|
<index id="api-index-2-68" role="2.68">
|
|
|
|
|
<title>Index of new symbols in 2.68</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.68.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2021-02-25 11:35:36 +01:00
|
|
|
<index id="api-index-2-70" role="2.70">
|
|
|
|
|
<title>Index of new symbols in 2.70</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.70.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2021-09-17 12:35:21 +02:00
|
|
|
<index id="api-index-2-72" role="2.72">
|
|
|
|
|
<title>Index of new symbols in 2.72</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.72.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2022-03-28 13:55:20 +02:00
|
|
|
<index id="api-index-2-74" role="2.74">
|
|
|
|
|
<title>Index of new symbols in 2.74</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.74.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2022-10-14 17:03:29 +02:00
|
|
|
<index id="api-index-2-76" role="2.76">
|
|
|
|
|
<title>Index of new symbols in 2.76</title>
|
|
|
|
|
<xi:include href="xml/api-index-2.76.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2010-06-22 23:42:30 +02:00
|
|
|
|
2010-07-14 10:56:41 +02:00
|
|
|
<xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
|
|
|
|
|
|
2000-10-30 06:03:19 +01:00
|
|
|
</book>
|
