RubyGems - pango - Versions diffs - 0.90.2-x86-mingw32 - Mend

pango 0.90.2-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1441) hide show

data/vendor/local/share/gtk-doc/html/gobject/left.png ADDED Viewed

Binary file

data/vendor/local/share/gtk-doc/html/gobject/pr01.html ADDED Viewed

@@ -0,0 +1,72 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Introduction</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<link rel="home" href="index.html" title="GObject Reference Manual">
+<link rel="up" href="index.html" title="GObject Reference Manual">
+<link rel="prev" href="index.html" title="GObject Reference Manual">
+<link rel="next" href="pt01.html" title="Part I. Concepts">
+<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
+<td><a accesskey="p" href="index.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td> </td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GObject Reference Manual</th>
+<td><a accesskey="n" href="pt01.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="preface" title="Introduction">
+<div class="titlepage"><div><div><h2 class="title">
+<a name="id496850"></a>Introduction</h2></div></div></div>
+<p>
+			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:
+			</p>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem"><p>
+					 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.
+				</p></li>
+<li class="listitem"><p>
+						A collection of fundamental type implementations, such as integers,
+						doubles, enums and structured types, to name a few.
+				</p></li>
+<li class="listitem"><p>
+						A sample fundamental type implementation to base object hierarchies
+						upon - the GObject fundamental type.
+				</p></li>
+<li class="listitem"><p>
+						A signal system that allows very flexible user customization of
+						virtual/overridable object methods and can serve as a powerful
+						notification mechanism.
+				</p></li>
+<li class="listitem"><p>
+						An extensible parameter/value system, supporting all the provided
+						fundamental types that can be used to generically handle object
+						properties or otherwise parameterized types.
+				</p></li>
+</ul></div>
+<p>
+		</p>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.14</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/gobject/pt01.html ADDED Viewed

@@ -0,0 +1,80 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Part I. Concepts</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<link rel="home" href="index.html" title="GObject Reference Manual">
+<link rel="up" href="index.html" title="GObject Reference Manual">
+<link rel="prev" href="pr01.html" title="Introduction">
+<link rel="next" href="chapter-intro.html" title="Background">
+<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
+<td><a accesskey="p" href="pr01.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td> </td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GObject Reference Manual</th>
+<td><a accesskey="n" href="chapter-intro.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="part" title="Part I. Concepts">
+<div class="titlepage"><div><div><h1 class="title">
+<a name="id468667"></a>Part I. Concepts</h1></div></div></div>
+<div class="toc">
+<p><b>Table of Contents</b></p>
+<dl>
+<dt><span class="chapter"><a href="chapter-intro.html">Background</a></span></dt>
+<dd><dl>
+<dt><span class="sect1"><a href="chapter-intro.html#id465439">Data types and programming</a></span></dt>
+<dt><span class="sect1"><a href="ch01s02.html">Exporting a C API</a></span></dt>
+</dl></dd>
+<dt><span class="chapter"><a href="chapter-gtype.html">The GLib Dynamic Type System</a></span></dt>
+<dd><dl>
+<dt><span class="sect1"><a href="chapter-gtype.html#gtype-copy">Copy functions</a></span></dt>
+<dt><span class="sect1"><a href="gtype-conventions.html">Conventions</a></span></dt>
+<dt><span class="sect1"><a href="gtype-non-instantiable.html">Non-instantiable non-classed fundamental types</a></span></dt>
+<dt><span class="sect1"><a href="gtype-instantiable-classed.html">Instantiable classed types: objects</a></span></dt>
+<dd><dl><dt><span class="sect2"><a href="gtype-instantiable-classed.html#gtype-instantiable-classed-init-done">Initialization and Destruction</a></span></dt></dl></dd>
+<dt><span class="sect1"><a href="gtype-non-instantiable-classed.html">Non-instantiable classed types: interfaces</a></span></dt>
+<dd><dl>
+<dt><span class="sect2"><a href="gtype-non-instantiable-classed.html#gtype-non-instantiable-classed-init">Interface Initialization</a></span></dt>
+<dt><span class="sect2"><a href="gtype-non-instantiable-classed.html#gtype-non-instantiable-classed-dest">Interface Destruction</a></span></dt>
+</dl></dd>
+</dl></dd>
+<dt><span class="chapter"><a href="chapter-gobject.html">The GObject base class</a></span></dt>
+<dd><dl>
+<dt><span class="sect1"><a href="chapter-gobject.html#gobject-instantiation">Object instantiation</a></span></dt>
+<dt><span class="sect1"><a href="gobject-memory.html">Object memory management</a></span></dt>
+<dd><dl>
+<dt><span class="sect2"><a href="gobject-memory.html#gobject-memory-refcount">Reference count</a></span></dt>
+<dt><span class="sect2"><a href="gobject-memory.html#gobject-memory-weakref">Weak References</a></span></dt>
+<dt><span class="sect2"><a href="gobject-memory.html#gobject-memory-cycles">Reference counts and cycles</a></span></dt>
+</dl></dd>
+<dt><span class="sect1"><a href="gobject-properties.html">Object properties</a></span></dt>
+<dd><dl><dt><span class="sect2"><a href="gobject-properties.html#gobject-multi-properties">Accessing multiple properties at once</a></span></dt></dl></dd>
+</dl></dd>
+<dt><span class="chapter"><a href="chapter-signal.html">The GObject messaging system</a></span></dt>
+<dd><dl>
+<dt><span class="sect1"><a href="chapter-signal.html#closure">Closures</a></span></dt>
+<dd><dl>
+<dt><span class="sect2"><a href="chapter-signal.html#id531463">C Closures</a></span></dt>
+<dt><span class="sect2"><a href="chapter-signal.html#id515238">Non-C closures (for the fearless)</a></span></dt>
+</dl></dd>
+<dt><span class="sect1"><a href="signal.html">Signals</a></span></dt>
+<dd><dl>
+<dt><span class="sect2"><a href="signal.html#signal-registration">Signal registration</a></span></dt>
+<dt><span class="sect2"><a href="signal.html#signal-connection">Signal connection</a></span></dt>
+<dt><span class="sect2"><a href="signal.html#signal-emission">Signal emission</a></span></dt>
+<dt><span class="sect2"><a href="signal.html#signal-detail">The <span class="emphasis"><em>detail</em></span> argument</a></span></dt>
+</dl></dd>
+</dl></dd>
+</dl>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.14</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/gobject/pt02.html ADDED Viewed

@@ -0,0 +1,66 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Part IV. Tutorial</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<link rel="home" href="index.html" title="GObject Reference Manual">
+<link rel="up" href="index.html" title="GObject Reference Manual">
+<link rel="prev" href="gobject-query.html" title="gobject-query">
+<link rel="next" href="howto-gobject.html" title="How to define and implement a new GObject">
+<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
+<td><a accesskey="p" href="gobject-query.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td> </td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GObject Reference Manual</th>
+<td><a accesskey="n" href="howto-gobject.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="part" title="Part IV. Tutorial">
+<div class="titlepage"><div><div><h1 class="title">
+<a name="id541704"></a>Part IV. Tutorial</h1></div></div></div>
+<div class="partintro" title="Tutorial">
+<div></div>
+<p>
+      This chapter tries to answer the real-life questions of users and presents
+      the most common scenario use cases I could come up with.
+      The use cases are presented from most likely to less likely.
+    </p>
+<div class="toc">
+<p><b>Table of Contents</b></p>
+<dl>
+<dt><span class="chapter"><a href="howto-gobject.html">How to define and implement a new GObject</a></span></dt>
+<dd><dl>
+<dt><span class="sect1"><a href="howto-gobject.html#howto-gobject-header">Boilerplate header code</a></span></dt>
+<dt><span class="sect1"><a href="howto-gobject-code.html">Boilerplate code</a></span></dt>
+<dt><span class="sect1"><a href="howto-gobject-construction.html">Object Construction</a></span></dt>
+<dt><span class="sect1"><a href="howto-gobject-destruction.html">Object Destruction</a></span></dt>
+<dt><span class="sect1"><a href="howto-gobject-methods.html">Object methods</a></span></dt>
+<dd><dl>
+<dt><span class="sect2"><a href="howto-gobject-methods.html#id597147">Non-virtual public methods</a></span></dt>
+<dt><span class="sect2"><a href="howto-gobject-methods.html#id597172">Virtual public methods</a></span></dt>
+<dt><span class="sect2"><a href="howto-gobject-methods.html#id597256">Virtual private Methods</a></span></dt>
+</dl></dd>
+<dt><span class="sect1"><a href="howto-gobject-chainup.html">Chaining up</a></span></dt>
+</dl></dd>
+<dt><span class="chapter"><a href="howto-interface.html">How to define and implement interfaces</a></span></dt>
+<dd><dl>
+<dt><span class="sect1"><a href="howto-interface.html#howto-interface-define">How to define interfaces</a></span></dt>
+<dt><span class="sect1"><a href="howto-interface-implement.html">How To define implement an Interface?</a></span></dt>
+<dt><span class="sect1"><a href="ch06s03.html">Interface definition prerequisites</a></span></dt>
+<dt><span class="sect1"><a href="howto-interface-properties.html">Interface Properties</a></span></dt>
+</dl></dd>
+<dt><span class="chapter"><a href="howto-signals.html">How to create and use signals</a></span></dt>
+<dd><dl><dt><span class="sect1"><a href="howto-signals.html#howto-simple-signals">Simple use of signals</a></span></dt></dl></dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.14</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/gobject/pt03.html ADDED Viewed

@@ -0,0 +1,55 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Part V. Related Tools</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<link rel="home" href="index.html" title="GObject Reference Manual">
+<link rel="up" href="index.html" title="GObject Reference Manual">
+<link rel="prev" href="howto-signals.html" title="How to create and use signals">
+<link rel="next" href="tools-vala.html" title="Vala">
+<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
+<td><a accesskey="p" href="howto-signals.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td> </td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GObject Reference Manual</th>
+<td><a accesskey="n" href="tools-vala.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="part" title="Part V. Related Tools">
+<div class="titlepage"><div><div><h1 class="title">
+<a name="id524935"></a>Part V. Related Tools</h1></div></div></div>
+<div class="partintro" title="Related Tools">
+<div></div>
+<p>
+      Several useful developer tools have been build around GObject
+      technology.  The next sections briefly introduce them and link to
+      the respective project pages.
+    </p>
+<p>
+      For example, writing GObjects is often seen as a tedious task. It
+      requires a lot of typing and just doing a copy/paste requires a
+      great deal of care. A lot of projects and scripts have been
+      written to generate GObject skeleton form boilerplate code, or
+      even translating higher-level language into plain C.
+    </p>
+<div class="toc">
+<p><b>Table of Contents</b></p>
+<dl>
+<dt><span class="chapter"><a href="tools-vala.html">Vala</a></span></dt>
+<dt><span class="chapter"><a href="tools-gob.html">GObject builder</a></span></dt>
+<dt><span class="chapter"><a href="tools-ginspector.html">Graphical inspection of GObjects</a></span></dt>
+<dt><span class="chapter"><a href="tools-refdb.html">Debugging reference count problems</a></span></dt>
+<dt><span class="chapter"><a href="tools-gtkdoc.html">Writing API docs</a></span></dt>
+</dl>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.14</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/gobject/right.png ADDED Viewed

Binary file

data/vendor/local/share/gtk-doc/html/gobject/rn01.html ADDED Viewed

@@ -0,0 +1,82 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>API Reference</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<link rel="home" href="index.html" title="GObject Reference Manual">
+<link rel="up" href="index.html" title="GObject Reference Manual">
+<link rel="prev" href="signal.html" title="Signals">
+<link rel="next" href="gobject-Type-Information.html" title="Type Information">
+<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
+<td><a accesskey="p" href="signal.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td> </td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GObject Reference Manual</th>
+<td><a accesskey="n" href="gobject-Type-Information.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="reference" title="API Reference">
+<div class="titlepage">
+<div><div><h1 class="title">
+<a name="id468691"></a>API Reference</h1></div></div>
+<hr>
+</div>
+<div class="toc">
+<p><b>Table of Contents</b></p>
+<dl>
+<dt>
+<span class="refentrytitle"><a href="gobject-Type-Information.html">Type Information</a></span><span class="refpurpose"> — The GLib Runtime type identification and
+    management system</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="GTypePlugin.html">GTypePlugin</a></span><span class="refpurpose"> — An interface for dynamically loadable types</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="GTypeModule.html">GTypeModule</a></span><span class="refpurpose"> — Type loading modules</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="gobject-The-Base-Object-Type.html">The Base Object Type</a></span><span class="refpurpose"> — The base object type</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="gobject-Enumeration-and-Flag-Types.html">Enumeration and Flag Types</a></span><span class="refpurpose"> — Enumeration and flags types</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="gobject-Boxed-Types.html">Boxed Types</a></span><span class="refpurpose"> — A mechanism to wrap opaque C structures registered
+    by the type system</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="gobject-Generic-values.html">Generic values</a></span><span class="refpurpose"> — A polymorphic type that can hold values of any
+    other type</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="gobject-Standard-Parameter-and-Value-Types.html">Parameters and Values</a></span><span class="refpurpose"> — Standard Parameter and Value Types</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="gobject-GParamSpec.html">GParamSpec</a></span><span class="refpurpose"> — Metadata for parameter specifications</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="gobject-Varargs-Value-Collection.html">Varargs Value Collection</a></span><span class="refpurpose"> — Converting varargs to generic values</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="gobject-Signals.html">Signals</a></span><span class="refpurpose"> — A means for customization of object behaviour
+    and a general purpose notification mechanism</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="gobject-Closures.html">Closures</a></span><span class="refpurpose"> — Functions as first-class objects</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="gobject-Value-arrays.html">Value arrays</a></span><span class="refpurpose"> — A container structure to maintain an array of
+    generic values</span>
+</dt>
+</dl>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.14</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/gobject/rn02.html ADDED Viewed

@@ -0,0 +1,47 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Tools Reference</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<link rel="home" href="index.html" title="GObject Reference Manual">
+<link rel="up" href="index.html" title="GObject Reference Manual">
+<link rel="prev" href="gobject-Value-arrays.html" title="Value arrays">
+<link rel="next" href="glib-mkenums.html" title="glib-mkenums">
+<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
+<td><a accesskey="p" href="gobject-Value-arrays.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td> </td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GObject Reference Manual</th>
+<td><a accesskey="n" href="glib-mkenums.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="reference" title="Tools Reference">
+<div class="titlepage">
+<div><div><h1 class="title">
+<a name="id465781"></a>Tools Reference</h1></div></div>
+<hr>
+</div>
+<div class="toc">
+<p><b>Table of Contents</b></p>
+<dl>
+<dt>
+<span class="refentrytitle"><a href="glib-mkenums.html">glib-mkenums</a></span><span class="refpurpose"> — C language enum description generation utility</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="glib-genmarshal.html">glib-genmarshal</a></span><span class="refpurpose"> — C code marshaller generation utility for GLib closures</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="gobject-query.html">gobject-query</a></span><span class="refpurpose"> — display a tree of types</span>
+</dt>
+</dl>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.14</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/gobject/signal.html ADDED Viewed

@@ -0,0 +1,377 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Signals</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<link rel="home" href="index.html" title="GObject Reference Manual">
+<link rel="up" href="chapter-signal.html" title="The GObject messaging system">
+<link rel="prev" href="chapter-signal.html" title="The GObject messaging system">
+<link rel="next" href="rn01.html" title="API Reference">
+<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
+<td><a accesskey="p" href="chapter-signal.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="chapter-signal.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GObject Reference Manual</th>
+<td><a accesskey="n" href="rn01.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="sect1" title="Signals">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="signal"></a>Signals</h2></div></div></div>
+<p>
+      GObject's signals have nothing to do with standard UNIX signals: they connect
+      arbitrary application-specific events with any number of listeners.
+      For example, in GTK+, every user event (keystroke or mouse move) is received
+      from the X server and generates a GTK+ event under the form of a signal emission
+      on a given object instance.
+    </p>
+<p>
+      Each signal is registered in the type system together with the type on which
+      it can be emitted: users of the type are said to <span class="emphasis"><em>connect</em></span>
+      to the signal on a given type instance when they register a closure to be
+      invoked upon the signal emission. Users can also emit the signal by themselves
+      or stop the emission of the signal from within one of the closures connected
+      to the signal.
+    </p>
+<p>
+      When a signal is emitted on a given type instance, all the closures
+      connected to this signal on this type instance will be invoked. All the closures
+      connected to such a signal represent callbacks whose signature looks like:
+</p>
+<pre class="programlisting">
+return_type function_callback (gpointer instance, ... , gpointer user_data);
+</pre>
+<p>
+    </p>
+<div class="sect2" title="Signal registration">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="signal-registration"></a>Signal registration</h3></div></div></div>
+<p>
+		To register a new signal on an existing type, we can use any of <code class="function"><a class="link" href="gobject-Signals.html#g-signal-newv" title="g_signal_newv ()">g_signal_newv</a></code>,
+		<code class="function"><a class="link" href="gobject-Signals.html#g-signal-new-valist" title="g_signal_new_valist ()">g_signal_new_valist</a></code> or <code class="function"><a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()">g_signal_new</a></code> functions:
+</p>
+<pre class="programlisting">
+guint g_signal_newv (const gchar        *signal_name,
+                     GType               itype,
+                     GSignalFlags        signal_flags,
+                     GClosure           *class_closure,
+                     GSignalAccumulator  accumulator,
+                     gpointer            accu_data,
+                     GSignalCMarshaller  c_marshaller,
+                     GType               return_type,
+                     guint               n_params,
+                     GType              *param_types);
+</pre>
+<p>
+		The number of parameters to these functions is a bit intimidating but they are relatively
+		simple:
+		</p>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem"><p>
+			  signal_name: is a string which can be used to uniquely identify a given signal.
+			</p></li>
+<li class="listitem"><p>
+			  itype: is the instance type on which this signal can be emitted.
+			</p></li>
+<li class="listitem"><p>
+			  signal_flags: partly defines the order in which closures which were connected to the
+			  signal are invoked.
+			</p></li>
+<li class="listitem"><p>
+			  class_closure: this is the default closure for the signal: if it is not NULL upon
+			  the signal emission, it will be invoked upon this emission of the signal. The
+			  moment where this closure is invoked compared to other closures connected to that
+			  signal depends partly on the signal_flags.
+			</p></li>
+<li class="listitem"><p>
+			  accumulator: this is a function pointer which is invoked after each closure
+			  has been invoked. If it returns FALSE, signal emission is stopped. If it returns
+			  TRUE, signal emission proceeds normally. It is also used to compute the return
+			  value of the signal based on the return value of all the invoked closures.
+			</p></li>
+<li class="listitem"><p>
+			  accumulator_data: this pointer will be passed down to each invocation of the
+			  accumulator during emission.
+			</p></li>
+<li class="listitem"><p>
+			  c_marshaller: this is the default C marshaller for any closure which is connected to
+			this signal.
+			</p></li>
+<li class="listitem"><p>
+			  return_type: this is the type of the return value of the signal.
+			</p></li>
+<li class="listitem"><p>
+			  n_params: this is the number of parameters this signal takes.
+			</p></li>
+<li class="listitem"><p>
+			  param_types: this is an array of GTypes which indicate the type of each parameter
+			  of the signal. The length of this array is indicated by n_params.
+			</p></li>
+</ul></div>
+<p>
+      </p>
+<p>
+		As you can see from the above definition, a signal is basically a description
+		of the closures which can be connected to this signal and a description of the
+		order in which the closures connected to this signal will be invoked.
+	  </p>
+</div>
+<div class="sect2" title="Signal connection">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="signal-connection"></a>Signal connection</h3></div></div></div>
+<p>
+		If you want to connect to a signal with a closure, you have three possibilities:
+		</p>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem"><p>
+		  You can register a class closure at signal registration: this is a
+		  system-wide operation. i.e.: the class_closure will be invoked during each emission
+		  of a given signal on all the instances of the type which supports that signal.
+			</p></li>
+<li class="listitem"><p>
+		  You can use <code class="function"><a class="link" href="gobject-Signals.html#g-signal-override-class-closure" title="g_signal_override_class_closure ()">g_signal_override_class_closure</a></code> which
+		  overrides the class_closure of a given type. It is possible to call this function
+		  only on a derived type of the type on which the signal was registered.
+		  This function is of use only to language bindings.
+			</p></li>
+<li class="listitem"><p>
+		  You can register a closure with the <code class="function"><a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()">g_signal_connect</a></code>
+		  family of functions. This is an instance-specific operation: the closure
+		  will be invoked only during emission of a given signal on a given instance.
+			</p></li>
+</ul></div>
+<p>
+		It is also possible to connect a different kind of callback on a given signal:
+		emission hooks are invoked whenever a given signal is emitted whatever the instance on
+		which it is emitted. Emission hooks are used for example to get all mouse_clicked
+		emissions in an application to be able to emit the small mouse click sound.
+		Emission hooks are connected with <code class="function"><a class="link" href="gobject-Signals.html#g-signal-add-emission-hook" title="g_signal_add_emission_hook ()">g_signal_add_emission_hook</a></code>
+		and removed with <code class="function"><a class="link" href="gobject-Signals.html#g-signal-remove-emission-hook" title="g_signal_remove_emission_hook ()">g_signal_remove_emission_hook</a></code>.
+	  </p>
+</div>
+<div class="sect2" title="Signal emission">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="signal-emission"></a>Signal emission</h3></div></div></div>
+<p>
+		Signal emission is done through the use of the <code class="function"><a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()">g_signal_emit</a></code> family
+		of functions.
+</p>
+<pre class="programlisting">
+void g_signal_emitv (const GValue *instance_and_params,
+                     guint         signal_id,
+                     GQuark        detail,
+                     GValue       *return_value);
+</pre>
+<p>
+		</p>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem"><p>
+			The instance_and_params array of GValues contains the list of input
+			parameters to the signal. The first element of the array is the
+			instance pointer on which to invoke the signal. The following elements of
+			the array contain the list of parameters to the signal.
+			</p></li>
+<li class="listitem"><p>
+			signal_id identifies the signal to invoke.
+			</p></li>
+<li class="listitem"><p>
+			detail identifies the specific detail of the signal to invoke. A detail is a kind of
+			magic token/argument which is passed around during signal emission and which is used
+			by closures connected to the signal to filter out unwanted signal emissions. In most
+			cases, you can safely set this value to zero. See <a class="xref" href="signal.html#signal-detail" title="The detail argument">the section called “The <span class="emphasis"><em>detail</em></span> argument”</a> for
+			more details about this parameter.
+			</p></li>
+<li class="listitem"><p>
+			return_value holds the return value of the last closure invoked during emission if
+			no accumulator was specified. If an accumulator was specified during signal creation,
+			this accumulator is used to calculate the return_value as a function of the return
+			values of all the closures invoked during emission.
+			<sup>[<a name="id545696" href="#ftn.id545696" class="footnote">8</a>]</sup>
+			If no closure is invoked during
+			emission, the return_value is nonetheless initialized to zero/null.
+			</p></li>
+</ul></div>
+<p>
+		</p>
+<p>
+		Internally, the GValue array is passed to the emission function proper,
+		<code class="function">signal_emit_unlocked_R</code> (implemented in <code class="filename">gsignal.c</code>).
+		Signal emission can be decomposed in 5 steps:
+		</p>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem"><p>
+			<span class="emphasis"><em>RUN_FIRST</em></span>: if the G_SIGNAL_RUN_FIRST flag was used
+			during signal registration and if there exist a class_closure for this signal,
+			the class_closure is invoked. Jump to <span class="emphasis"><em>EMISSION_HOOK</em></span> state.
+			</p></li>
+<li class="listitem"><p>
+			<span class="emphasis"><em>EMISSION_HOOK</em></span>: if any emission hook was added to
+			the signal, they are invoked from first to last added. Accumulate return values
+			and jump to <span class="emphasis"><em>HANDLER_RUN_FIRST</em></span> state.
+			</p></li>
+<li class="listitem"><p>
+			<span class="emphasis"><em>HANDLER_RUN_FIRST</em></span>: if any closure were connected
+			with the <code class="function"><a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()">g_signal_connect</a></code> family of
+			functions, and if they are not blocked (with the <code class="function"><a class="link" href="gobject-Signals.html#g-signal-handler-block" title="g_signal_handler_block ()">g_signal_handler_block</a></code>
+			family of functions) they are run here, from first to last connected.
+			Jump to <span class="emphasis"><em>RUN_LAST</em></span> state.
+			</p></li>
+<li class="listitem"><p>
+			<span class="emphasis"><em>RUN_LAST</em></span>: if the G_SIGNAL_RUN_LAST
+			flag was set during registration and if a class_closure
+			was set, it is invoked here. Jump to
+			<span class="emphasis"><em>HANDLER_RUN_LAST</em></span> state.
+			</p></li>
+<li class="listitem"><p>
+			<span class="emphasis"><em>HANDLER_RUN_LAST</em></span>: if any closure were connected
+			with the <code class="function">g_signal_connect_after</code> family of
+			functions, if they were not invoked during HANDLER_RUN_FIRST and if they
+			are not blocked, they are run here, from first to last connected.
+			Jump to  <span class="emphasis"><em>RUN_CLEANUP</em></span> state.
+			</p></li>
+<li class="listitem"><p>
+			<span class="emphasis"><em>RUN_CLEANUP</em></span>: if the G_SIGNAL_RUN_CLEANUP flag
+			was set during registration and if a class_closure was set,
+			it is invoked here. Signal emission is completed here.
+			</p></li>
+</ul></div>
+<p>
+	  </p>
+<p>
+		If, at any point during emission (except in RUN_CLEANUP state), one of the
+		closures or emission hook stops the signal emission with
+		<code class="function">g_signal_stop</code>, emission jumps to CLEANUP state.
+	  </p>
+<p>
+		If, at any point during emission, one of the closures or emission hook
+		emits the same signal on the same instance, emission is restarted from
+		the RUN_FIRST state.
+	  </p>
+<p>
+		The accumulator function is invoked in all states, after invocation
+		of each closure (except in EMISSION_HOOK and CLEANUP). It accumulates
+		the closure return value into the signal return value and returns TRUE or
+		FALSE. If, at any point, it does not return TRUE, emission jumps to CLEANUP state.
+	  </p>
+<p>
+		If no accumulator function was provided, the value returned by the last handler
+		run will be returned by <code class="function"><a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()">g_signal_emit</a></code>.
+	  </p>
+</div>
+<div class="sect2" title="The detail argument">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="signal-detail"></a>The <span class="emphasis"><em>detail</em></span> argument</h3></div></div></div>
+<p>All the functions related to signal emission or signal connection have a parameter
+		named the <span class="emphasis"><em>detail</em></span>. Sometimes, this parameter is hidden by the API
+		but it is always there, under one form or another.
+	  </p>
+<p>
+	    Of the three main connection functions,
+		only one has an explicit detail parameter as a <span class="type"><a href="./../glib/glib/glib-Quarks.html#GQuark">GQuark</a></span>
+		<sup>[<a name="id545882" href="#ftn.id545882" class="footnote">9</a>]</sup>:
+</p>
+<pre class="programlisting">
+gulong     g_signal_connect_closure_by_id          (gpointer          instance,
+                           guint          signal_id,
+                           GQuark          detail,
+                           GClosure         *closure,
+                           gboolean          after);
+</pre>
+<p>
+        The two other functions hide the detail parameter in the signal name identification:
+</p>
+<pre class="programlisting">
+gulong     g_signal_connect_closure          (gpointer          instance,
+                           const gchar       *detailed_signal,
+                           GClosure         *closure,
+                           gboolean          after);
+gulong     g_signal_connect_data              (gpointer          instance,
+                           const gchar     *detailed_signal,
+                           GCallback      c_handler,
+                           gpointer          data,
+                           GClosureNotify      destroy_data,
+                           GConnectFlags      connect_flags);
+</pre>
+<p>
+		Their detailed_signal parameter is a string which identifies the name of the signal
+		to connect to. However, the format of this string is structured to look like
+		<span class="emphasis"><em>signal_name::detail_name</em></span>. Connecting to the signal
+		named <span class="emphasis"><em>notify::cursor_position</em></span> will actually connect to the signal
+		named <span class="emphasis"><em>notify</em></span> with the <span class="emphasis"><em>cursor_position</em></span> name.
+		Internally, the detail string is transformed to a GQuark if it is present.
+	  </p>
+<p>
+		Of the four main signal emission functions, three have an explicit detail parameter as a
+		<span class="type"><a href="./../glib/glib/glib-Quarks.html#GQuark">GQuark</a></span> again:
+</p>
+<pre class="programlisting">
+void                  g_signal_emitv        (const GValue       *instance_and_params,
+                         guint               signal_id,
+                         GQuark              detail,
+                         GValue             *return_value);
+void                  g_signal_emit_valist  (gpointer            instance,
+                         guint               signal_id,
+                         GQuark              detail,
+                         va_list             var_args);
+void                  g_signal_emit         (gpointer            instance,
+                         guint               signal_id,
+                         GQuark              detail,
+                         ...);
+</pre>
+<p>
+        The fourth function hides it in its signal name parameter:
+</p>
+<pre class="programlisting">
+void                  g_signal_emit_by_name (gpointer            instance,
+                         const gchar        *detailed_signal,
+                         ...);
+</pre>
+<p>
+        The format of the detailed_signal parameter is exactly the same as the format used by
+        the <code class="function"><a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()">g_signal_connect</a></code> functions: <span class="emphasis"><em>signal_name::detail_name</em></span>.
+	  </p>
+<p>
+        If a detail is provided by the user to the emission function, it is used during emission to match
+        against the closures which also provide a detail.
+        If the closures' detail does not match the detail provided by the user, they will not be invoked
+        (even though they are connected to a signal which is being emitted).
+	  </p>
+<p>
+		This completely optional filtering mechanism is mainly used as an optimization for signals
+		which are often emitted for many different reasons: the clients can filter out which events they are
+		interested in before the closure's marshalling code runs. For example, this is used extensively
+		by the <span class="emphasis"><em>notify</em></span> signal of GObject: whenever a property is modified on a GObject,
+		instead of just emitting the <span class="emphasis"><em>notify</em></span> signal, GObject associates as a detail to this
+		signal emission the name of the property modified. This allows clients who wish to be notified of changes
+		to only one property to filter most events before receiving them.
+	  </p>
+<p>
+		As a simple rule, users can and should set the detail parameter to zero: this will disable completely
+        this optional filtering.
+	  </p>
+</div>
+<div class="footnotes">
+<br><hr width="100" align="left">
+<div class="footnote"><p><sup>[<a name="ftn.id545696" href="#id545696" class="para">8</a>] </sup>
+			  James (again!!) gives a few non-trivial examples of accumulators:
+			  <span class="quote">“<span class="quote">
+				For instance, you may have an accumulator that ignores NULL returns from
+				closures, and only accumulates the non-NULL ones. Another accumulator may try
+				to return the list of values returned by the closures.
+			  </span>”</span>
+			</p></div>
+<div class="footnote"><p><sup>[<a name="ftn.id545882" href="#id545882" class="para">9</a>] </sup>A GQuark is an integer which uniquely represents a string. It is possible to transform
+		   back and forth between the integer and string representations with the functions
+		   <code class="function"><a href="./../glib/glib/glib-Quarks.html#g-quark-from-string">g_quark_from_string</a></code> and <code class="function"><a href="./../glib/glib/glib-Quarks.html#g-quark-to-string">g_quark_to_string</a></code>.
+		  </p></div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.14</div>
+</body>
+</html>