docs: Break GFileAttribute descriptions into paragraph

Keep the first paragraph short, to act as a summary.
This commit is contained in:
Emmanuele Bassi 2021-08-02 16:21:37 +01:00
parent bed2da6cc2
commit 24a0c3a940

View File

@ -49,7 +49,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_TYPE: * G_FILE_ATTRIBUTE_STANDARD_TYPE:
* *
* A key in the "standard" namespace for storing file types. * A key in the "standard" namespace for storing file types.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
*
* The value for this key should contain a #GFileType. * The value for this key should contain a #GFileType.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_TYPE "standard::type" /* uint32 (GFileType) */ #define G_FILE_ATTRIBUTE_STANDARD_TYPE "standard::type" /* uint32 (GFileType) */
@ -58,6 +60,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN: * G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN:
* *
* A key in the "standard" namespace for checking if a file is hidden. * A key in the "standard" namespace for checking if a file is hidden.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN "standard::is-hidden" /* boolean */ #define G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN "standard::is-hidden" /* boolean */
@ -66,6 +69,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP: * G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP:
* *
* A key in the "standard" namespace for checking if a file is a backup file. * A key in the "standard" namespace for checking if a file is a backup file.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP "standard::is-backup" /* boolean */ #define G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP "standard::is-backup" /* boolean */
@ -76,7 +80,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* A key in the "standard" namespace for checking if the file is a symlink. * A key in the "standard" namespace for checking if the file is a symlink.
* Typically the actual type is something else, if we followed the symlink * Typically the actual type is something else, if we followed the symlink
* to get the type. * to get the type.
*
* On Windows NTFS mountpoints are considered to be symlinks as well. * On Windows NTFS mountpoints are considered to be symlinks as well.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK "standard::is-symlink" /* boolean */ #define G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK "standard::is-symlink" /* boolean */
@ -85,6 +91,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL: * G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL:
* *
* A key in the "standard" namespace for checking if a file is virtual. * A key in the "standard" namespace for checking if a file is virtual.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL "standard::is-virtual" /* boolean */ #define G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL "standard::is-virtual" /* boolean */
@ -95,7 +102,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* A key in the "standard" namespace for checking if a file is * A key in the "standard" namespace for checking if a file is
* volatile. This is meant for opaque, non-POSIX-like backends to * volatile. This is meant for opaque, non-POSIX-like backends to
* indicate that the URI is not persistent. Applications should look * indicate that the URI is not persistent. Applications should look
* at #G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET for the persistent URI. * at %G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET for the persistent URI.
* *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
* *
@ -107,11 +114,14 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_NAME: * G_FILE_ATTRIBUTE_STANDARD_NAME:
* *
* A key in the "standard" namespace for getting the name of the file. * A key in the "standard" namespace for getting the name of the file.
*
* The name is the on-disk filename which may not be in any known encoding, * The name is the on-disk filename which may not be in any known encoding,
* and can thus not be generally displayed as is. It is guaranteed to be set on * and can thus not be generally displayed as is. It is guaranteed to be set on
* every file. * every file.
* Use #G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME if you need to display the *
* Use %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME if you need to display the
* name in a user interface. * name in a user interface.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_NAME "standard::name" /* byte string */ #define G_FILE_ATTRIBUTE_STANDARD_NAME "standard::name" /* byte string */
@ -120,8 +130,10 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME: * G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME:
* *
* A key in the "standard" namespace for getting the display name of the file. * A key in the "standard" namespace for getting the display name of the file.
*
* A display name is guaranteed to be in UTF-8 and can thus be displayed in * A display name is guaranteed to be in UTF-8 and can thus be displayed in
* the UI. It is guaranteed to be set on every file. * the UI. It is guaranteed to be set on every file.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME "standard::display-name" /* string */ #define G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME "standard::display-name" /* string */
@ -130,6 +142,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME: * G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME:
* *
* A key in the "standard" namespace for edit name of the file. * A key in the "standard" namespace for edit name of the file.
*
* An edit name is similar to the display name, but it is meant to be * An edit name is similar to the display name, but it is meant to be
* used when you want to rename the file in the UI. The display name * used when you want to rename the file in the UI. The display name
* might contain information you don't want in the new filename (such as * might contain information you don't want in the new filename (such as
@ -143,6 +156,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_COPY_NAME: * G_FILE_ATTRIBUTE_STANDARD_COPY_NAME:
* *
* A key in the "standard" namespace for getting the copy name of the file. * A key in the "standard" namespace for getting the copy name of the file.
*
* The copy name is an optional version of the name. If available it's always * The copy name is an optional version of the name. If available it's always
* in UTF8, and corresponds directly to the original filename (only transcoded to * in UTF8, and corresponds directly to the original filename (only transcoded to
* UTF8). This is useful if you want to copy the file to another filesystem that * UTF8). This is useful if you want to copy the file to another filesystem that
@ -157,6 +171,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION: * G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION:
* *
* A key in the "standard" namespace for getting the description of the file. * A key in the "standard" namespace for getting the description of the file.
*
* The description is a utf8 string that describes the file, generally containing * The description is a utf8 string that describes the file, generally containing
* the filename, but can also contain further information. Example descriptions * the filename, but can also contain further information. Example descriptions
* could be "filename (on hostname)" for a remote file or "filename (in trash)" * could be "filename (on hostname)" for a remote file or "filename (in trash)"
@ -171,7 +186,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_ICON: * G_FILE_ATTRIBUTE_STANDARD_ICON:
* *
* A key in the "standard" namespace for getting the icon for the file. * A key in the "standard" namespace for getting the icon for the file.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
*
* The value for this key should contain a #GIcon. * The value for this key should contain a #GIcon.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_ICON "standard::icon" /* object (GIcon) */ #define G_FILE_ATTRIBUTE_STANDARD_ICON "standard::icon" /* object (GIcon) */
@ -180,7 +197,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON: * G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON:
* *
* A key in the "standard" namespace for getting the symbolic icon for the file. * A key in the "standard" namespace for getting the symbolic icon for the file.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
*
* The value for this key should contain a #GIcon. * The value for this key should contain a #GIcon.
* *
* Since: 2.34 * Since: 2.34
@ -191,7 +210,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE: * G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE:
* *
* A key in the "standard" namespace for getting the content type of the file. * A key in the "standard" namespace for getting the content type of the file.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
*
* The value for this key should contain a valid content type. * The value for this key should contain a valid content type.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE "standard::content-type" /* string */ #define G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE "standard::content-type" /* string */
@ -200,9 +221,11 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE: * G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE:
* *
* A key in the "standard" namespace for getting the fast content type. * A key in the "standard" namespace for getting the fast content type.
*
* The fast content type isn't as reliable as the regular one, as it * The fast content type isn't as reliable as the regular one, as it
* only uses the filename to guess it, but it is faster to calculate than the * only uses the filename to guess it, but it is faster to calculate than the
* regular content type. * regular content type.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
* *
**/ **/
@ -212,6 +235,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_SIZE: * G_FILE_ATTRIBUTE_STANDARD_SIZE:
* *
* A key in the "standard" namespace for getting the file's size (in bytes). * A key in the "standard" namespace for getting the file's size (in bytes).
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_SIZE "standard::size" /* uint64 */ #define G_FILE_ATTRIBUTE_STANDARD_SIZE "standard::size" /* uint64 */
@ -220,9 +244,11 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE: * G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE:
* *
* A key in the "standard" namespace for getting the amount of disk space * A key in the "standard" namespace for getting the amount of disk space
* that is consumed by the file (in bytes). This will generally be larger * that is consumed by the file (in bytes).
* than the file size (due to block size overhead) but can occasionally be *
* smaller (for example, for sparse files). * This will generally be larger than the file size (due to block size
* overhead) but can occasionally be smaller (for example, for sparse files).
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
* *
* Since: 2.20 * Since: 2.20
@ -233,8 +259,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET: * G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET:
* *
* A key in the "standard" namespace for getting the symlink target, if the file * A key in the "standard" namespace for getting the symlink target, if the file
* is a symlink. Corresponding #GFileAttributeType is * is a symlink.
* %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET "standard::symlink-target" /* byte string */ #define G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET "standard::symlink-target" /* byte string */
@ -243,6 +270,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* *
* A key in the "standard" namespace for getting the target URI for the file, in * A key in the "standard" namespace for getting the target URI for the file, in
* the case of %G_FILE_TYPE_SHORTCUT or %G_FILE_TYPE_MOUNTABLE files. * the case of %G_FILE_TYPE_SHORTCUT or %G_FILE_TYPE_MOUNTABLE files.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_STANDARD_TARGET_URI "standard::target-uri" /* string */ #define G_FILE_ATTRIBUTE_STANDARD_TARGET_URI "standard::target-uri" /* string */
@ -251,7 +279,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER: * G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER:
* *
* A key in the "standard" namespace for setting the sort order of a file. * A key in the "standard" namespace for setting the sort order of a file.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_INT32. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_INT32.
*
* An example use would be in file managers, which would use this key * An example use would be in file managers, which would use this key
* to set the order files are displayed. Files with smaller sort order * to set the order files are displayed. Files with smaller sort order
* should be sorted first, and files without sort order as if sort order * should be sorted first, and files without sort order as if sort order
@ -265,8 +295,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_ETAG_VALUE: * G_FILE_ATTRIBUTE_ETAG_VALUE:
* *
* A key in the "etag" namespace for getting the value of the file's * A key in the "etag" namespace for getting the value of the file's
* entity tag. Corresponding #GFileAttributeType is * entity tag.
* %G_FILE_ATTRIBUTE_TYPE_STRING. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_ETAG_VALUE "etag::value" /* string */ #define G_FILE_ATTRIBUTE_ETAG_VALUE "etag::value" /* string */
@ -278,7 +309,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_ID_FILE: * G_FILE_ATTRIBUTE_ID_FILE:
* *
* A key in the "id" namespace for getting a file identifier. * A key in the "id" namespace for getting a file identifier.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
*
* An example use would be during listing files, to avoid recursive * An example use would be during listing files, to avoid recursive
* directory scanning. * directory scanning.
**/ **/
@ -288,7 +321,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_ID_FILESYSTEM: * G_FILE_ATTRIBUTE_ID_FILESYSTEM:
* *
* A key in the "id" namespace for getting the file system identifier. * A key in the "id" namespace for getting the file system identifier.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
*
* An example use would be during drag and drop to see if the source * An example use would be during drag and drop to see if the source
* and target are on the same filesystem (default to move) or not (default * and target are on the same filesystem (default to move) or not (default
* to copy). * to copy).
@ -301,7 +336,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_ACCESS_CAN_READ: * G_FILE_ATTRIBUTE_ACCESS_CAN_READ:
* *
* A key in the "access" namespace for getting read privileges. * A key in the "access" namespace for getting read privileges.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
*
* This attribute will be %TRUE if the user is able to read the file. * This attribute will be %TRUE if the user is able to read the file.
**/ **/
#define G_FILE_ATTRIBUTE_ACCESS_CAN_READ "access::can-read" /* boolean */ #define G_FILE_ATTRIBUTE_ACCESS_CAN_READ "access::can-read" /* boolean */
@ -310,7 +347,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE: * G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE:
* *
* A key in the "access" namespace for getting write privileges. * A key in the "access" namespace for getting write privileges.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
*
* This attribute will be %TRUE if the user is able to write to the file. * This attribute will be %TRUE if the user is able to write to the file.
**/ **/
#define G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE "access::can-write" /* boolean */ #define G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE "access::can-write" /* boolean */
@ -319,7 +358,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE: * G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE:
* *
* A key in the "access" namespace for getting execution privileges. * A key in the "access" namespace for getting execution privileges.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
*
* This attribute will be %TRUE if the user is able to execute the file. * This attribute will be %TRUE if the user is able to execute the file.
**/ **/
#define G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE "access::can-execute" /* boolean */ #define G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE "access::can-execute" /* boolean */
@ -328,7 +369,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE: * G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE:
* *
* A key in the "access" namespace for checking deletion privileges. * A key in the "access" namespace for checking deletion privileges.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
*
* This attribute will be %TRUE if the user is able to delete the file. * This attribute will be %TRUE if the user is able to delete the file.
**/ **/
#define G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE "access::can-delete" /* boolean */ #define G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE "access::can-delete" /* boolean */
@ -337,7 +380,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH: * G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH:
* *
* A key in the "access" namespace for checking trashing privileges. * A key in the "access" namespace for checking trashing privileges.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
*
* This attribute will be %TRUE if the user is able to move the file to * This attribute will be %TRUE if the user is able to move the file to
* the trash. * the trash.
**/ **/
@ -347,7 +392,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME: * G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME:
* *
* A key in the "access" namespace for checking renaming privileges. * A key in the "access" namespace for checking renaming privileges.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
*
* This attribute will be %TRUE if the user is able to rename the file. * This attribute will be %TRUE if the user is able to rename the file.
**/ **/
#define G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME "access::can-rename" /* boolean */ #define G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME "access::can-rename" /* boolean */
@ -359,7 +406,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
/** /**
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT: * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT:
* *
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is mountable. * A key in the "mountable" namespace for checking if a file (of
* type G_FILE_TYPE_MOUNTABLE) is mountable.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT "mountable::can-mount" /* boolean */ #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT "mountable::can-mount" /* boolean */
@ -367,7 +416,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
/** /**
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT: * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT:
* *
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is unmountable. * A key in the "mountable" namespace for checking if a file (of
* type G_FILE_TYPE_MOUNTABLE) is unmountable.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT "mountable::can-unmount" /* boolean */ #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT "mountable::can-unmount" /* boolean */
@ -375,7 +426,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
/** /**
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT: * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT:
* *
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be ejected. * A key in the "mountable" namespace for checking if a file (of
* type G_FILE_TYPE_MOUNTABLE) can be ejected.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT "mountable::can-eject" /* boolean */ #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT "mountable::can-eject" /* boolean */
@ -384,6 +437,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE: * G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE:
* *
* A key in the "mountable" namespace for getting the unix device. * A key in the "mountable" namespace for getting the unix device.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE "mountable::unix-device" /* uint32 */ #define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE "mountable::unix-device" /* uint32 */
@ -392,6 +446,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE: * G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE:
* *
* A key in the "mountable" namespace for getting the unix device file. * A key in the "mountable" namespace for getting the unix device file.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
* *
* Since: 2.22 * Since: 2.22
@ -402,14 +457,18 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI: * G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI:
* *
* A key in the "mountable" namespace for getting the HAL UDI for the mountable * A key in the "mountable" namespace for getting the HAL UDI for the mountable
* file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * file.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI "mountable::hal-udi" /* string */ #define G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI "mountable::hal-udi" /* string */
/** /**
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START: * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START:
* *
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started. * A key in the "mountable" namespace for checking if a file (of
* type G_FILE_TYPE_MOUNTABLE) can be started.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
* *
* Since: 2.22 * Since: 2.22
@ -419,8 +478,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
/** /**
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED: * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED:
* *
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started * A key in the "mountable" namespace for checking if a file (of
* degraded. * type G_FILE_TYPE_MOUNTABLE) can be started degraded.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
* *
* Since: 2.22 * Since: 2.22
@ -430,7 +490,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
/** /**
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP: * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP:
* *
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be stopped. * A key in the "mountable" namespace for checking if a file (of
* type G_FILE_TYPE_MOUNTABLE) can be stopped.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
* *
* Since: 2.22 * Since: 2.22
@ -441,6 +503,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE: * G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE:
* *
* A key in the "mountable" namespace for getting the #GDriveStartStopType. * A key in the "mountable" namespace for getting the #GDriveStartStopType.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
* *
* Since: 2.22 * Since: 2.22
@ -450,7 +513,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
/** /**
* G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL: * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL:
* *
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be polled. * A key in the "mountable" namespace for checking if a file (of
* type G_FILE_TYPE_MOUNTABLE) can be polled.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
* *
* Since: 2.22 * Since: 2.22
@ -460,8 +525,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
/** /**
* G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC: * G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC:
* *
* A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) * A key in the "mountable" namespace for checking if a file (of
* is automatically polled for media. * type G_FILE_TYPE_MOUNTABLE) is automatically polled for media.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
* *
* Since: 2.22 * Since: 2.22
@ -474,9 +540,11 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_TIME_MODIFIED: * G_FILE_ATTRIBUTE_TIME_MODIFIED:
* *
* A key in the "time" namespace for getting the time the file was last * A key in the "time" namespace for getting the time the file was last
* modified. Corresponding #GFileAttributeType is * modified.
* %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the *
* file was modified, in seconds since the UNIX epoch. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64, and
* contains the time since the file was modified, in seconds since the UNIX
* epoch.
**/ **/
#define G_FILE_ATTRIBUTE_TIME_MODIFIED "time::modified" /* uint64 */ #define G_FILE_ATTRIBUTE_TIME_MODIFIED "time::modified" /* uint64 */
@ -484,9 +552,11 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC: * G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC:
* *
* A key in the "time" namespace for getting the microseconds of the time * A key in the "time" namespace for getting the microseconds of the time
* the file was last modified. This should be used in conjunction with * the file was last modified.
* #G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is *
* %G_FILE_ATTRIBUTE_TYPE_UINT32. * This should be used in conjunction with %G_FILE_ATTRIBUTE_TIME_MODIFIED.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC "time::modified-usec" /* uint32 */ #define G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC "time::modified-usec" /* uint32 */
@ -494,9 +564,11 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_TIME_ACCESS: * G_FILE_ATTRIBUTE_TIME_ACCESS:
* *
* A key in the "time" namespace for getting the time the file was last * A key in the "time" namespace for getting the time the file was last
* accessed. Corresponding #GFileAttributeType is * accessed.
* %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the *
* file was last accessed, in seconds since the UNIX epoch. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64, and
* contains the time since the file was last accessed, in seconds since the
* UNIX epoch.
**/ **/
#define G_FILE_ATTRIBUTE_TIME_ACCESS "time::access" /* uint64 */ #define G_FILE_ATTRIBUTE_TIME_ACCESS "time::access" /* uint64 */
@ -504,9 +576,11 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_TIME_ACCESS_USEC: * G_FILE_ATTRIBUTE_TIME_ACCESS_USEC:
* *
* A key in the "time" namespace for getting the microseconds of the time * A key in the "time" namespace for getting the microseconds of the time
* the file was last accessed. This should be used in conjunction with * the file was last accessed.
* #G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is *
* %G_FILE_ATTRIBUTE_TYPE_UINT32. * This should be used in conjunction with %G_FILE_ATTRIBUTE_TIME_ACCESS.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_TIME_ACCESS_USEC "time::access-usec" /* uint32 */ #define G_FILE_ATTRIBUTE_TIME_ACCESS_USEC "time::access-usec" /* uint32 */
@ -514,9 +588,11 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_TIME_CHANGED: * G_FILE_ATTRIBUTE_TIME_CHANGED:
* *
* A key in the "time" namespace for getting the time the file was last * A key in the "time" namespace for getting the time the file was last
* changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64, * changed.
* and contains the time since the file was last changed, in seconds since the *
* UNIX epoch. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
* and contains the time since the file was last changed, in seconds since
* the UNIX epoch.
* *
* This corresponds to the traditional UNIX ctime. * This corresponds to the traditional UNIX ctime.
**/ **/
@ -526,9 +602,11 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_TIME_CHANGED_USEC: * G_FILE_ATTRIBUTE_TIME_CHANGED_USEC:
* *
* A key in the "time" namespace for getting the microseconds of the time * A key in the "time" namespace for getting the microseconds of the time
* the file was last changed. This should be used in conjunction with * the file was last changed.
* #G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is *
* %G_FILE_ATTRIBUTE_TYPE_UINT32. * This should be used in conjunction with %G_FILE_ATTRIBUTE_TIME_CHANGED.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_TIME_CHANGED_USEC "time::changed-usec" /* uint32 */ #define G_FILE_ATTRIBUTE_TIME_CHANGED_USEC "time::changed-usec" /* uint32 */
@ -536,12 +614,13 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_TIME_CREATED: * G_FILE_ATTRIBUTE_TIME_CREATED:
* *
* A key in the "time" namespace for getting the time the file was created. * A key in the "time" namespace for getting the time the file was created.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64, * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
* and contains the time since the file was created, in seconds since the UNIX * and contains the time since the file was created, in seconds since the UNIX
* epoch. * epoch.
* *
* This may correspond to Linux stx_btime, FreeBSD st_birthtim, NetBSD * This may correspond to Linux `stx_btime`, FreeBSD `st_birthtim`, NetBSD
* st_birthtime or NTFS ctime. * `st_birthtime` or NTFS `ctime`.
**/ **/
#define G_FILE_ATTRIBUTE_TIME_CREATED "time::created" /* uint64 */ #define G_FILE_ATTRIBUTE_TIME_CREATED "time::created" /* uint64 */
@ -549,9 +628,11 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_TIME_CREATED_USEC: * G_FILE_ATTRIBUTE_TIME_CREATED_USEC:
* *
* A key in the "time" namespace for getting the microseconds of the time * A key in the "time" namespace for getting the microseconds of the time
* the file was created. This should be used in conjunction with * the file was created.
* #G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is *
* %G_FILE_ATTRIBUTE_TYPE_UINT32. * This should be used in conjunction with %G_FILE_ATTRIBUTE_TIME_CREATED.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_TIME_CREATED_USEC "time::created-usec" /* uint32 */ #define G_FILE_ATTRIBUTE_TIME_CREATED_USEC "time::created-usec" /* uint32 */
@ -561,9 +642,11 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_UNIX_DEVICE: * G_FILE_ATTRIBUTE_UNIX_DEVICE:
* *
* A key in the "unix" namespace for getting the device id of the device the * A key in the "unix" namespace for getting the device id of the device the
* file is located on (see stat() documentation). This attribute is only * file is located on (see stat() documentation).
* available for UNIX file systems. Corresponding #GFileAttributeType is *
* %G_FILE_ATTRIBUTE_TYPE_UINT32. * This attribute is only available for UNIX file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_UNIX_DEVICE "unix::device" /* uint32 */ #define G_FILE_ATTRIBUTE_UNIX_DEVICE "unix::device" /* uint32 */
@ -571,8 +654,10 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_UNIX_INODE: * G_FILE_ATTRIBUTE_UNIX_INODE:
* *
* A key in the "unix" namespace for getting the inode of the file. * A key in the "unix" namespace for getting the inode of the file.
* This attribute is only available for UNIX file systems. Corresponding *
* #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. * This attribute is only available for UNIX file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
**/ **/
#define G_FILE_ATTRIBUTE_UNIX_INODE "unix::inode" /* uint64 */ #define G_FILE_ATTRIBUTE_UNIX_INODE "unix::inode" /* uint64 */
@ -580,10 +665,14 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_UNIX_MODE: * G_FILE_ATTRIBUTE_UNIX_MODE:
* *
* A key in the "unix" namespace for getting the mode of the file * A key in the "unix" namespace for getting the mode of the file
* (e.g. whether the file is a regular file, symlink, etc). See the * (e.g. whether the file is a regular file, symlink, etc).
* documentation for `lstat()`: this attribute is equivalent to the `st_mode` *
* member of `struct stat`, and includes both the file type and permissions. * See the documentation for `lstat()`: this attribute is equivalent to
* the `st_mode` member of `struct stat`, and includes both the file type
* and permissions.
*
* This attribute is only available for UNIX file systems. * This attribute is only available for UNIX file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_UNIX_MODE "unix::mode" /* uint32 */ #define G_FILE_ATTRIBUTE_UNIX_MODE "unix::mode" /* uint32 */
@ -592,9 +681,13 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_UNIX_NLINK: * G_FILE_ATTRIBUTE_UNIX_NLINK:
* *
* A key in the "unix" namespace for getting the number of hard links * A key in the "unix" namespace for getting the number of hard links
* for a file. See lstat() documentation. This attribute is only available * for a file.
* for UNIX file systems. Corresponding #GFileAttributeType is *
* %G_FILE_ATTRIBUTE_TYPE_UINT32. * See the documentation for `lstat()`.
*
* This attribute is only available for UNIX file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_UNIX_NLINK "unix::nlink" /* uint32 */ #define G_FILE_ATTRIBUTE_UNIX_NLINK "unix::nlink" /* uint32 */
@ -602,7 +695,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_UNIX_UID: * G_FILE_ATTRIBUTE_UNIX_UID:
* *
* A key in the "unix" namespace for getting the user ID for the file. * A key in the "unix" namespace for getting the user ID for the file.
*
* This attribute is only available for UNIX file systems. * This attribute is only available for UNIX file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_UNIX_UID "unix::uid" /* uint32 */ #define G_FILE_ATTRIBUTE_UNIX_UID "unix::uid" /* uint32 */
@ -611,7 +706,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_UNIX_GID: * G_FILE_ATTRIBUTE_UNIX_GID:
* *
* A key in the "unix" namespace for getting the group ID for the file. * A key in the "unix" namespace for getting the group ID for the file.
*
* This attribute is only available for UNIX file systems. * This attribute is only available for UNIX file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_UNIX_GID "unix::gid" /* uint32 */ #define G_FILE_ATTRIBUTE_UNIX_GID "unix::gid" /* uint32 */
@ -620,9 +717,13 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_UNIX_RDEV: * G_FILE_ATTRIBUTE_UNIX_RDEV:
* *
* A key in the "unix" namespace for getting the device ID for the file * A key in the "unix" namespace for getting the device ID for the file
* (if it is a special file). See lstat() documentation. This attribute * (if it is a special file).
* is only available for UNIX file systems. Corresponding #GFileAttributeType *
* is %G_FILE_ATTRIBUTE_TYPE_UINT32. * See the documentation for `lstat()`.
*
* This attribute is only available for UNIX file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_UNIX_RDEV "unix::rdev" /* uint32 */ #define G_FILE_ATTRIBUTE_UNIX_RDEV "unix::rdev" /* uint32 */
@ -630,7 +731,10 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE: * G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE:
* *
* A key in the "unix" namespace for getting the block size for the file * A key in the "unix" namespace for getting the block size for the file
* system. This attribute is only available for UNIX file systems. * system.
*
* This attribute is only available for UNIX file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE "unix::block-size" /* uint32 */ #define G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE "unix::block-size" /* uint32 */
@ -639,7 +743,10 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_UNIX_BLOCKS: * G_FILE_ATTRIBUTE_UNIX_BLOCKS:
* *
* A key in the "unix" namespace for getting the number of blocks allocated * A key in the "unix" namespace for getting the number of blocks allocated
* for the file. This attribute is only available for UNIX file systems. * for the file.
*
* This attribute is only available for UNIX file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
**/ **/
#define G_FILE_ATTRIBUTE_UNIX_BLOCKS "unix::blocks" /* uint64 */ #define G_FILE_ATTRIBUTE_UNIX_BLOCKS "unix::blocks" /* uint64 */
@ -648,9 +755,14 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT: * G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT:
* *
* A key in the "unix" namespace for checking if the file represents a * A key in the "unix" namespace for checking if the file represents a
* UNIX mount point. This attribute is %TRUE if the file is a UNIX mount * UNIX mount point.
* point. Since 2.58, `/` is considered to be a mount point. *
* This attribute is %TRUE if the file is a UNIX mount point.
*
* Since 2.58, `/` is considered to be a mount point.
*
* This attribute is only available for UNIX file systems. * This attribute is only available for UNIX file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT "unix::is-mountpoint" /* boolean */ #define G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT "unix::is-mountpoint" /* boolean */
@ -661,9 +773,13 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE: * G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE:
* *
* A key in the "dos" namespace for checking if the file's archive flag * A key in the "dos" namespace for checking if the file's archive flag
* is set. This attribute is %TRUE if the archive flag is set. This attribute * is set.
* is only available for DOS file systems. Corresponding #GFileAttributeType *
* is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * This attribute is %TRUE if the archive flag is set.
*
* This attribute is only available for DOS file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE "dos::is-archive" /* boolean */ #define G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE "dos::is-archive" /* boolean */
@ -671,9 +787,13 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_DOS_IS_SYSTEM: * G_FILE_ATTRIBUTE_DOS_IS_SYSTEM:
* *
* A key in the "dos" namespace for checking if the file's backup flag * A key in the "dos" namespace for checking if the file's backup flag
* is set. This attribute is %TRUE if the backup flag is set. This attribute * is set.
* is only available for DOS file systems. Corresponding #GFileAttributeType *
* is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * This attribute is %TRUE if the backup flag is set.
*
* This attribute is only available for DOS file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_DOS_IS_SYSTEM "dos::is-system" /* boolean */ #define G_FILE_ATTRIBUTE_DOS_IS_SYSTEM "dos::is-system" /* boolean */
@ -682,9 +802,12 @@ typedef struct _GFileInfoClass GFileInfoClass;
* *
* A key in the "dos" namespace for checking if the file is a NTFS mount point * A key in the "dos" namespace for checking if the file is a NTFS mount point
* (a volume mount or a junction point). * (a volume mount or a junction point).
*
* This attribute is %TRUE if file is a reparse point of type * This attribute is %TRUE if file is a reparse point of type
* [IO_REPARSE_TAG_MOUNT_POINT](https://msdn.microsoft.com/en-us/library/dd541667.aspx). * [IO_REPARSE_TAG_MOUNT_POINT](https://msdn.microsoft.com/en-us/library/dd541667.aspx).
*
* This attribute is only available for DOS file systems. * This attribute is only available for DOS file systems.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
* *
* Since: 2.60 * Since: 2.60
@ -695,10 +818,13 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG: * G_FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG:
* *
* A key in the "dos" namespace for getting the file NTFS reparse tag. * A key in the "dos" namespace for getting the file NTFS reparse tag.
*
* This value is 0 for files that are not reparse points. * This value is 0 for files that are not reparse points.
*
* See the [Reparse Tags](https://msdn.microsoft.com/en-us/library/dd541667.aspx) * See the [Reparse Tags](https://msdn.microsoft.com/en-us/library/dd541667.aspx)
* page for possible reparse tag values. Corresponding #GFileAttributeType * page for possible reparse tag values.
* is %G_FILE_ATTRIBUTE_TYPE_UINT32. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
* *
* Since: 2.60 * Since: 2.60
**/ **/
@ -710,8 +836,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_OWNER_USER: * G_FILE_ATTRIBUTE_OWNER_USER:
* *
* A key in the "owner" namespace for getting the user name of the * A key in the "owner" namespace for getting the user name of the
* file's owner. Corresponding #GFileAttributeType is * file's owner.
* %G_FILE_ATTRIBUTE_TYPE_STRING. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_OWNER_USER "owner::user" /* string */ #define G_FILE_ATTRIBUTE_OWNER_USER "owner::user" /* string */
@ -719,8 +846,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_OWNER_USER_REAL: * G_FILE_ATTRIBUTE_OWNER_USER_REAL:
* *
* A key in the "owner" namespace for getting the real name of the * A key in the "owner" namespace for getting the real name of the
* user that owns the file. Corresponding #GFileAttributeType is * user that owns the file.
* %G_FILE_ATTRIBUTE_TYPE_STRING. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_OWNER_USER_REAL "owner::user-real" /* string */ #define G_FILE_ATTRIBUTE_OWNER_USER_REAL "owner::user-real" /* string */
@ -728,6 +856,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_OWNER_GROUP: * G_FILE_ATTRIBUTE_OWNER_GROUP:
* *
* A key in the "owner" namespace for getting the file owner's group. * A key in the "owner" namespace for getting the file owner's group.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_OWNER_GROUP "owner::group" /* string */ #define G_FILE_ATTRIBUTE_OWNER_GROUP "owner::group" /* string */
@ -738,22 +867,26 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_THUMBNAIL_PATH: * G_FILE_ATTRIBUTE_THUMBNAIL_PATH:
* *
* A key in the "thumbnail" namespace for getting the path to the thumbnail * A key in the "thumbnail" namespace for getting the path to the thumbnail
* image. Corresponding #GFileAttributeType is * image.
* %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_THUMBNAIL_PATH "thumbnail::path" /* bytestring */ #define G_FILE_ATTRIBUTE_THUMBNAIL_PATH "thumbnail::path" /* bytestring */
/** /**
* G_FILE_ATTRIBUTE_THUMBNAILING_FAILED: * G_FILE_ATTRIBUTE_THUMBNAILING_FAILED:
* *
* A key in the "thumbnail" namespace for checking if thumbnailing failed. * A key in the "thumbnail" namespace for checking if thumbnailing failed.
* This attribute is %TRUE if thumbnailing failed. Corresponding *
* #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * This attribute is %TRUE if thumbnailing failed.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_THUMBNAILING_FAILED "thumbnail::failed" /* boolean */ #define G_FILE_ATTRIBUTE_THUMBNAILING_FAILED "thumbnail::failed" /* boolean */
/** /**
* G_FILE_ATTRIBUTE_THUMBNAIL_IS_VALID: * G_FILE_ATTRIBUTE_THUMBNAIL_IS_VALID:
* *
* A key in the "thumbnail" namespace for checking whether the thumbnail is outdated. * A key in the "thumbnail" namespace for checking whether the thumbnail is outdated.
*
* This attribute is %TRUE if the thumbnail is up-to-date with the file it represents, * This attribute is %TRUE if the thumbnail is up-to-date with the file it represents,
* and %FALSE if the file has been modified since the thumbnail was generated. * and %FALSE if the file has been modified since the thumbnail was generated.
* *
@ -772,10 +905,13 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_PREVIEW_ICON: * G_FILE_ATTRIBUTE_PREVIEW_ICON:
* *
* A key in the "preview" namespace for getting a #GIcon that can be * A key in the "preview" namespace for getting a #GIcon that can be
* used to get preview of the file. For example, it may be a low * used to get preview of the file.
* resolution thumbnail without metadata. Corresponding *
* #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value * For example, it may be a low resolution thumbnail without metadata.
* for this key should contain a #GIcon. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
*
* The value for this key should contain a #GIcon.
* *
* Since: 2.20 * Since: 2.20
**/ **/
@ -786,27 +922,30 @@ typedef struct _GFileInfoClass GFileInfoClass;
/** /**
* G_FILE_ATTRIBUTE_FILESYSTEM_SIZE: * G_FILE_ATTRIBUTE_FILESYSTEM_SIZE:
* *
* A key in the "filesystem" namespace for getting the total size (in bytes) of the file system, * A key in the "filesystem" namespace for getting the total size (in
* used in g_file_query_filesystem_info(). Corresponding #GFileAttributeType * bytes) of the file system, used in g_file_query_filesystem_info().
* is %G_FILE_ATTRIBUTE_TYPE_UINT64. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
**/ **/
#define G_FILE_ATTRIBUTE_FILESYSTEM_SIZE "filesystem::size" /* uint64 */ #define G_FILE_ATTRIBUTE_FILESYSTEM_SIZE "filesystem::size" /* uint64 */
/** /**
* G_FILE_ATTRIBUTE_FILESYSTEM_FREE: * G_FILE_ATTRIBUTE_FILESYSTEM_FREE:
* *
* A key in the "filesystem" namespace for getting the number of bytes of free space left on the * A key in the "filesystem" namespace for getting the number of bytes
* file system. Corresponding #GFileAttributeType is * of free space left on the file system.
* %G_FILE_ATTRIBUTE_TYPE_UINT64. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
**/ **/
#define G_FILE_ATTRIBUTE_FILESYSTEM_FREE "filesystem::free" /* uint64 */ #define G_FILE_ATTRIBUTE_FILESYSTEM_FREE "filesystem::free" /* uint64 */
/** /**
* G_FILE_ATTRIBUTE_FILESYSTEM_USED: * G_FILE_ATTRIBUTE_FILESYSTEM_USED:
* *
* A key in the "filesystem" namespace for getting the number of bytes of used on the * A key in the "filesystem" namespace for getting the number of bytes
* file system. Corresponding #GFileAttributeType is * used by data on the file system.
* %G_FILE_ATTRIBUTE_TYPE_UINT64. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
* *
* Since: 2.32 * Since: 2.32
*/ */
@ -816,6 +955,7 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_FILESYSTEM_TYPE: * G_FILE_ATTRIBUTE_FILESYSTEM_TYPE:
* *
* A key in the "filesystem" namespace for getting the file system's type. * A key in the "filesystem" namespace for getting the file system's type.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_FILESYSTEM_TYPE "filesystem::type" /* string */ #define G_FILE_ATTRIBUTE_FILESYSTEM_TYPE "filesystem::type" /* string */
@ -824,7 +964,10 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_FILESYSTEM_READONLY: * 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. * is read only.
*
* Is set to %TRUE if the file system is read only.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_FILESYSTEM_READONLY "filesystem::readonly" /* boolean */ #define G_FILE_ATTRIBUTE_FILESYSTEM_READONLY "filesystem::readonly" /* boolean */
@ -834,8 +977,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* *
* A key in the "filesystem" namespace for hinting a file manager * A key in the "filesystem" namespace for hinting a file manager
* application whether it should preview (e.g. thumbnail) files on the * application whether it should preview (e.g. thumbnail) files on the
* file system. The value for this key contain a * file system.
* #GFilesystemPreviewType. *
* The value for this key contain a #GFilesystemPreviewType.
**/ **/
#define G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW "filesystem::use-preview" /* uint32 (GFilesystemPreviewType) */ #define G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW "filesystem::use-preview" /* uint32 (GFilesystemPreviewType) */
@ -843,7 +987,10 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE: * G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE:
* *
* 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 remote. Is set to %TRUE if the file system is remote. * is remote.
*
* Is set to %TRUE if the file system is remote.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
**/ **/
#define G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE "filesystem::remote" /* boolean */ #define G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE "filesystem::remote" /* boolean */
@ -852,8 +999,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_GVFS_BACKEND: * G_FILE_ATTRIBUTE_GVFS_BACKEND:
* *
* A key in the "gvfs" namespace that gets the name of the current * A key in the "gvfs" namespace that gets the name of the current
* GVFS backend in use. Corresponding #GFileAttributeType is * GVFS backend in use.
* %G_FILE_ATTRIBUTE_TYPE_STRING. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
**/ **/
#define G_FILE_ATTRIBUTE_GVFS_BACKEND "gvfs::backend" /* string */ #define G_FILE_ATTRIBUTE_GVFS_BACKEND "gvfs::backend" /* string */
@ -861,17 +1009,21 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_SELINUX_CONTEXT: * G_FILE_ATTRIBUTE_SELINUX_CONTEXT:
* *
* A key in the "selinux" namespace for getting the file's SELinux * A key in the "selinux" namespace for getting the file's SELinux
* context. Corresponding #GFileAttributeType is * context.
* %G_FILE_ATTRIBUTE_TYPE_STRING. Note that this attribute is only *
* available if GLib has been built with SELinux support. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
*
* Note that this attribute is only available if GLib has been built
* with SELinux support.
**/ **/
#define G_FILE_ATTRIBUTE_SELINUX_CONTEXT "selinux::context" /* string */ #define G_FILE_ATTRIBUTE_SELINUX_CONTEXT "selinux::context" /* string */
/** /**
* G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT: * G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT:
* *
* A key in the "trash" namespace. When requested against * A key in the "trash" namespace for getting the number of (toplevel) items
* `trash:///` returns the number of (toplevel) items in the trash folder. * that are present in the `trash:///` folder.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
**/ **/
#define G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT "trash::item-count" /* uint32 */ #define G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT "trash::item-count" /* uint32 */
@ -879,10 +1031,10 @@ typedef struct _GFileInfoClass GFileInfoClass;
/** /**
* G_FILE_ATTRIBUTE_TRASH_ORIG_PATH: * G_FILE_ATTRIBUTE_TRASH_ORIG_PATH:
* *
* A key in the "trash" namespace. When requested against * A key in the "trash" namespace for getting the original path of a file
* items in `trash:///`, will return the original path to the file before it * inside the `trash:///` folder before it was trashed.
* was trashed. Corresponding #GFileAttributeType is *
* %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
* *
* Since: 2.24 * Since: 2.24
**/ **/
@ -891,9 +1043,11 @@ typedef struct _GFileInfoClass GFileInfoClass;
/** /**
* G_FILE_ATTRIBUTE_TRASH_DELETION_DATE: * G_FILE_ATTRIBUTE_TRASH_DELETION_DATE:
* *
* A key in the "trash" namespace. When requested against * A key in the "trash" namespace for getting the deletion date and time
* items in `trash:///`, will return the date and time when the file * of a file inside the `trash:///` folder.
* was trashed. The format of the returned string is YYYY-MM-DDThh:mm:ss. *
* The format of the returned string is `YYYY-MM-DDThh:mm:ss`.
*
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
* *
* Since: 2.24 * Since: 2.24
@ -904,8 +1058,9 @@ typedef struct _GFileInfoClass GFileInfoClass;
* G_FILE_ATTRIBUTE_RECENT_MODIFIED: * G_FILE_ATTRIBUTE_RECENT_MODIFIED:
* *
* A key in the "recent" namespace for getting time, when the metadata for the * A key in the "recent" namespace for getting time, when the metadata for the
* file in `recent:///` was last changed. Corresponding #GFileAttributeType is * file in `recent:///` was last changed.
* %G_FILE_ATTRIBUTE_TYPE_INT64. *
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_INT64.
* *
* Since: 2.52 * Since: 2.52
**/ **/