GFileInfo description: Mention how to actually set attributes in a GFile

2008-01-10  Murray Cumming  <murrayc@murrayc.com>

        * gfileinfo.c: GFileInfo description: Mention
        how to actually set attributes in a GFile and how to discover
        which attributes are settable. Bug #508378.

svn path=/trunk/; revision=6293

diff --git a/gio/ChangeLog b/gio/ChangeLog
index 7b2cb3ff89c8bc83fc09979e7112b1d8be239a5c..47ce8af4f7442f1dead384c79f358e347c94f37b 100644 (file)
--- a/gio/ChangeLog
+++ b/gio/ChangeLog
@@ -1,3 +1,9 @@
+2008-01-10  Murray Cumming  <murrayc@murrayc.com>
+
+       * gfileinfo.c: GFileInfo description: Mention 
+       how to actually set attributes in a GFile and how to discover 
+       which attributes are settable. Bug #508378.
+
 2008-01-10  A. Walton  <awalton@svn.gnome.org>
 
        * gdesktopappinfo.c: (g_app_info_get_all_for_type),

diff --git a/gio/gfileinfo.c b/gio/gfileinfo.c
index b2748083a30b84aaede336973fc002066e884835..1b62949734b13572b4d4953b3fe2f1d5d7cdeb0f 100644 (file)
--- a/gio/gfileinfo.c
+++ b/gio/gfileinfo.c
@@ -38,6 +38,16 @@
  * stream, use g_file_input_stream_query_info() or 
  * g_file_output_stream_query_info() (or their async variants).
  *
+ * To change the actual attributes of a file, you should then set the 
+ * attribute in the #GFileInfo and call g_file_set_attributes_from_info() 
+ * or g_file_set_attributes_async() on a GFile.
+ *
+ * However, not all attributes can be changed in the file. For instance, 
+ * the actual size of a file cannot be changed via g_file_info_set_size(). 
+ * You may call g_file_query_settable_attributes() and 
+ * g_file_query_writable_namespaces() to discover the settable attributes 
+ * of a particular file at runtime.
+ *
  * #GFileAttributeMatcher allows for searching through a #GFileInfo for 
  * attributes.
  **/