RubyGems - glib2 - Versions diffs - 0.90.8-x86-mingw32 → 0.90.9-x86-mingw32 - Mend

glib2 0.90.8-x86-mingw32 → 0.90.9-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 (620) hide show

data/vendor/local/share/gtk-doc/html/gio/application.html ADDED

@@ -0,0 +1,50 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Application support</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="GIO Reference Manual">
+<link rel="up" href="pt02.html" title="Part II. API Reference">
+<link rel="prev" href="GSimplePermission.html" title="GSimplePermission">
+<link rel="next" href="GActionGroup.html" title="GActionGroup">
+<meta name="generator" content="GTK-Doc V1.16.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="GSimplePermission.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">GIO Reference Manual</th>
+<td><a accesskey="n" href="GActionGroup.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="application"></a>Application support</h2></div></div></div>
+<div class="toc"><dl>
+<dt>
+<span class="refentrytitle"><a href="GActionGroup.html">GActionGroup</a></span><span class="refpurpose"> — A group of actions</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="GSimpleActionGroup.html">GSimpleActionGroup</a></span><span class="refpurpose"> — A simple GActionGroup implementation</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="GAction.html">GAction</a></span><span class="refpurpose"> — An action</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="GSimpleAction.html">GSimpleAction</a></span><span class="refpurpose"> — A simple GSimpleAction</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="GApplication.html">GApplication</a></span><span class="refpurpose"> — Core application class</span>
+</dt>
+<dt>
+<span class="refentrytitle"><a href="GApplicationCommandLine.html">GApplicationCommandLine</a></span><span class="refpurpose"> — A command-line invocation of an application</span>
+</dt>
+</dl></div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.16.1</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/gio/async.html CHANGED

@@ -6,20 +6,20 @@
 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
 <link rel="home" href="index.html" title="GIO Reference Manual">
 <link rel="up" href="pt02.html" title="Part II. API Reference">
-<link rel="prev" href="GFileMonitor.html" title="GFileMonitor">
+<link rel="prev" href="GFilenameCompleter.html" title="GFilenameCompleter">
 <link rel="next" href="GCancellable.html" title="GCancellable">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.16.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="GFileMonitor.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="p" href="GFilenameCompleter.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">GIO Reference Manual</th>
 <td><a accesskey="n" href="GCancellable.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 </tr></table>
-<div class="chapter" title="Asynchronous I/O">
+<div class="chapter">
 <div class="titlepage"><div><div><h2 class="title">
 <a name="async"></a>Asynchronous I/O</h2></div></div></div>
 <div class="toc"><dl>
@@ -39,6 +39,6 @@
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.16.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gio/ch01.html CHANGED

@@ -8,7 +8,7 @@
 <link rel="up" href="pt01.html" title="Part I. GIO Overview">
 <link rel="prev" href="pt01.html" title="Part I. GIO Overview">
 <link rel="next" href="ch02.html" title="Compiling GIO applications">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -19,9 +19,9 @@
 <th width="100%" align="center">GIO Reference Manual</th>
 <td><a accesskey="n" href="ch02.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 </tr></table>
-<div class="chapter" title="Introduction">
+<div class="chapter">
 <div class="titlepage"><div><div><h2 class="title">
-<a name="id527137"></a>Introduction</h2></div></div></div>
+<a name="id576294"></a>Introduction</h2></div></div></div>
 <p>
     GIO is striving to provide a modern, easy-to-use VFS API that sits
     at the right level in the library stack. The goal is to overcome the
@@ -202,6 +202,6 @@
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.16.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gio/ch02.html CHANGED

@@ -8,7 +8,7 @@
 <link rel="up" href="pt01.html" title="Part I. GIO Overview">
 <link rel="prev" href="ch01.html" title="Introduction">
 <link rel="next" href="ch03.html" title="Running GIO applications">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -19,9 +19,9 @@
 <th width="100%" align="center">GIO Reference Manual</th>
 <td><a accesskey="n" href="ch03.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 </tr></table>
-<div class="chapter" title="Compiling GIO applications">
+<div class="chapter">
 <div class="titlepage"><div><div><h2 class="title">
-<a name="id561937"></a>Compiling GIO applications</h2></div></div></div>
+<a name="id611240"></a>Compiling GIO applications</h2></div></div></div>
 <p>
       GIO comes with a <code class="filename">gio-2.0.pc</code> file that you
       should use together with <code class="literal">pkg-config</code> to obtain
@@ -40,11 +40,11 @@
 <p>
       Since GIO is based on GObject, you need to call <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#g-type-init"><code class="function">g_type_init()</code></a>
       before you can use any GIO functions. If your application uses
-      GTK+, this is already taken care of by <a href="http://library.gnome.org/devel/gtk/unstable/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a>.
+      GTK+, this is already taken care of by <a href="http://library.gnome.org/devel/gtk/2.24/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a>.
     </p>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.16.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gio/ch03.html CHANGED

@@ -8,7 +8,7 @@
 <link rel="up" href="pt01.html" title="Part I. GIO Overview">
 <link rel="prev" href="ch02.html" title="Compiling GIO applications">
 <link rel="next" href="extending-gio.html" title="Extending GIO">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -19,19 +19,19 @@
 <th width="100%" align="center">GIO Reference Manual</th>
 <td><a accesskey="n" href="extending-gio.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 </tr></table>
-<div class="chapter" title="Running GIO applications">
+<div class="chapter">
 <div class="titlepage"><div><div><h2 class="title">
-<a name="id562012"></a>Running GIO applications</h2></div></div></div>
+<a name="id611316"></a>Running GIO applications</h2></div></div></div>
 <p>
       GIO inspects a few of environment variables in addition to the
       ones used by GLib.
     </p>
-<p title="XDG_DATA_HOME, XDG_DATA_DIRS"><b><code class="envar">XDG_DATA_HOME</code>, <code class="envar">XDG_DATA_DIRS</code>. </b>
+<p><b><code class="envar">XDG_DATA_HOME</code>, <code class="envar">XDG_DATA_DIRS</code>. </b>
         GIO uses these environment variables to locate MIME information.
         For more information, see the <a class="ulink" href="http://freedesktop.org/Standards/shared-mime-info-spec" target="_top">Shared MIME-info Database</a>
         and the <a class="ulink" href="http://freedesktop.org/Standards/basedir-spec" target="_top">Base Directory Specification</a>.
       </p>
-<p title="GVFS_DISABLE_FUSE"><b><code class="envar">GVFS_DISABLE_FUSE</code>. </b>
+<p><b><code class="envar">GVFS_DISABLE_FUSE</code>. </b>
         This variable can be set to keep <span class="type">Gvfs</span> from starting the fuse backend,
         which may be unwanted or unnecessary in certain situations.
       </p>
@@ -40,51 +40,50 @@
       GIO itself or modules that it loads. They should not be set in a
       production environment.
     </p>
-<p title="GIO_USE_VFS"><b><code class="envar">GIO_USE_VFS</code>. </b>
+<p><b><code class="envar">GIO_USE_VFS</code>. </b>
         This environment variable can be set to the name of a <a class="link" href="GVfs.html" title="GVfs"><span class="type">GVfs</span></a>
         implementation to override the default for debugging purposes.
         The <a class="link" href="GVfs.html" title="GVfs"><span class="type">GVfs</span></a> implementation for local files that is included in GIO
         has the name "local", the implementation in the gvfs module has
         the name "gvfs".
       </p>
-<p title="GIO_USE_VOLUME_MONITOR"><b><code class="envar">GIO_USE_VOLUME_MONITOR</code>. </b>
+<p><b><code class="envar">GIO_USE_VOLUME_MONITOR</code>. </b>
         This variable can be set to the name of a <a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor"><span class="type">GVolumeMonitor</span></a>
         implementation to override the default for debugging purposes.
         The <a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor"><span class="type">GVolumeMonitor</span></a> implementation for local files that is included
         in GIO has the name "unix", the hal-based implementation in the
         gvfs module has the name "hal".
       </p>
-<p title="GIO_USE_URI_ASSOCIATION"><b><code class="envar">GIO_USE_URI_ASSOCIATION</code>. </b>
-        This variable can be set to the name of a <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfoLookup"><span class="type">GDesktopAppInfoLookup</span></a>
+<p><b><code class="envar">GIO_USE_TLS</code>. </b>
+        This variable can be set to the name of a <a class="link" href="GTlsBackend.html" title="GTlsBackend"><span class="type">GTlsBackend</span></a>
         implementation to override the default for debugging purposes.
-        GIO does not include a <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfoLookup"><span class="type">GDesktopAppInfoLookup</span></a> implementation,
-        the GConf-based implementation in the gvfs module has the name
-        "gconf".
+        GIO does not include a <a class="link" href="GTlsBackend.html" title="GTlsBackend"><span class="type">GTlsBackend</span></a> implementation, the gnutls-based
+        implementation in the glib-networking module has the name "gnutls".
       </p>
-<p title="GVFS_INOTIFY_DIAG"><b><code class="envar">GVFS_INOTIFY_DIAG</code>. </b>
+<p><b><code class="envar">GVFS_INOTIFY_DIAG</code>. </b>
         When this environment variable is set and GIO has been built
         with inotify support, a dump of diagnostic inotify information
         will be written every 20 seconds to a file named
         <code class="filename">/tmp/gvfsdid.<em class="replaceable"><code>pid</code></em></code>.
       </p>
-<p title="GIO_EXTRA_MODULES"><b><code class="envar">GIO_EXTRA_MODULES</code>. </b>
+<p><b><code class="envar">GIO_EXTRA_MODULES</code>. </b>
         When this environment variable is set to a path, or a set of
         paths separated by a colon, GIO will attempt to load
         modules from within the path.
       </p>
-<p title="GSETTINGS_BACKEND"><b><code class="envar">GSETTINGS_BACKEND</code>. </b>
+<p><b><code class="envar">GSETTINGS_BACKEND</code>. </b>
         This variable can be set to the name of a <a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a>
         implementation to override the default for debugging purposes.
         The memory-based implementation that is included in GIO has
         the name "memory", the one in dconf has the name "dconf-settings".
       </p>
-<p title="GSETTINGS_SCHEMA_DIR"><b><code class="envar">GSETTINGS_SCHEMA_DIR</code>. </b>
+<p><b><code class="envar">GSETTINGS_SCHEMA_DIR</code>. </b>
         This variable can be set to the name of a directory that is
         considered in addition to the <code class="filename">glib-2.0/schemas</code>
         subdirectories of the XDG system data dirs when looking
         for compiled schemas for <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a>.
       </p>
-<p title="DBUS_SYSTEM_BUS_ADDRESS"><b><code class="envar">DBUS_SYSTEM_BUS_ADDRESS</code>. </b>
+<p><b><code class="envar">DBUS_SYSTEM_BUS_ADDRESS</code>. </b>
         This variable is consulted to find the address of the D-Bus system
         bus. For the format of D-Bus addresses, see the D-Bus
         <a class="ulink" href="http://dbus.freedesktop.org/doc/dbus-specification.html#addresses" target="_top">specification</a>.
@@ -92,18 +91,18 @@
         Setting this variable overrides platform-specific ways of determining
         the system bus address.
       </p>
-<p title="DBUS_SESSION_BUS_ADDRESS"><b><code class="envar">DBUS_SESSION_BUS_ADDRESS</code>. </b>
+<p><b><code class="envar">DBUS_SESSION_BUS_ADDRESS</code>. </b>
         This variable is consulted to find the address of the D-Bus session bus.
         Setting this variable overrides platform-specific ways of determining
         the session bus address.
       </p>
-<p title="DBUS_STARTER_BUS_TYPE"><b><code class="envar">DBUS_STARTER_BUS_TYPE</code>. </b>
+<p><b><code class="envar">DBUS_STARTER_BUS_TYPE</code>. </b>
         This variable is consulted to find out the 'starter' bus for an
         application that has been started via D-Bus activation. The possible
         values are 'system' or 'session'.
       </p>
-<p title="G_DBUS_DEBUG"><b><code class="envar">G_DBUS_DEBUG</code>. </b>
+<p><b><code class="envar">G_DBUS_DEBUG</code>. </b>
          This variable can be set to a list of debug options, which
          cause GLib to print out different types of debugging
          information when using the D-Bus routines.
@@ -153,20 +152,20 @@
 </tr>
 </tbody>
 </table></div>
-<p title="G_DBUS_DEBUG">
+<p>
          The special value <code class="literal">all</code> can be used to turn
          on all debug options. The special value
          <code class="literal">help</code> can be used to print a list of
          supported options to standard output.
       </p>
-<p title="G_DBUS_COOKIE_SHA1_KEYRING_DIR"><b><code class="envar">G_DBUS_COOKIE_SHA1_KEYRING_DIR</code>. </b>
+<p><b><code class="envar">G_DBUS_COOKIE_SHA1_KEYRING_DIR</code>. </b>
         Can be used to override the directory used to store the
         keyring used in the <code class="literal">DBUS_COOKIE_SHA1</code>
         authentication mechanism. Normally the directory used is
         <code class="filename">.dbus-keyrings</code> in the user's home
         directory.
       </p>
-<p title="G_DBUS_COOKIE_SHA1_KEYRING_DIR_IGNORE_PERMISSION"><b><code class="envar">G_DBUS_COOKIE_SHA1_KEYRING_DIR_IGNORE_PERMISSION</code>. </b>
+<p><b><code class="envar">G_DBUS_COOKIE_SHA1_KEYRING_DIR_IGNORE_PERMISSION</code>. </b>
         If set, the permissions of the directory used to store the
         keyring used in the <code class="literal">DBUS_COOKIE_SHA1</code>
         authentication mechanism won't be checked. Normally the
@@ -175,6 +174,6 @@
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.16.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gio/ch26.html CHANGED

@@ -2,56 +2,74 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Migrating from GConf to GSettings</title>
+<title>Migrating from POSIX to GIO</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
 <link rel="home" href="index.html" title="GIO Reference Manual">
-<link rel="up" href="migrating.html" title="Part III. Migrating to GIO">
-<link rel="prev" href="ch25s03.html" title="Mime monitoring">
-<link rel="next" href="ch26s02.html" title="Conceptual differences">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<link rel="up" href="migrating.html" title="Part I. Migrating to GIO">
+<link rel="prev" href="migrating.html" title="Part I. Migrating to GIO">
+<link rel="next" href="ch27.html" title="Migrating from GnomeVFS to GIO">
+<meta name="generator" content="GTK-Doc V1.16.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="ch25s03.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="p" href="migrating.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 <td><a accesskey="u" href="migrating.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">GIO Reference Manual</th>
-<td><a accesskey="n" href="ch26s02.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+<td><a accesskey="n" href="ch27.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 </tr></table>
-<div class="chapter" title="Migrating from GConf to GSettings">
+<div class="chapter">
 <div class="titlepage"><div><div><h2 class="title">
-<a name="id642579"></a>Migrating from GConf to GSettings</h2></div></div></div>
-<div class="toc"><dl>
-<dt><span class="section"><a href="ch26.html#id599216">Before you start</a></span></dt>
-<dt><span class="section"><a href="ch26s02.html">Conceptual differences</a></span></dt>
-<dt><span class="section"><a href="ch26s03.html">GConfClient (and GConfBridge) API conversion</a></span></dt>
-<dt><span class="section"><a href="ch26s04.html">Change notification</a></span></dt>
-<dt><span class="section"><a href="ch26s05.html">Change sets</a></span></dt>
-<dt><span class="section"><a href="ch26s06.html">Schema conversion</a></span></dt>
-<dt><span class="section"><a href="ch26s07.html">Data conversion</a></span></dt>
-</dl></div>
-<div class="section" title="Before you start">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="id599216"></a>Before you start</h2></div></div></div>
-<p>
-        Converting individual applications and their settings from GConf to
-        GSettings can be done at will. But desktop-wide settings like font or
-        theme settings often have consumers in multiple modules. Therefore,
-        some consideration has to go into making sure that all users of a setting
-        are converted to GSettings at the same time or that the program
-        responsible for configuring that setting continues to update the value in
-        both places.
-      </p>
-<p>
-        It is always a good idea to have a look at how others have handled
-        similar problems before.  An examplaric conversion can be found e.g.
-        in the <a class="ulink" href="http://git.gnome.org/browse/gnome-utils/log/?h=gsettings-tutorial" target="_top">gsettings-tutorial</a> branch of gnome-utils.
-      </p>
+<a name="id853639"></a>Migrating from POSIX to GIO</h2></div></div></div>
+<div class="table">
+<a name="posix-vs-gio"></a><p class="title"><b>Table 4. Comparison of POSIX and GIO concepts</b></p>
+<div class="table-contents"><table summary="Comparison of POSIX and GIO concepts" border="1">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>POSIX</th>
+<th>GIO</th>
+</tr></thead>
+<tbody>
+<tr>
+<td>char *path</td>
+<td>GFile *file</td>
+</tr>
+<tr>
+<td>struct stat *buf</td>
+<td>GFileInfo *info</td>
+</tr>
+<tr>
+<td>struct statvfs *buf</td>
+<td>GFileInfo *info</td>
+</tr>
+<tr>
+<td rowspan="2">int fd</td>
+<td>GInputStream *in</td>
+</tr>
+<tr><td>GOutputStream *out</td></tr>
+<tr>
+<td>DIR *</td>
+<td>GFileEnumerator *enum</td>
+</tr>
+<tr>
+<td>fstab entry</td>
+<td>GUnixMountPoint *mount_point</td>
+</tr>
+<tr>
+<td>mtab entry</td>
+<td>GUnixMountEntry *mount_entry</td>
+</tr>
+</tbody>
+</table></div>
 </div>
+<br class="table-break">
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.16.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gio/ch27.html CHANGED

@@ -2,69 +2,216 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Migrating to GDBus</title>
+<title>Migrating from GnomeVFS to GIO</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
 <link rel="home" href="index.html" title="GIO Reference Manual">
 <link rel="up" href="migrating.html" title="Part III. Migrating to GIO">
-<link rel="prev" href="ch26s07.html" title="Data conversion">
-<link rel="next" href="ch27s02.html" title="API comparison">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<link rel="prev" href="ch26.html" title="Migrating from POSIX to GIO">
+<link rel="next" href="ch27s02.html" title="Operations on multiple files">
+<meta name="generator" content="GTK-Doc V1.16.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="ch26s07.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="p" href="ch26.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 <td><a accesskey="u" href="migrating.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">GIO Reference Manual</th>
 <td><a accesskey="n" href="ch27s02.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 </tr></table>
-<div class="chapter" title="Migrating to GDBus">
+<div class="chapter">
 <div class="titlepage"><div><div><h2 class="title">
-<a name="id613902"></a>Migrating to GDBus</h2></div></div></div>
+<a name="id834432"></a>Migrating from GnomeVFS to GIO</h2></div></div></div>
 <div class="toc"><dl>
-<dt><span class="section"><a href="ch27.html#id710900">Conceptual differences</a></span></dt>
-<dt><span class="section"><a href="ch27s02.html">API comparison</a></span></dt>
-<dt><span class="section"><a href="ch27s03.html">Owning bus names</a></span></dt>
-<dt><span class="section"><a href="ch27s04.html">Creating proxies for well-known names</a></span></dt>
-<dt><span class="section"><a href="ch27s05.html">Client-side GObject bindings</a></span></dt>
-<dt><span class="section"><a href="ch27s06.html">Exporting objects</a></span></dt>
+<dt><span class="section"><a href="ch27.html#id895911">Trash handling</a></span></dt>
+<dt><span class="section"><a href="ch27s02.html">Operations on multiple files</a></span></dt>
+<dt><span class="section"><a href="ch27s03.html">Mime monitoring</a></span></dt>
 </dl></div>
-<div class="section" title="Conceptual differences">
+<div class="table">
+<a name="gnome-vfs-vs-gio"></a><p class="title"><b>Table 5. Comparison of GnomeVFS and GIO concepts</b></p>
+<div class="table-contents"><table summary="Comparison of GnomeVFS and GIO concepts" border="1">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>GnomeVFS</th>
+<th>GIO</th>
+</tr></thead>
+<tbody>
+<tr>
+<td>GnomeVFSURI</td>
+<td>GFile</td>
+</tr>
+<tr>
+<td>GnomeVFSFileInfo</td>
+<td>GFileInfo</td>
+</tr>
+<tr>
+<td>GnomeVFSResult</td>
+<td>GError, with G_IO_ERROR values</td>
+</tr>
+<tr>
+<td>GnomeVFSHandle &amp; GnomeVFSAsyncHandle</td>
+<td>GInputStream or GOutputStream</td>
+</tr>
+<tr>
+<td>GnomeVFSDirectoryHandle</td>
+<td>GFileEnumerator</td>
+</tr>
+<tr>
+<td>mime type</td>
+<td>content type</td>
+</tr>
+<tr>
+<td>GnomeVFSMonitor</td>
+<td>GFileMonitor</td>
+</tr>
+<tr>
+<td>GnomeVFSVolumeMonitor</td>
+<td>GVolumeMonitor</td>
+</tr>
+<tr>
+<td>GnomeVFSVolume</td>
+<td>GMount</td>
+</tr>
+<tr>
+<td>GnomeVFSDrive</td>
+<td>GVolume</td>
+</tr>
+<tr>
+<td>-</td>
+<td>GDrive</td>
+</tr>
+<tr>
+<td>GnomeVFSContext</td>
+<td>GCancellable</td>
+</tr>
+<tr>
+<td>gnome_vfs_async_cancel</td>
+<td>g_cancellable_cancel</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<br class="table-break"><div class="section">
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="id710900"></a>Conceptual differences</h2></div></div></div>
+<a name="id895911"></a>Trash handling</h2></div></div></div>
+<p>
+        The handling of trashed files has been changed in GIO, compared
+        to gnome-vfs. gnome-vfs has a home-grown trash implementation that
+        predates the freedesktop.org <a class="ulink" href="http://www.freedesktop.org/wiki/Specifications/trash-spec" target="_top">Desktop Trash Can</a> specification
+        that is implemented in GIO. The location for storing trashed files
+        has changed from <code class="filename">$HOME/.Trash</code> to
+        <code class="filename">$HOME/.local/share/Trash</code> (or more correctly
+        <code class="filename">$XDG_DATA_HOME/Trash</code>), which means that
+        there is a need for migrating files that have been trashed by
+        gnome-vfs to the new location.
+      </p>
 <p>
-      The central concepts of D-Bus are modelled in a very similar way
-      in dbus-glib and GDBus. Both have a objects representing connections,
-      proxies and method invocations. But there are some important
-      differences:
+        In gnome-vfs, the <code class="filename">trash://</code> scheme offering a
+        merged view of all trash directories was implemented in nautilus,
+        and trash-handling applications had to find and monitor all trash
+        directories themselves. With GIO, the <code class="filename">trash://</code>
+        implementation has been moved to gvfs and applications can simply
+        monitor that location:
       </p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem"><p>
-          dbus-glib uses libdbus, GDBus doesn't. Instead, it relies on GIO
-          streams as transport layer, and has its own implementation for the
-          the D-Bus connection setup and authentication. Apart from using
-          streams as transport, avoiding libdbus also lets GDBus avoid some
-          thorny multithreading issues.
-        </p></li>
-<li class="listitem"><p>
-          dbus-glib uses the GObject type system for method arguments and
-          return values, including a homegrown container specialization
-          mechanism. GDBus relies uses the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> type system which is
-          explicitly designed to match D-Bus types.
-        </p></li>
-<li class="listitem"><p>
-          The typical way to export an object in dbus-glib involves generating
-          glue code from XML introspection data using <span class="command"><strong>dbus-binding-tool</strong></span>. GDBus does not (yet?) use code generation; you are expected to
-          embed the introspection data in your application code.
-        </p></li>
-</ul></div>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
+<span class="function">file_changed</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GFileMonitor</span><span class="normal">      </span><span class="symbol">*</span><span class="normal">file_monitor</span><span class="symbol">,</span>
+<span class="normal">              </span><span class="usertype">GFile</span><span class="normal">             </span><span class="symbol">*</span><span class="normal">child</span><span class="symbol">,</span>
+<span class="normal">              </span><span class="usertype">GFile</span><span class="normal">             </span><span class="symbol">*</span><span class="normal">other_file</span><span class="symbol">,</span>
+<span class="normal">              </span><span class="usertype">GFileMonitorEvent</span><span class="normal">  event_type</span><span class="symbol">,</span>
+<span class="normal">              </span><span class="usertype">gpointer</span><span class="normal">           user_data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="keyword">switch</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event_type</span><span class="symbol">)</span>
+<span class="normal">  </span><span class="cbracket">{</span>
+<span class="normal">  </span><span class="keyword">case</span><span class="normal"> <a href="GFileMonitor.html#G-FILE-MONITOR-EVENT-DELETED:CAPS">G_FILE_MONITOR_EVENT_DELETED</a></span><span class="symbol">:</span>
+<span class="normal">    </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"'%s' removed from trash</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="GFile.html#g-file-get-basename">g_file_get_basename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child</span><span class="symbol">));</span>
+<span class="normal">    </span><span class="keyword">break</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="keyword">case</span><span class="normal"> <a href="GFileMonitor.html#G-FILE-MONITOR-EVENT-CREATED:CAPS">G_FILE_MONITOR_EVENT_CREATED</a></span><span class="symbol">:</span>
+<span class="normal">    </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"'%s' added to trash</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="GFile.html#g-file-get-basename">g_file_get_basename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child</span><span class="symbol">));</span>
+<span class="normal">    </span><span class="keyword">break</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="keyword">default</span><span class="symbol">:</span><span class="normal"> </span><span class="symbol">;</span>
+<span class="normal">  </span><span class="cbracket">}</span>
+<span class="cbracket">}</span>
+<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
+<span class="function">start_monitoring_trash</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GFile</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">file</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="usertype">GFileMonitor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">monitor</span><span class="symbol">;</span>
+<span class="normal">  file </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GFile.html#g-file-new-for-uri">g_file_new_for_uri</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"trash://"</span><span class="symbol">);</span>
+<span class="normal">  monitor </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GFile.html#g-file-monitor-directory">g_file_monitor_directory</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">monitor</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"changed"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_changed</span><span class="symbol">),</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+<span class="normal">  </span><span class="comment">/* ... */</span>
+<span class="cbracket">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
 <p>
-    </p>
+        GIO exposes some useful metadata about trashed files. There are
+        trash::orig-path and trash::deletion-date attributes. The
+        standard::icon attribute of the <code class="filename">trash://</code>
+        itself provides a suitable icon for displaying the trash can on
+        the desktop. If you are using this icon, make sure to monitor
+        this attribute for changes, since the icon may be updated to
+        reflect that state of the trash can.
+      </p>
+<p>
+        Moving a file to the trash is much simpler with GIO. Instead of
+        using <a href="/usr/share/gtk-doc/html/gnome-vfs-2.0/gnome-vfs-2.0-gnome-vfs-directory-find-ops.html#gnome-vfs-find-directory"><code class="function">gnome_vfs_find_directory()</code></a> with <a href="/usr/share/gtk-doc/html/gnome-vfs-2.0/gnome-vfs-2.0-gnome-vfs-directory-find-ops.html#GNOME-VFS-DIRECTORY-KIND-TRASH:CAPS"><code class="literal">GNOME_VFS_DIRECTORY_KIND_TRASH</code></a>
+        to find out where to move the trashed file, just use the <a class="link" href="GFile.html#g-file-trash" title="g_file_trash ()"><code class="function">g_file_trash()</code></a>
+        function.
+      </p>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.16.1</div>
 </body>
 </html>