From ff068af4171f7959d0a553dc6653f6f3ec882137 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sun, 6 Jan 2008 08:04:39 +0000 Subject: [PATCH] Documentation additions svn path=/trunk/; revision=6247 --- gio/ChangeLog | 7 +++++++ gio/gdesktopappinfo.c | 2 +- gio/gfileattribute.c | 22 ++++++++++++++++++++++ gio/gfileinfo.h | 3 ++- 4 files changed, 32 insertions(+), 2 deletions(-) diff --git a/gio/ChangeLog b/gio/ChangeLog index 0faed7a3f..7ad775b36 100644 --- a/gio/ChangeLog +++ b/gio/ChangeLog @@ -1,3 +1,10 @@ +2008-01-06 Matthias Clasen + + * gdesktopappinfo.c: Fix a docs typo. + + * gfileattribute.c: Add information about extended attributes + to the documentation. (#505058) + 2008-01-04 Alexander Larsson * gio-marshal.list: diff --git a/gio/gdesktopappinfo.c b/gio/gdesktopappinfo.c index 33bfa91a0..1f04ef4b6 100644 --- a/gio/gdesktopappinfo.c +++ b/gio/gdesktopappinfo.c @@ -1740,7 +1740,7 @@ get_apps_from_dir (GHashTable *apps, * on this system. * * For desktop files, this includes applications that have - * NoDisplay=true set or are excluded from + * NoDisplay=true set or are excluded from * display by means of OnlyShowIn or * NotShowIn. See g_app_info_should_show(). * The returned list does not include applications which have diff --git a/gio/gfileattribute.c b/gio/gfileattribute.c index 07b284fb8..cb6677baf 100644 --- a/gio/gfileattribute.c +++ b/gio/gfileattribute.c @@ -106,6 +106,19 @@ * space is left available, and the overall size of the file system. * "gvfs"The "GVFS" namespace. Keys in this namespace * contain information about the current GVFS backend in use. + * "xattr"The "xattr" namespace. Gets information + * about extended user attributes. See attr(5). The "user." prefix of the + * extended user attribute name is stripped away when constructing keys in + * this namespace, e.g. "xattr::mime_type" for the extended attribute with + * the name "user.mime_type". Note that this information is only available + * if GLib has been built with extended attribute support. + * "xattr-sys"The "xattr-sys" namespace. + * Gets information about extended attributes which are not user-specific. + * See attr(5). Note that this information is only available if GLib + * has been built with extended attribute support. + * "selinux"The "SELinux" namespace. Includes + * information about the SELinux context of files. Note that this information + * is only available if GLib has been built with SELinux support. * * * @@ -182,8 +195,17 @@ * %G_FILE_ATTRIBUTE_FILESYSTEM_TYPEfilesystem::typestring * %G_FILE_ATTRIBUTE_FILESYSTEM_READONLYfilesystem::readonlyboolean * %G_FILE_ATTRIBUTE_GVFS_BACKENDgvfs::backendstring + * %G_FILE_ATTRIBUTE_SELINUX_CONTEXTselinux::contextstring * * + * Note that there are no predefined keys in the "xattr" and "xattr-sys" + * namespaces. Keys for the "xattr" namespace are constructed by stripping + * away the "user." prefix from the extended user attribute, and prepending + * "xattr::". Keys for the "xattr-sys" namespace are constructed by + * concatenating "xattr-sys::" with the extended attribute name. All extended + * attribute values are returned as hex-encoded strings in which bytes outside + * the ASCII range are encoded as hexadecimal escape sequences of the form + * \xnn. **/ /* diff --git a/gio/gfileinfo.h b/gio/gfileinfo.h index 5840197f0..8ca93de2d 100644 --- a/gio/gfileinfo.h +++ b/gio/gfileinfo.h @@ -658,7 +658,8 @@ typedef enum { /** * G_FILE_ATTRIBUTE_FILESYSTEM_READONLY: - * * A key in the "filesystem" namespace for checking if the file system + * + * A key in the "filesystem" namespace for checking if the file system * is read only. Is set to %TRUE if the file system is read only. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/