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 7b2cb3f..47ce8af 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 b274808..1b62949 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.
  **/