Fix up includes in section docs

svn path=/trunk/; revision=6149

diff --git a/gio/ChangeLog b/gio/ChangeLog
index 13f0ed1aa9e9bf4e98d87347009e878229e31139..4a8da254eea7430f0f9d549c084a2282fdbc89f4 100644 (file)
--- a/gio/ChangeLog
+++ b/gio/ChangeLog
@@ -1,3 +1,7 @@
+2007-12-17  Matthias Clasen  <mclasen@redhat.com>
+
+       * *.c: Fix up includes in the section docs.
+
 2007-12-17  Alexander Larsson  <alexl@redhat.com>
 
         * gnativevolumemonitor.h:

diff --git a/gio/gappinfo.c b/gio/gappinfo.c
index 53e218d6d38afa4303349f1b1979fab8bf3b07b5..c2d4d5ca12e7954b8330eec218b8088152e8f6a1 100644 (file)
--- a/gio/gappinfo.c
+++ b/gio/gappinfo.c
@@ -30,7 +30,7 @@
 /**
  * SECTION:gappinfo
  * @short_description: Application information and launch contexts
- * @stability: Unstable
+ * @include: gio.h
  * 
  * #GAppInfo and #GAppLaunchContext are used for describing and launching 
  * applications installed on the system. 

diff --git a/gio/gasynchelper.c b/gio/gasynchelper.c
index 72fb87e923835037c2cf4e8b0c3fd1c1ea7c8bba..4c7c7897be2a3e2960d1a7f1b17b458683d2213f 100644 (file)
--- a/gio/gasynchelper.c
+++ b/gio/gasynchelper.c
@@ -29,6 +29,7 @@
 /**
  * SECTION:gasynchelper
  * @short_description: Asynchronous Helper Functions
+ * @include: gio.h
  * @see_also: #GAsyncReady
  * 
  * Provides helper functions for asynchronous operations.

diff --git a/gio/gasyncresult.c b/gio/gasyncresult.c
index 60c829c2d87954425fd3f715ef9107d3c0bf67dc..7238918cfd5bb2c06982c0201f07521acf27f510 100644 (file)
--- a/gio/gasyncresult.c
+++ b/gio/gasyncresult.c
@@ -29,6 +29,7 @@
 /**
  * SECTION:gasyncresult
  * @short_description: Asynchronous Function Results
+ * @include: gio.h
  * @see_also: #GSimpleAsyncResult
  * 
  * Provides a base class for implementing asynchronous function results.

diff --git a/gio/gbufferedinputstream.c b/gio/gbufferedinputstream.c
index 7ff397b4309f13612f90b0b34cf687efc4e6ac1c..6cc537ed4fae375419577c2becf56dc25808d6a0 100644 (file)
--- a/gio/gbufferedinputstream.c
+++ b/gio/gbufferedinputstream.c
@@ -33,6 +33,7 @@
 /**
  * SECTION:gbufferedinputstream
  * @short_description: Buffered Input Stream
+ * @include: gio.h
  * @see_also: #GFilterInputStream, #GInputStream
  * 
  * Buffered input stream implements #GFilterInputStream and provides 

diff --git a/gio/gbufferedoutputstream.c b/gio/gbufferedoutputstream.c
index 06ad69193163e1865815c68dc17e7c18cc8fd0e7..04468eda1a8132a1034a202e475b23927923d64f 100644 (file)
--- a/gio/gbufferedoutputstream.c
+++ b/gio/gbufferedoutputstream.c
@@ -32,6 +32,7 @@
 /**
  * SECTION:gbufferedoutputstream
  * @short_description: Buffered Output Stream
+ * @include: gio.h
  * @see_also: #GFilterOutputStream, #GOutputStream
  * 
  * Buffered output stream implements #GFilterOutputStream and provides 

diff --git a/gio/gcancellable.c b/gio/gcancellable.c
index 4624b429c0bb437dbe0f10fe0622c30fb9ba9716..e49460c10dc0d8db9f22f9a504f732707dfbb02d 100644 (file)
--- a/gio/gcancellable.c
+++ b/gio/gcancellable.c
@@ -40,7 +40,7 @@
 /**
  * SECTION:gcancellable
  * @short_description: Thread-safe Operation Cancellation Stack
- * @include: gio/gcancellable.h
+ * @include: gio.h
  *
  * GCancellable is a thread-safe operation cancellation stack used 
  * throughout GIO to allow for cancellation of synchronous and

diff --git a/gio/gcontenttype.c b/gio/gcontenttype.c
index 2404a7b42f0d60aaf3153219e49988c34f3450fe..ea8c20411104edb4d36e4f516fe8290bb5456406 100644 (file)
--- a/gio/gcontenttype.c
+++ b/gio/gcontenttype.c
@@ -32,6 +32,7 @@
 /**
  * SECTION:gcontenttype
  * @short_description: Platform-specific content typing
+ * @include: gio.h
  *
  * A content type is a platform specific string that defines the type
  * of a file. On unix it is a mime type, on win32 it is an extension string

diff --git a/gio/gdatainputstream.c b/gio/gdatainputstream.c
index aa90272b05beac238d59d5214c390c004d59b1ad..44ffd2b6be9d34e6ed400c96bf4c1129554498e0 100644 (file)
--- a/gio/gdatainputstream.c
+++ b/gio/gdatainputstream.c
@@ -31,6 +31,7 @@
 /**
  * SECTION:gdatainputstream
  * @short_description: Data Input Stream
+ * @include: gio.h
  * @see_also: #GInputStream
  * 
  * Data input stream implements #GInputStream and includes functions for 

diff --git a/gio/gdataoutputstream.c b/gio/gdataoutputstream.c
index b7ab2caf43b473b11e9e069a9718f41e9e249f56..4929755c7024118c191995a1de0ae5883d0ef7df 100644 (file)
--- a/gio/gdataoutputstream.c
+++ b/gio/gdataoutputstream.c
@@ -31,6 +31,7 @@
 /**
  * SECTION:gdataoutputstream
  * @short_description: Data Output Stream
+ * @include: gio.h
  * @see_also: #GOutputStream
  * 
  * Data output stream implements #GOutputStream and includes functions for 

diff --git a/gio/gdesktopappinfo.c b/gio/gdesktopappinfo.c
index e2a328b53d56dfaff28d1593db1282c08ae422bb..9f5d308432fd9885db7b4fce9a223e44d1c8fc02 100644 (file)
--- a/gio/gdesktopappinfo.c
+++ b/gio/gdesktopappinfo.c
@@ -38,6 +38,16 @@
 
 #include "gioalias.h"
 
+/**
+ * SECTION:gdesktopappinfo
+ * @short_description: Application information from desktop files
+ * @include: gio/gdesktopappinfo.h 
+ * 
+ * #GDesktopAppInfo is an implementation of #GAppInfo based on
+ * desktop files.
+ *
+ **/
+
 #define DEFAULT_APPLICATIONS_GROUP  "Default Applications" 
 #define MIME_CACHE_GROUP            "MIME Cache"
 

diff --git a/gio/gdirectorymonitor.c b/gio/gdirectorymonitor.c
index 018b8bb148c4c82d0a23b8ab6b3a5ce6a39975d8..39bf95a6757d55e6ff42adbbc8043dc6706580b4 100644 (file)
--- a/gio/gdirectorymonitor.c
+++ b/gio/gdirectorymonitor.c
@@ -34,6 +34,7 @@
 /**
  * SECTION:gdirectorymonitor
  * @short_description: Directory Monitor
+ * @include: gio.h
  * @see_also: #GFileMonitor
  * 
  * Monitors a directory for changes to files in it.

diff --git a/gio/gdrive.c b/gio/gdrive.c
index 06d90979e7c2d907b59c483bb76a90dbdd44f996..642ef6b2fbf9d8e131ef8bce86ccd2fc1095452b 100644 (file)
--- a/gio/gdrive.c
+++ b/gio/gdrive.c
@@ -31,7 +31,7 @@
 /**
  * SECTION:gdrive
  * @short_description: Virtual File System drive management
- * @include: gio/gdrive.h
+ * @include: gio.h
  * 
  * #GDrive is a container class for #GVolume objects that stem from
  * the same piece of media. As such, #GDrive abstracts a drive with

diff --git a/gio/gfile.c b/gio/gfile.c
index 68d9537aff458836db5244604449124f806fcae3..f3829da3d31b3a4bd9d0a613f04dfb85c63d8c9c 100644 (file)
--- a/gio/gfile.c
+++ b/gio/gfile.c
@@ -40,8 +40,8 @@
 /**
  * SECTION:gfile
  * @short_description: File and Directory Handling
+ * @include: gio.h
  * @see_also: #GFileInfo, #GFileEnumerator
- * @include: gio/gfile.h
  * 
  * #GFile is a high level abstraction for manipulating files on a 
  * virtual file system. #GFile<!-- -->s are lightweight, immutable 

diff --git a/gio/gfileattribute.c b/gio/gfileattribute.c
index fc04a55d12612f6d3e3e89442a3ebc16a5e77a26..98c8beea009f8667cdac08b21f00d14df2a67d54 100644 (file)
--- a/gio/gfileattribute.c
+++ b/gio/gfileattribute.c
@@ -34,6 +34,7 @@
 /**
  * SECTION:gfileattribute
  * @short_description: Key-Value Paired File Attributes
+ * @include: gio.h
  * @see_also: #GFile, #GFileInfo
  * 
  * File attributes in GIO consist of a list of key-value pairs. 

diff --git a/gio/gfileenumerator.c b/gio/gfileenumerator.c
index 51032a57128efd31cd5727a11ba2db1631bfab82..2c478fa916818bb7211262e64148772a3931fbf9 100644 (file)
--- a/gio/gfileenumerator.c
+++ b/gio/gfileenumerator.c
@@ -32,20 +32,23 @@
 /**
  * SECTION:gfileenumerator
  * @short_description: Enumerated Files Routines
+ * @include: gio.h
  * 
- * #GFileEnumerator allows you to operate on a set of #GFile<!-- -->s, returning
- * a #GFileInfo structure for each file enumerated (e.g. g_file_enumerate_children() 
- * will return a #GFileEnumerator for each of the children within a directory).
+ * #GFileEnumerator allows you to operate on a set of #GFile<!-- -->s, 
+ * returning a #GFileInfo structure for each file enumerated (e.g. 
+ * g_file_enumerate_children() will return a #GFileEnumerator for each 
+ * of the children within a directory).
  *
  * To get the next file's information from a #GFileEnumerator, use 
  * g_file_enumerator_next_file() or its asynchronous version, 
- * g_file_enumerator_next_file_async(). Note that the asynchronous version will
- * return a list of #GFileInfo<!---->s, whereas the synchronous will only return 
- * the next file in the enumerator.
+ * g_file_enumerator_next_file_async(). Note that the asynchronous 
+ * version will return a list of #GFileInfo<!---->s, whereas the 
+ * synchronous will only return the next file in the enumerator.
  *
- * To close a #GFileEnumerator, use g_file_enumerator_close(), or its asynchronous 
- * version, g_file_enumerator_close_async(). Once a #GFileEnumerator is closed, 
- * no further actions may be performed on it, and it should be freed with g_object_unref().
+ * To close a #GFileEnumerator, use g_file_enumerator_close(), or 
+ * its asynchronous version, g_file_enumerator_close_async(). Once 
+ * a #GFileEnumerator is closed, no further actions may be performed 
+ * on it, and it should be freed with g_object_unref().
  * 
  **/ 
 

diff --git a/gio/gfileicon.c b/gio/gfileicon.c
index 571d9010f1a84567252baf33535a46c3bad5f118..16e06b37b3b4a2c028ca908e0fee24e44d03bfa8 100644 (file)
--- a/gio/gfileicon.c
+++ b/gio/gfileicon.c
@@ -30,8 +30,8 @@
 /**
  * SECTION:gfileicon
  * @short_description: Icons pointing to an image file
+ * @include: gio.h
  * @see_also: #GIcon, #GLoadableIcon
- * @include: gio/gfileicon.h
  * 
  * #GFileIcon specifies an icon by pointing to an image file
  * to be used as icon.

diff --git a/gio/gfileinfo.c b/gio/gfileinfo.c
index f1f02647ca74256ba8d2d1387d9e95dfa21bc005..dbdbd43ca526a29744465bc211c8ef16fce6f811 100644 (file)
--- a/gio/gfileinfo.c
+++ b/gio/gfileinfo.c
@@ -23,6 +23,7 @@
 /**
  * SECTION:gfileinfo
  * @short_description: File Information and Attributes
+ * @include: gio.h
  * @see_also: #GFile
  * 
  * Functionality for manipulating basic metadata for files. #GFileInfo
@@ -30,9 +31,6 @@
  * contain, and allows for manipulation of extended attributes. 
  * #GFileAttributeMatcher allows for searching through a #GFileInfo for 
  * attributes.
- * 
- * 
- * 
  **/
 
 #include <config.h>

diff --git a/gio/gfileinputstream.c b/gio/gfileinputstream.c
index 3edd3f30641fad9b5a551d38f5a25bf18221f43f..c171858ff8ee096bc78d4724e75cd049735a1433 100644 (file)
--- a/gio/gfileinputstream.c
+++ b/gio/gfileinputstream.c
@@ -33,9 +33,8 @@
 /**
  * SECTION:gfileinputstream
  * @short_description: File input streaming operations
+ * @include: gio.h
  * @see_also: #GInputStream, #GDataInputStream, #GSeekable
- * 
- * 
  *
  **/
 

diff --git a/gio/gfilemonitor.c b/gio/gfilemonitor.c
index fdfbc1160b59a94fbeb449aae4a62d545184cb32..fb04d550b0bee9849c40b10736624e9d115b6279 100644 (file)
--- a/gio/gfilemonitor.c
+++ b/gio/gfilemonitor.c
@@ -33,6 +33,7 @@
 /**
  * SECTION:gfilemonitor
  * @short_description: File Monitor
+ * @include: gio.h
  * @see_also: #GDirectoryMonitor
  *
  * Monitors a file for changes.

diff --git a/gio/gfilenamecompleter.c b/gio/gfilenamecompleter.c
index 8558ecfdad697d5122b4dad4920c42bf9efdf2fc..8c0a8f94ec8f5d99b0b2b832d218ca6e6d1e9b84 100644 (file)
--- a/gio/gfilenamecompleter.c
+++ b/gio/gfilenamecompleter.c
@@ -32,6 +32,7 @@
 /**
  * SECTION:gfilenamecompleter
  * @short_description: Filename Completer
+ * @include: gio.h
  * 
  * Completes partial file and directory names given a partial string by
  * looking in the file system for clues. Can return a list of possible 

diff --git a/gio/gfileoutputstream.c b/gio/gfileoutputstream.c
index ba66bdf940a624177ce57233d6c4d02e32c8a2d6..4f8892c0e3130d245dbe187ba3fac2fb98d83cbc 100644 (file)
--- a/gio/gfileoutputstream.c
+++ b/gio/gfileoutputstream.c
@@ -33,9 +33,9 @@
 /**
  * SECTION:gfileoutputstream
  * @short_description: File output streaming operations
+ * @include: gio.h
  * @see_also: #GOutputStream, #GDataOutputStream, #GSeekable
  * 
- * 
  *
  **/
 

diff --git a/gio/gfilterinputstream.c b/gio/gfilterinputstream.c
index 0eb4eb362440115933018836d181bfdd780a13dd..05557b203516fd5563ec392a233e1e90dd69deed 100644 (file)
--- a/gio/gfilterinputstream.c
+++ b/gio/gfilterinputstream.c
@@ -30,6 +30,7 @@
 /**
  * SECTION:gfilterinputstream
  * @short_description: Filter Input Stream
+ * @include: gio.h
  *
  **/
 

diff --git a/gio/gfilteroutputstream.c b/gio/gfilteroutputstream.c
index ed433be3402b093bd8b160a9b939e9f8505716f3..a307e4f6800b0e13e2bb38b08f372fb9ffdbc58e 100644 (file)
--- a/gio/gfilteroutputstream.c
+++ b/gio/gfilteroutputstream.c
@@ -30,6 +30,7 @@
 /**
  * SECTION:gfilteroutputstream
  * @short_description: Filter Output Stream
+ * @include: gio.h
  *
  **/
 

diff --git a/gio/gicon.c b/gio/gicon.c
index b5c61da0b663bc613b8b20f77499213cf59af1f5..c7198dcf0572b28d8b5f9ba5c219fddb2db4cde3 100644 (file)
--- a/gio/gicon.c
+++ b/gio/gicon.c
@@ -30,6 +30,7 @@
 /**
  * SECTION:gicon
  * @short_description: Interface for icons
+ * @include: gio.h
  *
  * #GIcon is a very minimal interface for icons. It provides functions 
  * for checking the equality of two icons and hashing of icons.

diff --git a/gio/ginputstream.c b/gio/ginputstream.c
index c553656970a4c25ed639e41dd759f792b2dd514d..6dba6729e7ed8577721faaefb860aed8fbf163ff 100644 (file)
--- a/gio/ginputstream.c
+++ b/gio/ginputstream.c
@@ -33,6 +33,7 @@
 /**
  * SECTION:ginputstream
  * @short_description: Base class for implementing streaming input
+ * @include: gio.h
  *
  * 
  * 

diff --git a/gio/gioerror.c b/gio/gioerror.c
index 194275dbaf16f34f5b43d95de13b4dd8b0f93fb2..b72ea4f919a0d8812767a00d42be8560ffe6b92c 100644 (file)
--- a/gio/gioerror.c
+++ b/gio/gioerror.c
@@ -29,6 +29,7 @@
 /**
  * SECTION:gioerror
  * @short_description: Error helper functions
+ * @include: gio.h
  *
  * Contains helper functions for reporting errors to the user.
  **/

diff --git a/gio/giomodule.c b/gio/giomodule.c
index 8312d8069ac4f2e364787a7e6015a289fac2170f..b87d3199972b0774d9f8bfe7cfc5180c135cebb9 100644 (file)
--- a/gio/giomodule.c
+++ b/gio/giomodule.c
@@ -30,6 +30,7 @@
 /**
  * SECTION:giomodule
  * @short_description: Loadable GIO Modules
+ * @include: gio.h
  *
  * Provides an interface and default functions for loading and unloading 
  * modules. This is used internally to make gio extensible, but can also

diff --git a/gio/gioscheduler.c b/gio/gioscheduler.c
index 54610f08e43911d3aeda368ecb705550c381966e..225646685a2bdfaff894c9e535581f9d7b5a713f 100644 (file)
--- a/gio/gioscheduler.c
+++ b/gio/gioscheduler.c
@@ -29,9 +29,11 @@
 /**
  * SECTION:gioscheduler
  * @short_description: I/O Scheduler
+ * @include: gio.h
  * 
- * Schedules asynchronous I/O operations. #GIOScheduler integrates into the main 
- * event loop (#GMainLoop) and may use threads if they are available.
+ * Schedules asynchronous I/O operations. #GIOScheduler integrates 
+ * into the main event loop (#GMainLoop) and may use threads if they 
+ * are available.
  * 
  * <para id="io-priority"><indexterm><primary>I/O priority</primary></indexterm>
  * Each I/O operation has a priority, and the scheduler uses the priorities

diff --git a/gio/gloadableicon.c b/gio/gloadableicon.c
index e9cac77eabe6fbd4c556128394a24cb67f3bd008..593f80494d61f0a43f244ac5940ebd26b1ad75f9 100644 (file)
--- a/gio/gloadableicon.c
+++ b/gio/gloadableicon.c
@@ -30,9 +30,11 @@
 /**
  * SECTION:gloadableicon
  * @short_description: Loadable Icons
+ * @include: gio.h
  * @see_also: #GIcon, #GThemedIcon
  * 
- * Extends the #GIcon interface and adds the ability to load icons from streams.
+ * Extends the #GIcon interface and adds the ability to 
+ * load icons from streams.
  **/
 
 static void          g_loadable_icon_real_load_async  (GLoadableIcon        *icon,

diff --git a/gio/gmemoryinputstream.c b/gio/gmemoryinputstream.c
index 2e113bdab1c53a8e825623f79bd048c672042f8c..87af192f4a4d472f1f9fd2106caf06bfef5d9b7b 100644 (file)
--- a/gio/gmemoryinputstream.c
+++ b/gio/gmemoryinputstream.c
@@ -33,6 +33,7 @@
 /**
  * SECTION:gmemoryinputstream
  * @short_description: Streaming input operations on memory chunks
+ * @include: gio.h
  * @see_also: #GMemoryOutputStream
  *
  * #GMemoryInputStream is a class for using arbitrary

diff --git a/gio/gmemoryoutputstream.c b/gio/gmemoryoutputstream.c
index 2ab5bf591556e28a406455df4f0269135985e749..a1c581141dbb30ca382750ff601f277925859250 100644 (file)
--- a/gio/gmemoryoutputstream.c
+++ b/gio/gmemoryoutputstream.c
@@ -33,6 +33,7 @@
 /**
  * SECTION:gmemoryoutputstream
  * @short_description: Streaming output operations on memory chunks
+ * @include: gio.h
  * @see_also: #GMemoryInputStream
  *
  * #GMemoryOutputStream is a class for using arbitrary

diff --git a/gio/gmount.c b/gio/gmount.c
index 73fb8e677ce5982d8fe9bd9536bdde534420b22b..d1ed537c7879cf32596b2674d3ad4e90b37b1e7a 100644 (file)
--- a/gio/gmount.c
+++ b/gio/gmount.c
@@ -36,11 +36,11 @@
 
 /**
  * SECTION:gmount
- * @short_description: mount management
+ * @short_description: Mount management
+ * @include: gio.h
  * 
- * The #GMount interface represents user-visible mounts. Note, when
- * porting from GnomeVFS, #GMount is the moral equivalent of
- * #GnomeVFSVolume.
+ * The #GMount interface represents user-visible mounts. Note, when 
+ * porting from GnomeVFS, #GMount is the moral equivalent of #GnomeVFSVolume.
  * 
  * Unmounting a #GMount instance is an asynchronous operation. For
  * more information about asynchronous operations, see #GAsyncReady
@@ -51,9 +51,8 @@
  * #GAsyncReady structure will be passed to the callback.  That
  * callback should then call g_mount_unmount_finish() with the #GMount
  * and the #GAsyncReady data to see if the operation was completed
- * successfully.  If an @error is present when
- * g_mount_unmount_finish() is called, then it will be filled with any
- * error information.
+ * successfully.  If an @error is present when g_mount_unmount_finish() 
+ * is called, then it will be filled with any error information.
  **/
 
 static void g_mount_base_init (gpointer g_class);

diff --git a/gio/gmountoperation.c b/gio/gmountoperation.c
index dcf45d735c24332ef8fe13dbbee3e3c7bd143529..f0f9f312e71af1110a0984e950aa84220f3019ef 100644 (file)
--- a/gio/gmountoperation.c
+++ b/gio/gmountoperation.c
@@ -34,16 +34,17 @@
 /** 
  * SECTION:gmountoperation
  * @short_description: Authentication methods for mountable locations
+ * @include: gio.h
  *
  * #GMountOperation provides a mechanism for authenticating mountable 
  * operations, such as loop mounting files, hard drive partitions or 
  * server locations. 
  *
- * Mountin operations are handed a #GMountOperation that then can use if they 
- * require any privileges or authentication for their volumes to be 
- * mounted (e.g. a hard disk partition or an encrypted filesystem), or 
- * if they are implementing a remote server protocol which requires user
- * credentials such as FTP or WebDAV.
+ * Mounting operations are handed a #GMountOperation that then can use 
+ * if they require any privileges or authentication for their volumes 
+ * to be mounted (e.g. a hard disk partition or an encrypted filesystem), 
+ * or if they are implementing a remote server protocol which requires 
+ * user credentials such as FTP or WebDAV.
  *
  * Users should instantiate a subclass of this that implements all
  * the various callbacks to show the required dialogs.

diff --git a/gio/goutputstream.c b/gio/goutputstream.c
index 0f33f02e378d33f7a612680c1d351b293540b8f4..d2640e0a31e3c3e0bcfb2f935d47460aab2673e4 100644 (file)
--- a/gio/goutputstream.c
+++ b/gio/goutputstream.c
@@ -30,7 +30,7 @@
 /**
  * SECTION:goutputstream
  * @short_description: Base class for implementing streaming output
- *
+ * @include: gio.h
  *
  *
  **/

diff --git a/gio/gseekable.c b/gio/gseekable.c
index f8019b7be5087e6f91b3630e3229c4e12bde2ee5..527d9d4c8633bba6dedb7c977a6447aba041e2f6 100644 (file)
--- a/gio/gseekable.c
+++ b/gio/gseekable.c
@@ -29,6 +29,7 @@
 /**
  * SECTION:gseekable
  * @short_description: Stream seeking interface
+ * @include: gio.h
  * @see_also: #GInputStream, #GOutputStream
  * 
  * #GSeekable is implemented by streams (implementations of 

diff --git a/gio/gsimpleasyncresult.c b/gio/gsimpleasyncresult.c
index 9df27efae3196f7c383b9a43ccb100d232c9f7b5..443c3b9eec3c6ce560b7ee616f6b8882fc06a7e5 100644 (file)
--- a/gio/gsimpleasyncresult.c
+++ b/gio/gsimpleasyncresult.c
@@ -41,6 +41,7 @@
 /**
  * SECTION:gsimpleasyncresult
  * @short_description: Simple asynchronous results implementation
+ * @include: gio.h
  * @see_also: #GAsyncResult
  *
  * Implements #GAsyncResult for simple cases. Most of the time, this 
@@ -48,24 +49,25 @@
  * Because of this, #GSimpleAsyncResult is used throughout GIO for 
  * handling asynchronous functions. 
  * 
- * GSimpleAsyncResult handles #GAsyncReadyCallback<!-- -->s, error reporting,
- * operation cancellation and the final state of an operation, completely
- * transparent to the application. Results can be returned as a pointer e.g. 
- * for functions that return data that is collected asynchronously,
- * a boolean value for checking the success or failure of an operation,
- * or a #gssize for operations which return the number of bytes modified 
- * by the operation; all of the simple return cases are covered.
+ * GSimpleAsyncResult handles #GAsyncReadyCallback<!-- -->s, error 
+ * reporting, operation cancellation and the final state of an operation, 
+ * completely transparent to the application. Results can be returned 
+ * as a pointer e.g. for functions that return data that is collected 
+ * asynchronously, a boolean value for checking the success or failure 
+ * of an operation, or a #gssize for operations which return the number 
+ * of bytes modified by the operation; all of the simple return cases 
+ * are covered.
  * 
  * Most of the time, an application will not need to know of the details 
- * of this API; it is handled transparently, and any necessary operations are 
- * handled by #GAsyncResult's interface. However, if implementing a new GIO 
- * module, for writing language bindings, or for complex applications that 
- * need better control of how asynchronous operations are completed, it is 
- * important to understand this functionality.
+ * of this API; it is handled transparently, and any necessary operations 
+ * are handled by #GAsyncResult's interface. However, if implementing a 
+ * new GIO module, for writing language bindings, or for complex 
+ * applications that need better control of how asynchronous operations 
+ * are completed, it is important to understand this functionality.
  * 
- * GSimpleAsyncResults are tagged with the calling function to ensure that 
- * asynchronous functions and their finishing functions are used together 
- * correctly.
+ * GSimpleAsyncResults are tagged with the calling function to ensure 
+ * that asynchronous functions and their finishing functions are used 
+ * together correctly.
  * 
  * To create a new #GSimpleAsyncResult, call g_simple_async_result_new(). 
  * If the result needs to be created for a #GError, use 
@@ -81,8 +83,8 @@
  * calling g_simple_async_result_set_handle_cancellation() with a 
  * #GSimpleAsyncResult for the operation and %FALSE. 
  * 
- * GSimpleAsyncResult can integrate into GLib's Main Event Loop 
- * <!-- TODO: Crosslink -->, or it can use #GThread<!-- -->s if available. 
+ * GSimpleAsyncResult can integrate into GLib's event loop, #GMainLoop, 
+ * or it can use #GThread<!-- -->s if available. 
  * g_simple_async_result_complete() will finish an I/O task directly within 
  * the main event loop. g_simple_async_result_complete_in_idle() will 
  * integrate the I/O task into the main event loop as an idle function and 

diff --git a/gio/gthemedicon.c b/gio/gthemedicon.c
index 9f68df470885f31350d1a34722ee5f04825b87b7..909bc6e3a6ddaeea65a1ef981eaf236d9a681092 100644 (file)
--- a/gio/gthemedicon.c
+++ b/gio/gthemedicon.c
@@ -29,6 +29,7 @@
 /**
  * SECTION:gthemedicon
  * @short_description: Icon theming support
+ * @include: gio.h
  * @see_also: #GIcon, #GLoadableIcon
  *
  * #GThemedIcon is an implementation of #GIcon that supports icon themes.

diff --git a/gio/gunixinputstream.c b/gio/gunixinputstream.c
index 426531b97c83825fd7352a148c3ad5e0d39c0b20..5e4c09028f9f7a95b290feccdd087e95fc6ef172 100644 (file)
--- a/gio/gunixinputstream.c
+++ b/gio/gunixinputstream.c
@@ -44,6 +44,7 @@
 /**
  * SECTION:gunixinputstream
  * @short_description: Streaming input operations for Unix file descriptors
+ * @include: gio/gunixinputstream.h
  * @see_also: #GInputStream
  *
  * #GUnixInputStream implements #GInputStream for reading from a

diff --git a/gio/gunixmounts.c b/gio/gunixmounts.c
index 2d3e0411e8365e600599f71393553dcff336bd58..b9a6f96994cc74dc090efc15fc41e8ae0fcec130 100644 (file)
--- a/gio/gunixmounts.c
+++ b/gio/gunixmounts.c
@@ -57,6 +57,7 @@ static const char *_resolve_dev_root (void);
 
 /**
  * SECTION:gunixmounts
+ * @include: gio/gunixmounts.h
  * @short_description: Unix Mounts
  * 
  * Routines for managing mounted UNIX mount points and paths.

diff --git a/gio/gunixoutputstream.c b/gio/gunixoutputstream.c
index a06de503745389fdd585eb45d142cc5839e51b33..4ae45ccd09d6347ea897bacfde8bbff00508fe71 100644 (file)
--- a/gio/gunixoutputstream.c
+++ b/gio/gunixoutputstream.c
@@ -44,6 +44,7 @@
 /**
  * SECTION:gunixoutputstream
  * @short_description: Streaming output operations for Unix file descriptors
+ * @include: gio/gunixoutputstream.h
  * @see_also: #GOutputStream
  *
  * #GUnixOutputStream implements #GOutputStream for writing to a a

diff --git a/gio/gvfs.c b/gio/gvfs.c
index b171d79c81639bd3f21e8c5fd2580e81aba2c210..783f16ced4cde550cd4f9963e03a9e075c92edc9 100644 (file)
--- a/gio/gvfs.c
+++ b/gio/gvfs.c
@@ -32,7 +32,7 @@
 /**
  * SECTION:gvfs
  * @short_description: Virtual File System 
- * @include: gio/gvfs.h
+ * @include: gio.h
  * 
  * Entry point for using GIO functionality.
  *

diff --git a/gio/gvolume.c b/gio/gvolume.c
index 75304e29c4fc628a8211748da3c0214e9b6b8198..501e770ebf0eb840a8e1f9692fc7caa1052bef21 100644 (file)
--- a/gio/gvolume.c
+++ b/gio/gvolume.c
@@ -30,8 +30,9 @@
 #include "gioalias.h"
 
 /**
- * SECTION:volume
- * @short_description: volume management
+ * SECTION:gvolume
+ * @short_description: Volume management
+ * @include: gio.h
  * 
  * The #GVolume interface represents user-visible objects that can be
  * mounted. Note, when porting from GnomeVFS, #GVolume is the moral

diff --git a/gio/gvolumemonitor.c b/gio/gvolumemonitor.c
index 4fe574a7adaded78ac61c45868f3aa7bf8ef10a1..3c4ff63eb51dabfd6e8113dc6ad59a7da304f2f6 100644 (file)
--- a/gio/gvolumemonitor.c
+++ b/gio/gvolumemonitor.c
@@ -30,6 +30,7 @@
 /**
  * SECTION:gvolumemonitor
  * @short_description: Volume Monitor
+ * @include: gio.h
  * @see_also: #GDirectoryMonitor, #GFileMonitor
  * 
  * Monitors a mounted volume for changes.