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
This commit is contained in:
Murray Cumming
2008-01-11 14:15:07 +00:00
committed by Murray Cumming
parent b07304fd89
commit 30d6124e8a
2 changed files with 16 additions and 0 deletions

View File

@@ -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.
**/