luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-25 15:06:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

gfileinfo: Clarify units in documentation for file attributes

Browse Source 
Clarify that the G_FILE_ATTRIBUTE_TIME_* attributes are all in seconds
(apart from the *_USEC ones, which are documented separately).
This commit is contained in:
Philip Withnall 2017-01-24 12:52:24 +00:00
parent 740007c11e
commit 95afbe1666
1 changed files with 8 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
gio/gfileinfo.h
View File

@ -473,8 +473,8 @@ typedef struct _GFileInfoClass GFileInfoClass;
*
* A key in the "time" namespace for getting the time the file was last
* modified. Corresponding #GFileAttributeType is
* %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the
* file was modified.
* %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 */
@ -493,8 +493,8 @@ typedef struct _GFileInfoClass GFileInfoClass;
*
* A key in the "time" namespace for getting the time the file was last
* accessed. Corresponding #GFileAttributeType is
* %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the
* file was last accessed.
* %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 */
@ -513,7 +513,8 @@ typedef struct _GFileInfoClass GFileInfoClass;
*
* A key in the "time" namespace for getting the time the file was last
* changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
* and contains the UNIX time since the file was last changed.
* and contains the time since the file was last changed, in seconds since the
* UNIX epoch.
*
* This corresponds to the traditional UNIX ctime.
**/
@ -534,7 +535,8 @@ typedef struct _GFileInfoClass GFileInfoClass;
*
* A key in the "time" namespace for getting the time the file was created.
* Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
* and contains the UNIX time since the file was created.
* and contains the time since the file was created, in seconds since the UNIX
* epoch.
*
* This corresponds to the NTFS ctime.
**/