RubyGems - gio2 - Versions diffs - 0.90.5-x86-mingw32 → 0.90.6-x86-mingw32 - Mend

gio2 0.90.5-x86-mingw32 → 0.90.6-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 (830) hide show

data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html DELETED

@@ -1,125 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>How To define implement an Interface?</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="howto-interface.html" title="How to define and implement interfaces">
-<link rel="prev" href="howto-interface.html" title="How to define and implement interfaces">
-<link rel="next" href="ch06s03.html" title="Interface definition prerequisites">
-<meta name="generator" content="GTK-Doc V1.15.1 (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-interface.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="howto-interface.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="ch06s03.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr></table>
-<div class="sect1">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="howto-interface-implement"></a>How To define implement an Interface?</h2></div></div></div>
-<p>
-      Once the interface is defined, implementing it is rather trivial.
-    </p>
-<p>
-      The first step is to define a normal GObject class, like:
-</p>
-<pre class="programlisting">
-#ifndef __MAMAN_BAZ_H__
-#define __MAMAN_BAZ_H__
-#include &lt;glib-object.h&gt;
-#define MAMAN_TYPE_BAZ             (maman_baz_get_type ())
-#define MAMAN_BAZ(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), MAMAN_TYPE_BAZ, Mamanbaz))
-#define MAMAN_IS_BAZ(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), MAMAN_TYPE_BAZ))
-#define MAMAN_BAZ_CLASS(klass)     (G_TYPE_CHECK_CLASS_CAST ((klass), MAMAN_TYPE_BAZ, MamanbazClass))
-#define MAMAN_IS_BAZ_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((klass), MAMAN_TYPE_BAZ))
-#define MAMAN_BAZ_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), MAMAN_TYPE_BAZ, MamanbazClass))
-typedef struct _MamanBaz        MamanBaz;
-typedef struct _MamanBazClass   MamanBazClass;
-struct _MamanBaz
-{
-  GObject parent_instance;
-  int instance_member;
-};
-struct _MamanBazClass
-{
-  GObjectClass parent_class;
-};
-GType maman_baz_get_type (void);
-#endif /* __MAMAN_BAZ_H__ */
-</pre>
-<p>
-      There is clearly nothing specifically weird or scary about this header:
-      it does not define any weird API or derives from a weird type.
-    </p>
-<p>
-      The second step is to implement <span class="type">MamanBaz</span> by defining
-      its GType. Instead of using <code class="function">G_DEFINE_TYPE</code> we
-      use <code class="function">G_DEFINE_TYPE_WITH_CODE</code> and the
-      <code class="function">G_IMPLEMENT_INTERFACE</code> macros.
-</p>
-<pre class="programlisting">
-static void maman_ibaz_interface_init (MamanIbazInterface *iface);
-G_DEFINE_TYPE_WITH_CODE (MamanBar, maman_bar, G_TYPE_OBJECT,
-                         G_IMPLEMENT_INTERFACE (MAMAN_TYPE_IBAZ,
-                                                maman_ibaz_interface_init));
-</pre>
-<p>
-      This definition is very much like all the similar functions we looked
-      at previously. The only interface-specific code present here is the call
-      to <code class="function">G_IMPLEMENT_INTERFACE</code>.
-    </p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Note</h3>
-<p>Classes can implement multiple interfaces by using multiple
-    calls to <code class="function">G_IMPLEMENT_INTERFACE</code> inside the call
-    to <code class="function">G_DEFINE_TYPE_WITH_CODE</code>.</p>
-</div>
-<p>
-      <code class="function">maman_baz_interface_init</code>, the interface
-      initialization function: inside it every virtual method of the interface
-      must be assigned to its implementation:
-</p>
-<pre class="programlisting">
-static void
-maman_baz_do_action (MamanBaz *self)
-{
-  g_print ("Baz implementation of IBaz interface Action: 0x%x.\n",
-           self-&gt;instance_member);
-}
-static void
-maman_ibaz_interface_init (MamanIbazInterface *iface)
-{
-  iface-&gt;do_action = baz_do_action;
-}
-static void
-maman_baz_init (MamanBaz *self)
-{
-  MamanBaz *self = MAMAN_BAZ (instance);
-  self-&gt;instance_member = 0xdeadbeaf;
-}
-</pre>
-<p>
-    </p>
-</div>
-<div class="footer">
-<hr>
-          Generated by GTK-Doc V1.15.1</div>
-</body>
-</html>

data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html DELETED

@@ -1,167 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Interface Properties</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="howto-interface.html" title="How to define and implement interfaces">
-<link rel="prev" href="ch06s03.html" title="Interface definition prerequisites">
-<link rel="next" href="howto-signals.html" title="How to create and use signals">
-<meta name="generator" content="GTK-Doc V1.15.1 (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="ch06s03.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="howto-interface.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="howto-signals.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr></table>
-<div class="sect1">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="howto-interface-properties"></a>Interface Properties</h2></div></div></div>
-<p>
-      Starting from version 2.4 of GLib, GObject interfaces can also have
-      properties. Declaration of the interface properties is similar to
-      declaring the properties of ordinary GObject types as explained in
-      <a class="xref" href="gobject-properties.html" title="Object properties">the section called “Object properties”</a>,
-      except that <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-interface-install-property" title="g_object_interface_install_property ()">g_object_interface_install_property</a></code> is used to
-      declare the properties instead of <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-class-install-property" title="g_object_class_install_property ()">g_object_class_install_property</a></code>.
-    </p>
-<p>
-      To include a property named 'name' of type <span class="type">string</span> in the
-      <span class="type">maman_ibaz</span> interface example code above, we only need to
-      add one
-      <sup>[<a name="id471707" href="#ftn.id471707" class="footnote">12</a>]</sup>
-      line in the <code class="function">maman_ibaz_base_init</code>
-      <sup>[<a name="id471720" href="#ftn.id471720" class="footnote">13</a>]</sup>
-      as shown below:
-</p>
-<pre class="programlisting">
-static void
-maman_ibaz_base_init (gpointer g_iface)
-{
-  static gboolean is_initialized = FALSE;
-  if (!is_initialized)
-    {
-      g_object_interface_install_property (g_iface,
-                                           g_param_spec_string ("name",
-                                                                "Name",
-                                                                "Name of the MamanIbaz",
-                                                                "maman",
-                                                                G_PARAM_READWRITE));
-      is_initialized = TRUE;
-    }
-}
-</pre>
-<p>
-    </p>
-<p>
-      One point worth noting is that the declared property wasn't assigned an
-      integer ID. The reason being that integer IDs of properties are used
-      only inside the get and set methods and since interfaces do not
-      implement properties, there is no need to assign integer IDs to
-      interface properties.
-    </p>
-<p>
-      An implementation shall declare and define it's properties in the usual
-      way as explained in <a class="xref" href="gobject-properties.html" title="Object properties">the section called “Object properties”</a>, except for one
-      small change: it must declare the properties of the interface it
-      implements using <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-class-override-property" title="g_object_class_override_property ()">g_object_class_override_property</a></code>
-      instead of <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-class-install-property" title="g_object_class_install_property ()">g_object_class_install_property</a></code>.
-      The following code snippet shows the modifications needed in the
-      <span class="type">MamanBaz</span> declaration and implementation above:
-</p>
-<pre class="programlisting">
-struct _MamanBaz
-{
-  GObject parent_instance;
-  gint instance_member;
-  gchar *name;
-};
-enum
-{
-  PROP_0,
-  PROP_NAME
-};
-static void
-maman_baz_set_property (GObject      *object,
-                        guint         property_id,
-                        const GValue *value,
-                        GParamSpec   *pspec)
-{
-  MamanBaz *baz = MAMAN_BAZ (object);
-  GObject *obj;
-  switch (prop_id)
-    {
-    case ARG_NAME:
-      g_free (baz-&gt;name);
-      baz-&gt;name = g_value_dup_string (value);
-      break;
-    default:
-      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
-      break;
-    }
-}
-static void
-maman_baz_get_property (GObject    *object,
-                        guint       prop_id,
-                        GValue     *value,
-                        GParamSpec *pspec)
-{
-  MamanBaz *baz = MAMAN_BAZ (object);
-  switch (prop_id)
-    {
-    case ARG_NAME:
-      g_value_set_string (value, baz-&gt;name);
-      break;
-    default:
-      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
-      break;
-    }
-}
-static void
-maman_baz_class_init (MamanBazClass *klass)
-{
-  GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
-  gobject_class-&gt;set_property = maman_baz_set_property;
-  gobject_class-&gt;get_property = maman_baz_get_property;
-  g_object_class_override_property (gobject_class, PROP_NAME, "name");
-}
-</pre>
-<p>
-    </p>
-<div class="footnotes">
-<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a name="ftn.id471707" href="#id471707" class="para">12</a>] </sup>
-          That really is one line extended to six for the sake of clarity
-        </p></div>
-<div class="footnote"><p><sup>[<a name="ftn.id471720" href="#id471720" class="para">13</a>] </sup>
-          The <code class="function"><a class="link" href="gobject-The-Base-Object-Type.html#g-object-interface-install-property" title="g_object_interface_install_property ()">g_object_interface_install_property</a></code>
-          can also be called from <code class="function">class_init</code> but it must
-          not be called after that point.
-        </p></div>
-</div>
-</div>
-<div class="footer">
-<hr>
-          Generated by GTK-Doc V1.15.1</div>
-</body>
-</html>

data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html DELETED

@@ -1,160 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>How to define and implement interfaces</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="pt02.html" title="Part IV. Tutorial">
-<link rel="prev" href="howto-gobject-chainup.html" title="Chaining up">
-<link rel="next" href="howto-interface-implement.html" title="How To define implement an Interface?">
-<meta name="generator" content="GTK-Doc V1.15.1 (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-gobject-chainup.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="pt02.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="howto-interface-implement.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr></table>
-<div class="chapter">
-<div class="titlepage"><div><div><h2 class="title">
-<a name="howto-interface"></a>How to define and implement interfaces</h2></div></div></div>
-<div class="toc"><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></div>
-<div class="sect1">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="howto-interface-define"></a>How to define interfaces</h2></div></div></div>
-<p>
-    The bulk of interface definition has already been shown in <a class="xref" href="gtype-non-instantiable-classed.html" title="Non-instantiable classed types: interfaces">the section called “Non-instantiable classed types: interfaces”</a>
-    but I feel it is needed to show exactly how to create an interface.
-  </p>
-<p>
-    As above, the first step is to get the header right:
-</p>
-<pre class="programlisting">
-#ifndef __MAMAN_IBAZ_H__
-#define __MAMAN_IBAZ_H__
-#include &lt;glib-object.h&gt;
-#define MAMAN_TYPE_IBAZ                 (maman_ibaz_get_type ())
-#define MAMAN_IBAZ(obj)                 (G_TYPE_CHECK_INSTANCE_CAST ((obj), MAMAN_TYPE_IBAZ, MamanIbaz))
-#define MAMAN_IS_IBAZ(obj)              (G_TYPE_CHECK_INSTANCE_TYPE ((obj), MAMAN_TYPE_IBAZ))
-#define MAMAN_IBAZ_GET_INTERFACE(inst)  (G_TYPE_INSTANCE_GET_INTERFACE ((inst), MAMAN_TYPE_IBAZ, MamanIbazInterface))
-typedef struct _MamanIbaz               MamanIbaz; /* dummy object */
-typedef struct _MamanIbazInterface      MamanIbazInterface;
-struct _MamanIbazInterface
-{
-  GTypeInterface parent_iface;
-  void (*do_action) (MamanIbaz *self);
-};
-GType maman_ibaz_get_type (void);
-void maman_ibaz_do_action (MamanIbaz *self);
-#endif /* __MAMAN_IBAZ_H__ */
-</pre>
-<p>
-    This code is the same as the code for a normal <span class="type"><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a></span>
-    which derives from a <span class="type"><a class="link" href="gobject-The-Base-Object-Type.html#GObject">GObject</a></span> except for a few details:
-    </p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem"><p>
-        The <code class="function">_GET_CLASS</code> macro is called <code class="function">_GET_INTERFACE</code>
-                  and not implemented with <code class="function">G_TYPE_INSTANCE_GET_CLASS</code>
-                  but with <code class="function">G_TYPE_INSTANCE_GET_INTERFACE</code>.
-      </p></li>
-<li class="listitem"><p>
-        The instance type, <span class="type">MamanIbaz</span> is not fully defined: it is
-        used merely as an abstract type which represents an instance of
-        whatever object which implements the interface.
-      </p></li>
-<li class="listitem"><p>
-        The parent of the <span class="type">MamanIbazInterface</span> is not
-        <span class="type">GObjectClass</span> but <span class="type">GTypeInterface</span>.
-      </p></li>
-</ul></div>
-<p>
-  </p>
-<p>
-    The implementation of the <span class="type">MamanIbaz</span> type itself is trivial:
-    </p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem"><p><code class="function">maman_ibaz_get_type</code> registers the
-       type in the type system.
-       </p></li>
-<li class="listitem"><p><code class="function">maman_ibaz_base_init</code> is expected
-      to register the interface's signals if there are any (we will see a bit
-      (later how to use them). Make sure to use a static local boolean variable
-      to make sure not to run the initialization code twice (as described in
-      <a class="xref" href="gtype-non-instantiable-classed.html#gtype-non-instantiable-classed-init" title="Interface Initialization">the section called “Interface Initialization”</a>,
-      <code class="function">base_init</code> is run once for each interface implementation
-      instantiation)</p></li>
-<li class="listitem"><p><code class="function">maman_ibaz_do_action</code> dereferences
-      the class structure to access its associated class function and calls it.
-      </p></li>
-</ul></div>
-<p>
-</p>
-<pre class="programlisting">
-static void
-maman_ibaz_base_init (gpointer g_class)
-{
-  static gboolean is_initialized = FALSE;
-  if (!is_initialized)
-    {
-      /* add properties and signals to the interface here */
-      is_initialized = TRUE;
-    }
-}
-GType
-maman_ibaz_get_type (void)
-{
-  static GType iface_type = 0;
-  if (iface_type == 0)
-    {
-      static const GTypeInfo info = {
-        sizeof (MamanIbazInterface),
-        maman_ibaz_base_init,   /* base_init */
-        NULL,   /* base_finalize */
-      };
-      iface_type = g_type_register_static (G_TYPE_INTERFACE, "MamanIbaz",
-                                           &amp;info, 0);
-    }
-  return iface_type;
-}
-void
-maman_ibaz_do_action (MamanIbaz *self)
-{
-  g_return_if_fail (MAMAN_IS_IBAZ (self));
-  MAMAN_IBAZ_GET_INTERFACE (self)-&gt;do_action (self);
-}
-</pre>
-<p>
-    </p>
-</div>
-</div>
-<div class="footer">
-<hr>
-          Generated by GTK-Doc V1.15.1</div>
-</body>
-</html>