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-26 22:46:28 +00:00
|
|
|
<?xml version="1.0"?>
|
|
|
|
|
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
|
|
|
|
|
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
|
2005-04-22 10:27:37 +00:00
|
|
|
|
2010-01-07 10:22:14 +02:00
|
|
|
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
|
|
|
|
|
<!ENTITY version SYSTEM "version.xml">
|
2000-09-06 04:32:45 +00:00
|
|
|
]>
|
2010-01-07 10:22:14 +02:00
|
|
|
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
|
2000-09-06 04:32:45 +00:00
|
|
|
<bookinfo>
|
|
|
|
|
<title>GObject Reference Manual</title>
|
2009-02-06 08:09:24 +00:00
|
|
|
<releaseinfo>
|
|
|
|
|
for GObject &version;
|
|
|
|
|
The latest version of this documentation can be found on-line at
|
|
|
|
|
<ulink role="online-location" url="http://library.gnome.org/devel/gobject/unstable/">http://library.gnome.org/devel/gobject/unstable/</ulink>.
|
|
|
|
|
</releaseinfo>
|
2000-09-06 04:32:45 +00:00
|
|
|
</bookinfo>
|
|
|
|
|
|
2000-10-30 10:14:47 +00:00
|
|
|
<preface>
|
|
|
|
|
<title>Introduction</title>
|
|
|
|
|
<para>
|
2005-04-22 10:27:37 +00: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
|
|
|
|
|
flexible extensible and intentionally easy to map (into other
|
2007-11-13 07:10:42 +00:00
|
|
|
languages) object-oriented framework for C.
|
2005-04-22 10:27:37 +00: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 10:14:47 +00:00
|
|
|
</preface>
|
|
|
|
|
|
2005-04-22 10:27:37 +00:00
|
|
|
<part label="I">
|
|
|
|
|
<title>Concepts</title>
|
|
|
|
|
|
2010-01-07 10:47:20 +02: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 10:27:37 +00:00
|
|
|
</part>
|
|
|
|
|
<reference label="II">
|
2000-09-06 04:32:45 +00:00
|
|
|
<title>API Reference</title>
|
2010-01-07 10:47:20 +02: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" />
|
|
|
|
|
<xi:include href="xml/gclosure.xml" />
|
|
|
|
|
<xi:include href="xml/value_arrays.xml" />
|
2010-06-04 16:17:15 +01:00
|
|
|
<xi:include href="xml/gbinding.xml" />
|
2000-09-06 15:01:07 +00:00
|
|
|
</reference>
|
2005-04-22 10:27:37 +00:00
|
|
|
<reference label="III">
|
2003-06-17 23:08:37 +00:00
|
|
|
<title>Tools Reference</title>
|
|
|
|
|
|
2010-01-07 10:47:20 +02:00
|
|
|
<xi:include href="glib-mkenums.xml" />
|
|
|
|
|
<xi:include href="glib-genmarshal.xml" />
|
|
|
|
|
<xi:include href="gobject-query.xml" />
|
2003-06-17 23:08:37 +00:00
|
|
|
</reference>
|
2005-04-22 10:27:37 +00:00
|
|
|
|
2010-01-07 10:47:20 +02:00
|
|
|
<xi:include href="tut_howto.xml" />
|
|
|
|
|
<xi:include href="tut_tools.xml" />
|
2003-06-17 23:08:37 +00:00
|
|
|
|
2010-01-07 10:22:14 +02:00
|
|
|
<index id="api-index-full">
|
2004-05-05 17:32:12 +00:00
|
|
|
<title>Index</title>
|
2010-01-07 10:22:14 +02:00
|
|
|
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
|
2004-05-05 17:32:12 +00:00
|
|
|
</index>
|
2010-01-07 10:22:14 +02:00
|
|
|
<index id="api-index-deprecated" role="deprecated">
|
2004-05-05 17:32:12 +00:00
|
|
|
<title>Index of deprecated symbols</title>
|
2010-01-07 10:22:14 +02:00
|
|
|
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
|
2004-05-05 17:32:12 +00:00
|
|
|
</index>
|
2010-01-07 10:22:14 +02:00
|
|
|
<index id="api-index-2-2" role="2.2">
|
2004-05-05 17:32:12 +00:00
|
|
|
<title>Index of new symbols in 2.2</title>
|
2010-01-07 10:22:14 +02:00
|
|
|
<xi:include href="xml/api-index-2.2.xml"><xi:fallback /></xi:include>
|
2004-05-05 17:32:12 +00:00
|
|
|
</index>
|
2010-01-07 10:22:14 +02:00
|
|
|
<index id="api-index-2-4" role="2.4">
|
2004-05-05 17:32:12 +00:00
|
|
|
<title>Index of new symbols in 2.4</title>
|
2010-01-07 10:22:14 +02: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 16:13:20 +00:00
|
|
|
<title>Index of new symbols in 2.6</title>
|
2010-01-07 10:22:14 +02: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 15:04:29 +00:00
|
|
|
<title>Index of new symbols in 2.8</title>
|
2010-01-07 10:22:14 +02: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 19:28:26 +00:00
|
|
|
<title>Index of new symbols in 2.10</title>
|
2010-01-07 10:22:14 +02: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 16:54:15 +00:00
|
|
|
<title>Index of new symbols in 2.12</title>
|
2010-01-07 10:22:14 +02: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 06:12:11 +00:00
|
|
|
<title>Index of new symbols in 2.14</title>
|
2010-01-07 10:22:14 +02: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-16 23:59:50 +00:00
|
|
|
<title>Index of new symbols in 2.18</title>
|
2010-01-07 10:22:14 +02: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-03 18:04:31 -04:00
|
|
|
<title>Index of new symbols in 2.22</title>
|
2010-01-07 10:22:14 +02:00
|
|
|
<xi:include href="xml/api-index-2.22.xml"><xi:fallback /></xi:include>
|
|
|
|
|
</index>
|
2010-02-21 19:48:22 -05: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 17:42:30 -04: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 16:00:32 -05: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>
|
2010-06-22 17:42:30 -04:00
|
|
|
|
2010-07-14 11:56:41 +03:00
|
|
|
<xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
|
|
|
|
|
|
2000-10-30 05:03:19 +00:00
|
|
|
</book>
|