Document how to unset attributes
authorHolger Berndt <hb@gnome.org>
Thu, 3 Jun 2010 01:22:36 +0000 (03:22 +0200)
committerHolger Berndt <hb@gnome.org>
Tue, 19 Jul 2011 20:52:56 +0000 (22:52 +0200)
Unsetting won't work on all attributes. Currently, only
metadata attributes are supported.

https://bugzilla.gnome.org/show_bug.cgi?id=620423

gio/gfile.c

index a5d00fe..c67dab9 100644 (file)
@@ -3828,6 +3828,9 @@ g_file_query_writable_namespaces (GFile         *file,
  * @error: a #GError, or %NULL
  * 
  * Sets an attribute in the file with attribute name @attribute to @value.
+ *
+ * Some attributes can be unset by setting @attribute to
+ * %G_FILE_ATTRIBUTE_TYPE_INVALID and @value to %NULL.
  * 
  * If @cancellable is not %NULL, then the operation can be cancelled by
  * triggering the cancellable object from another thread. If the operation