mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-28 00:16:15 +01:00
54f796b1b6
2003-06-17 Matthias Clasen <maclas@gmx.de> * acinclude.m4 (JH_PATH_XML_CATALOG, JH_CHECK_XML_CATALOG): New macros to check for XML catalog contents and path, borrowed from gtk-doc. * configure.in: New option --enable-man to enable regeneration of man pages from Docbook, if the necessary tools are found. * gobject/Makefile.am: Add rule to regenerate man pages from Docbook. (man_MANS): Add glib-mkenums.1, glib-genmarshal.1 and gobject-query.1. (content_files): Add glib-mkenums.xml, glib-genmarshal.xml and gobject-query.xml. * gobject/glib-mkenums.xml: * gobject/glib-genmarshal.xml: * gobject/gobject-query.xml: New refentries. * gobject/glib-mkenums.1: * gobject/glib-genmarshal.1: * gobject/gobject-query.1: Man pages generated from the .xml sources. * gobject/gobject-docs.sgml: Include glib-mkenums.xml, glib-genmarshal.xml and gobject-query.xml. * glib/Makefile.am: Add rule to regenerate man pages from Docbook. (man_MANS): Add glib-gettextize.1. (content_files): Add glib-gettextize.xml. * glib/glib-gettextize.xml: New refentry. * glib/glib-gettextize.1: Man page generated from the .xml source. * glib/glib-docs.sgml: Include glib-gettextize.xml.
102 lines
4.0 KiB
XML
102 lines
4.0 KiB
XML
<?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" [
|
|
<!ENTITY gobject-GType SYSTEM "xml/gtype.xml">
|
|
<!ENTITY gobject-GTypePlugin SYSTEM "xml/gtypeplugin.xml">
|
|
<!ENTITY gobject-GTypeModule SYSTEM "xml/gtypemodule.xml">
|
|
<!ENTITY gobject-The-Base-Object-Type SYSTEM "xml/objects.xml">
|
|
<!ENTITY gobject-Enumeration-and-Flag-Types SYSTEM "xml/enumerations_flags.xml">
|
|
<!ENTITY gobject-Boxed-Types SYSTEM "xml/gboxed.xml">
|
|
<!ENTITY gobject-Generic-values SYSTEM "xml/generic_values.xml">
|
|
<!ENTITY gobject-param-value-types SYSTEM "xml/param_value_types.xml">
|
|
<!ENTITY gobject-GParamSpec SYSTEM "xml/gparamspec.xml">
|
|
<!ENTITY gobject-Varargs-Value-Collection SYSTEM "xml/value_collection.xml">
|
|
<!ENTITY gobject-Signals SYSTEM "xml/signals.xml">
|
|
<!ENTITY gobject-Closures SYSTEM "xml/gclosure.xml">
|
|
<!ENTITY gobject-Value-Arrays SYSTEM "xml/value_arrays.xml">
|
|
<!ENTITY glib-mkenums SYSTEM "glib-mkenums.xml">
|
|
<!ENTITY glib-genmarshal SYSTEM "glib-genmarshal.xml">
|
|
<!ENTITY gobject-query SYSTEM "gobject-query.xml">
|
|
<!ENTITY version SYSTEM "version.xml">
|
|
]>
|
|
<book id="index">
|
|
<bookinfo>
|
|
<title>GObject Reference Manual</title>
|
|
<releaseinfo>for GLib &version;</releaseinfo>
|
|
</bookinfo>
|
|
|
|
<preface>
|
|
<title>Introduction</title>
|
|
<para>
|
|
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
|
|
languages) object oriented framework for C.
|
|
The substantial elements that are provided can be summarized as:
|
|
<variablelist>
|
|
<varlistentry><term></term><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></varlistentry>
|
|
<varlistentry><term></term><listitem><para>
|
|
* A collection of fundamental type implementations, such as integers,
|
|
doubles, enums and structured types, to name a few.
|
|
</para></listitem></varlistentry>
|
|
<varlistentry><term></term><listitem><para>
|
|
* A sample fundamental type implementation to base object hierarchies
|
|
upon - the GObject fundamental type.
|
|
</para></listitem></varlistentry>
|
|
<varlistentry><term></term><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></varlistentry>
|
|
<varlistentry><term></term><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></varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
</preface>
|
|
|
|
<reference>
|
|
<title>API Reference</title>
|
|
|
|
&gobject-GType;
|
|
&gobject-GTypePlugin;
|
|
&gobject-GTypeModule;
|
|
&gobject-The-Base-Object-Type;
|
|
&gobject-Enumeration-and-Flag-Types;
|
|
&gobject-Boxed-Types;
|
|
&gobject-Generic-values;
|
|
&gobject-param-value-types;
|
|
&gobject-Varargs-Value-Collection;
|
|
&gobject-GParamSpec;
|
|
&gobject-Signals;
|
|
&gobject-Closures;
|
|
&gobject-Value-Arrays;
|
|
|
|
</reference>
|
|
<reference>
|
|
<title>Tools Reference</title>
|
|
|
|
&glib-mkenums;
|
|
&glib-genmarshal;
|
|
&gobject-query;
|
|
</reference>
|
|
|
|
|
|
<index/>
|
|
|
|
</book>
|