From 227ef243b14c252bf1f3d7fa1dcd00bcf4f2ef84 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Mon, 31 Dec 2007 04:45:19 +0000
Subject: [PATCH] Doc additions

svn path=/trunk/; revision=6220
---
 gio/ChangeLog   |  4 ++++
 gio/gfileinfo.c | 11 ++++++++++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/gio/ChangeLog b/gio/ChangeLog
index 34ed45bed..b447dc404 100644
--- a/gio/ChangeLog
+++ b/gio/ChangeLog
@@ -1,3 +1,7 @@
+2007-12-30  Matthias Clasen  <mclasen@redhat.com> 
+
+	* gfileinfo.c: Expand the long description.
+
 2007-12-30  Matthias Clasen  <mclasen@redhat.com> 
 
 	* fam/Makefile.am:
diff --git a/gio/gfileinfo.c b/gio/gfileinfo.c
index c2592ddfb..c1f0081f2 100644
--- a/gio/gfileinfo.c
+++ b/gio/gfileinfo.c
@@ -24,11 +24,20 @@
  * SECTION:gfileinfo
  * @short_description: File Information and Attributes
  * @include: gio.h
- * @see_also: #GFile
+ * @see_also: #GFile, <link linkend="gio-GFileAttribute">GFileAttribute</link>
  * 
  * Functionality for manipulating basic metadata for files. #GFileInfo
  * implements methods for getting information that all files should 
  * contain, and allows for manipulation of extended attributes. 
+ *
+ * See <link linkend="gio-GFileAttribute">GFileAttribute</link> for more
+ * information on how GIO handles file attributes.
+ *
+ * To obtain a #GFileInfo for a #GFile, use g_file_query_info() (or its 
+ * async variant). To obtain a #GFileInfo for a file input or output 
+ * stream, use g_file_input_stream_query_info() or 
+ * g_file_output_stream_query_info() (or their async variants).
+ *
  * #GFileAttributeMatcher allows for searching through a #GFileInfo for 
  * attributes.
  **/