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

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>