From: Murray Cumming Date: Fri, 11 Jan 2008 14:15:07 +0000 (+0000) Subject: GFileInfo description: Mention how to actually set attributes in a GFile X-Git-Tag: GLIB_2_15_2~17 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=30d6124e8a1ec2e6cec2cb56456c62227bf0c428;p=platform%2Fupstream%2Fglib.git GFileInfo description: Mention how to actually set attributes in a GFile 2008-01-10 Murray Cumming * 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 --- a/gio/ChangeLog +++ b/gio/ChangeLog @@ -1,3 +1,9 @@ +2008-01-10 Murray Cumming + + * 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 * gdesktopappinfo.c: (g_app_info_get_all_for_type), diff --git a/gio/gfileinfo.c b/gio/gfileinfo.c index b274808..1b62949 100644 --- 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. **/