luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-11-10 03:16:17 +01:00
Code Issues Packages Projects Releases Wiki Activity

Document new api

Browse Source 
svn path=/trunk/; revision=6398
This commit is contained in:
Matthias Clasen 2008-01-28 17:26:45 +00:00
parent e2ba37ceb3
commit fce0485e2b
3 changed files with 30 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
gio/ChangeLog
View File

@ -1,5 +1,6 @@
2008-01-28 Matthias Clasen <mclasen@redhat.com>
* gdrive.[hc]:
* gvolume.[hc]: Document new API.
* gfile.c (g_file_copy_async): Fix docs

26
gio/gdrive.c
View File

@ -474,9 +474,20 @@ g_drive_poll_for_media_finish (GDrive *drive,
return (* iface->poll_for_media_finish) (drive, result, error);
}
/**
* g_drive_get_identifier:
* @drive: a #GDrive
* @kind: the kind of identifier to return
*
* Gets the identifier of the given kind for @drive.
*
* Returns: a newly allocated string containing the
* requested identfier, or %NULL if the #GDrive
* doesn't have this kind of identifier
*/
char *
g_drive_get_identifier (GDrive *drive,
const char *kind)
g_drive_get_identifier (GDrive *drive,
const char *kind)
{
GDriveIface *iface;
@ -491,6 +502,17 @@ g_drive_get_identifier (GDrive *drive,
return (* iface->get_identifier) (drive, kind);
}
/**
* g_drive_enumerate_identifiers:
* @drive: a #GDrive
*
* Gets the kinds of identifiers that @drive has.
* Use g_drive_get_identifer() to obtain the identifiers
* themselves.
*
* Returns: a %NULL-terminated array of strings containing
* kinds of identifiers. Use g_strfreev() to free.
*/
char **
g_drive_enumerate_identifiers (GDrive *drive)
{

5
gio/gdrive.h
View File

@ -59,6 +59,11 @@ G_BEGIN_DECLS
* @eject_finish: Finishes an eject operation.
* @poll_for_media: Poll for media insertion/removal on a #GDrive.
* @poll_for_media_finish: Finishes a media poll operation.
* @get_identifier: Returns the identifier of the given kind, or %NULL if
* the #GDrive doesn't have one.
* @enumerate_identifiers: Returns an array strings listing the kinds
* of identifiers which the #GDrive has.
*
*
* Interface for creating #GDrive implementations.
*/