luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-06-16 01:23:49 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: Move the GVolume SECTION

Browse Source 
Move it to the struct docs.

Signed-off-by: Philip Withnall <philip@tecnocode.co.uk>

Helps: #3037
This commit is contained in:
Philip Withnall 2023-11-02 16:27:57 +00:00
parent 830db4e3c0
commit ed247401bf
2 changed files with 31 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

58
gio/gvolume.c
View File

@ -32,51 +32,49 @@
/** /**
* SECTION:gvolume * GVolume:
* @short_description: Volume management
* @include: gio/gio.h
* *
* The #GVolume interface represents user-visible objects that can be * The `GVolume` interface represents user-visible objects that can be
* mounted. Note, when porting from GnomeVFS, #GVolume is the moral * mounted. Note, when [porting from GnomeVFS](migrating-gnome-vfs.html),
* equivalent of #GnomeVFSDrive. * `GVolume` is the moral equivalent of `GnomeVFSDrive`.
* *
* Mounting a #GVolume instance is an asynchronous operation. For more * Mounting a `GVolume` instance is an asynchronous operation. For more
* information about asynchronous operations, see #GAsyncResult and * information about asynchronous operations, see [class@Gio.AsyncResult] and
* #GTask. To mount a #GVolume, first call g_volume_mount() with (at * [class@Gio.Task]. To mount a `GVolume`, first call [method@Gio.Volume.mount]
* least) the #GVolume instance, optionally a #GMountOperation object * with (at least) the `GVolume` instance, optionally a
* and a #GAsyncReadyCallback. * [class@Gio.MountOperation] object and a [type@Gio.AsyncReadyCallback].
* *
* Typically, one will only want to pass %NULL for the * Typically, one will only want to pass `NULL` for the
* #GMountOperation if automounting all volumes when a desktop session * [class@Gio.MountOperation] if automounting all volumes when a desktop session
* starts since it's not desirable to put up a lot of dialogs asking * starts since it’s not desirable to put up a lot of dialogs asking
* for credentials. * for credentials.
* *
* The callback will be fired when the operation has resolved (either * The callback will be fired when the operation has resolved (either
* with success or failure), and a #GAsyncResult instance will be * with success or failure), and a [class@Gio.AsyncResult] instance will be
* passed to the callback. That callback should then call * passed to the callback. That callback should then call
* g_volume_mount_finish() with the #GVolume instance and the * [method@Gio.Volume.mount_finish] with the `GVolume` instance and the
* #GAsyncResult data to see if the operation was completed * [class@Gio.AsyncResult] data to see if the operation was completed
* successfully. If an @error is present when g_volume_mount_finish() * successfully. If a [type@GLib.Error] is present when
* is called, then it will be filled with any error information. * [method@Gio.Volume.mount_finish] is called, then it will be filled with any
* error information.
* *
* ## Volume Identifiers # {#volume-identifier} * ## Volume Identifiers
* *
* It is sometimes necessary to directly access the underlying * It is sometimes necessary to directly access the underlying
* operating system object behind a volume (e.g. for passing a volume * operating system object behind a volume (e.g. for passing a volume
* to an application via the command line). For this purpose, GIO * to an application via the command line). For this purpose, GIO
* allows to obtain an 'identifier' for the volume. There can be * allows to obtain an ‘identifier’ for the volume. There can be
* different kinds of identifiers, such as Hal UDIs, filesystem labels, * different kinds of identifiers, such as Hal UDIs, filesystem labels,
* traditional Unix devices (e.g. `/dev/sda2`), UUIDs. GIO uses predefined * traditional Unix devices (e.g. `/dev/sda2`), UUIDs. GIO uses predefined
* strings as names for the different kinds of identifiers: * strings as names for the different kinds of identifiers:
* %G_VOLUME_IDENTIFIER_KIND_UUID, %G_VOLUME_IDENTIFIER_KIND_LABEL, etc. * `G_VOLUME_IDENTIFIER_KIND_UUID`, `G_VOLUME_IDENTIFIER_KIND_LABEL`, etc.
* Use g_volume_get_identifier() to obtain an identifier for a volume. * Use [method@Gio.Volume.get_identifier] to obtain an identifier for a volume.
* *
* * Note that `G_VOLUME_IDENTIFIER_KIND_HAL_UDI` will only be available
* Note that %G_VOLUME_IDENTIFIER_KIND_HAL_UDI will only be available * when the GVFS hal volume monitor is in use. Other volume monitors
* when the gvfs hal volume monitor is in use. Other volume monitors * will generally be able to provide the `G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE`
* will generally be able to provide the %G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE
* identifier, which can be used to obtain a hal device by means of * identifier, which can be used to obtain a hal device by means of
* libhal_manager_find_device_string_match(). * `libhal_manager_find_device_string_match()`.
*/ */
typedef GVolumeIface GVolumeInterface; typedef GVolumeIface GVolumeInterface;
@ -563,7 +561,7 @@ g_volume_eject_with_operation_finish (GVolume *volume,
* @kind: the kind of identifier to return * @kind: the kind of identifier to return
* *
* Gets the identifier of the given kind for @volume. * Gets the identifier of the given kind for @volume.
* See the [introduction][volume-identifier] for more * See the [introduction](#volume-identifiers) for more
* information about volume identifiers. * information about volume identifiers.
* *
* Returns: (nullable) (transfer full): a newly allocated string containing the * Returns: (nullable) (transfer full): a newly allocated string containing the
@ -591,7 +589,7 @@ g_volume_get_identifier (GVolume *volume,
* g_volume_enumerate_identifiers: * g_volume_enumerate_identifiers:
* @volume: a #GVolume * @volume: a #GVolume
* *
* Gets the kinds of [identifiers][volume-identifier] that @volume has. * Gets the kinds of [identifiers](#volume-identifiers) that @volume has.
* Use g_volume_get_identifier() to obtain the identifiers themselves. * Use g_volume_get_identifier() to obtain the identifiers themselves.
* *
* Returns: (array zero-terminated=1) (transfer full): a %NULL-terminated array * Returns: (array zero-terminated=1) (transfer full): a %NULL-terminated array

4
gio/gvolume.h
View File

@ -109,10 +109,10 @@ G_BEGIN_DECLS
* @mount_finish: Finishes a mount operation. * @mount_finish: Finishes a mount operation.
* @eject: Ejects a given #GVolume. * @eject: Ejects a given #GVolume.
* @eject_finish: Finishes an eject operation. * @eject_finish: Finishes an eject operation.
* @get_identifier: Returns the [identifier][volume-identifier] of the given kind, or %NULL if * @get_identifier: Returns the [identifier](#volume-identifiers) of the given kind, or %NULL if
* the #GVolume doesn't have one. * the #GVolume doesn't have one.
* @enumerate_identifiers: Returns an array strings listing the kinds * @enumerate_identifiers: Returns an array strings listing the kinds
* of [identifiers][volume-identifier] which the #GVolume has. * of [identifiers](#volume-identifiers) which the #GVolume has.
* @should_automount: Returns %TRUE if the #GVolume should be automatically mounted. * @should_automount: Returns %TRUE if the #GVolume should be automatically mounted.
* @get_activation_root: Returns the activation root for the #GVolume if it is known in advance or %NULL if * @get_activation_root: Returns the activation root for the #GVolume if it is known in advance or %NULL if
* it is not known. * it is not known.