forked from enlightenment/efl
several fixes for the doxygen docs.
Author : Jérôme Pinot <ngc891@gmail.com> SVN revision: 70426
This commit is contained in:
parent
085775de8c
commit
b9ed47a471
|
@ -1306,8 +1306,7 @@ EAPI int ecore_con_client_port_get(Ecore_Con_Client *cl);
|
||||||
*
|
*
|
||||||
* These are complete examples for the API:
|
* These are complete examples for the API:
|
||||||
* @li @ref ecore_con_url_download_example.c "Downloading a file"
|
* @li @ref ecore_con_url_download_example.c "Downloading a file"
|
||||||
* @li @ref ecore_con_url_headers_example.c "Setting many options for the
|
* @li @ref ecore_con_url_headers_example.c "Setting many options for the connection"
|
||||||
* connection"
|
|
||||||
*
|
*
|
||||||
* @{
|
* @{
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -116,7 +116,7 @@ EAPI Eina_Bool eeze_disk_can_eject(void);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Create a new disk object from a /sys/ path or /dev/ path
|
* @brief Create a new disk object from a /sys/ path or /dev/ path
|
||||||
* @param path The /sys/ or /dev path of the disk; CANNOT be #NULL
|
* @param path The /sys/ or /dev path of the disk; CANNOT be @c NULL.
|
||||||
* @return The new disk object
|
* @return The new disk object
|
||||||
*
|
*
|
||||||
* This function creates a new #Eeze_Disk from @p path. Note that this function
|
* This function creates a new #Eeze_Disk from @p path. Note that this function
|
||||||
|
@ -128,7 +128,7 @@ EAPI Eeze_Disk *eeze_disk_new(const char *path);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Create a new disk object from a mount point
|
* @brief Create a new disk object from a mount point
|
||||||
* @param mount_point The mount point of the disk; CANNOT be #NULL
|
* @param mount_point The mount point of the disk; CANNOT be @c NULL
|
||||||
* @return The new disk object
|
* @return The new disk object
|
||||||
*
|
*
|
||||||
* This function creates a new #Eeze_Disk from @p mount_point. Note that this function
|
* This function creates a new #Eeze_Disk from @p mount_point. Note that this function
|
||||||
|
@ -207,7 +207,7 @@ EAPI const char *eeze_disk_devpath_get(Eeze_Disk *disk);
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return The filesystem type
|
* @return The filesystem type
|
||||||
*
|
*
|
||||||
* This retrieves the filesystem that the disk is using, or #NULL if unknown.
|
* This retrieves the filesystem that the disk is using, or @c NULL if unknown.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
EAPI const char *eeze_disk_fstype_get(Eeze_Disk *disk);
|
EAPI const char *eeze_disk_fstype_get(Eeze_Disk *disk);
|
||||||
|
@ -217,7 +217,7 @@ EAPI const char *eeze_disk_fstype_get(Eeze_Disk *disk);
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return The vendor
|
* @return The vendor
|
||||||
*
|
*
|
||||||
* This retrieves the vendor which manufactured the disk, or #NULL if unknown.
|
* This retrieves the vendor which manufactured the disk, or @c NULL if unknown.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
EAPI const char *eeze_disk_vendor_get(Eeze_Disk *disk);
|
EAPI const char *eeze_disk_vendor_get(Eeze_Disk *disk);
|
||||||
|
@ -227,7 +227,7 @@ EAPI const char *eeze_disk_vendor_get(Eeze_Disk *disk);
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return The model
|
* @return The model
|
||||||
*
|
*
|
||||||
* This retrieves the model of the disk, or #NULL if unknown.
|
* This retrieves the model of the disk, or @c NULL if unknown.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
EAPI const char *eeze_disk_model_get(Eeze_Disk *disk);
|
EAPI const char *eeze_disk_model_get(Eeze_Disk *disk);
|
||||||
|
@ -237,7 +237,7 @@ EAPI const char *eeze_disk_model_get(Eeze_Disk *disk);
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return The serial number
|
* @return The serial number
|
||||||
*
|
*
|
||||||
* This retrieves the serial number the disk, or #NULL if unknown.
|
* This retrieves the serial number the disk, or @c NULL if unknown.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
EAPI const char *eeze_disk_serial_get(Eeze_Disk *disk);
|
EAPI const char *eeze_disk_serial_get(Eeze_Disk *disk);
|
||||||
|
@ -247,7 +247,7 @@ EAPI const char *eeze_disk_serial_get(Eeze_Disk *disk);
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return The UUID
|
* @return The UUID
|
||||||
*
|
*
|
||||||
* This retrieves the UUID of the disk, or #NULL if unknown.
|
* This retrieves the UUID of the disk, or @c NULL if unknown.
|
||||||
* A UUID is a 36 character (hopefully) unique identifier which can
|
* A UUID is a 36 character (hopefully) unique identifier which can
|
||||||
* be used to store persistent information about a disk.
|
* be used to store persistent information about a disk.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
|
@ -259,7 +259,7 @@ EAPI const char *eeze_disk_uuid_get(Eeze_Disk *disk);
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return The label
|
* @return The label
|
||||||
*
|
*
|
||||||
* This retrieves the label (name) of the disk, or #NULL if unknown.
|
* This retrieves the label (name) of the disk, or @c NULL if unknown.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
EAPI const char *eeze_disk_label_get(Eeze_Disk *disk);
|
EAPI const char *eeze_disk_label_get(Eeze_Disk *disk);
|
||||||
|
@ -278,7 +278,7 @@ EAPI Eeze_Disk_Type eeze_disk_type_get(Eeze_Disk *disk);
|
||||||
/**
|
/**
|
||||||
* @brief Return whether the disk is removable
|
* @brief Return whether the disk is removable
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return EINA_TRUE if removable, else EINA_FALSE
|
* @return @c EINA_TRUE if removable, @c EINA_FALSE otherwise.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
EAPI Eina_Bool eeze_disk_removable_get(Eeze_Disk *disk);
|
EAPI Eina_Bool eeze_disk_removable_get(Eeze_Disk *disk);
|
||||||
|
@ -289,7 +289,8 @@ EAPI Eina_Bool eeze_disk_removable_get(Eeze_Disk *disk);
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return The mount state
|
* @return The mount state
|
||||||
*
|
*
|
||||||
* This returns the mounted state of the disk. #EINA_TRUE if mounted, else #EINA_FALSE.
|
* This returns the mounted state of the disk. @c EINA_TRUE if mounted,
|
||||||
|
* @c EINA_FALSE otherwise.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
EAPI Eina_Bool eeze_disk_mounted_get(Eeze_Disk *disk);
|
EAPI Eina_Bool eeze_disk_mounted_get(Eeze_Disk *disk);
|
||||||
|
@ -297,7 +298,7 @@ EAPI Eina_Bool eeze_disk_mounted_get(Eeze_Disk *disk);
|
||||||
/**
|
/**
|
||||||
* @brief Get the previously set mount wrapper for a disk
|
* @brief Get the previously set mount wrapper for a disk
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return The wrapper, or NULL on failure
|
* @return The wrapper, or @c NULL on failure.
|
||||||
*
|
*
|
||||||
* This returns the wrapper previously set with eeze_disk_mount_wrapper_set
|
* This returns the wrapper previously set with eeze_disk_mount_wrapper_set
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
|
@ -308,11 +309,11 @@ EAPI const char *eeze_disk_mount_wrapper_get(Eeze_Disk *disk);
|
||||||
* @brief Set a wrapper to run mount commands with
|
* @brief Set a wrapper to run mount commands with
|
||||||
* @param disk The disk to wrap mount commands for
|
* @param disk The disk to wrap mount commands for
|
||||||
* @param wrapper The wrapper executable
|
* @param wrapper The wrapper executable
|
||||||
* @return EINA_TRUE on success, else EINA_FALSE
|
* @return @c EINA_TRUE on success, @c EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* Use this function to set up a wrapper for running mount/umount commands. The wrapper must
|
* Use this function to set up a wrapper for running mount/umount commands. The wrapper must
|
||||||
* NOT use any of the standard mount/umount error code return values, and it must return 0 on success.
|
* NOT use any of the standard mount/umount error code return values, and it must return 0 on success.
|
||||||
* Note that this function will call stat() on @p wrapper if not NULL to test for existence.
|
* Note that this function will call stat() on @p wrapper if not @c NULL to test for existence.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
EAPI Eina_Bool eeze_disk_mount_wrapper_set(Eeze_Disk *disk, const char *wrapper);
|
EAPI Eina_Bool eeze_disk_mount_wrapper_set(Eeze_Disk *disk, const char *wrapper);
|
||||||
|
@ -320,7 +321,7 @@ EAPI Eina_Bool eeze_disk_mount_wrapper_set(Eeze_Disk *disk, const char *wra
|
||||||
/**
|
/**
|
||||||
* @brief Begin a mount operation on the disk
|
* @brief Begin a mount operation on the disk
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return #EINA_TRUE if the operation was started, else #EINA_FALSE
|
* @return @c EINA_TRUE if the operation was started, @c EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This call is used to begin a mount operation on @p disk. The operation will
|
* This call is used to begin a mount operation on @p disk. The operation will
|
||||||
* run asynchronously in a pipe, emitting an EEZE_EVENT_DISK_MOUNT event with the disk object
|
* run asynchronously in a pipe, emitting an EEZE_EVENT_DISK_MOUNT event with the disk object
|
||||||
|
@ -336,7 +337,7 @@ EAPI Eina_Bool eeze_disk_mount(Eeze_Disk *disk);
|
||||||
/**
|
/**
|
||||||
* @brief Begin an unmount operation on the disk
|
* @brief Begin an unmount operation on the disk
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return #EINA_TRUE if the operation was started, else #EINA_FALSE
|
* @return @c EINA_TRUE if the operation was started, @c EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This call is used to begin an unmount operation on @p disk. The operation will
|
* This call is used to begin an unmount operation on @p disk. The operation will
|
||||||
* run asynchronously in a pipe, emitting an EEZE_EVENT_DISK_UNMOUNT event with the disk object
|
* run asynchronously in a pipe, emitting an EEZE_EVENT_DISK_UNMOUNT event with the disk object
|
||||||
|
@ -352,7 +353,7 @@ EAPI Eina_Bool eeze_disk_unmount(Eeze_Disk *disk);
|
||||||
/**
|
/**
|
||||||
* @brief Begin an eject operation on the disk
|
* @brief Begin an eject operation on the disk
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @return #EINA_TRUE if the operation was started, else #EINA_FALSE
|
* @return @c EINA_TRUE if the operation was started, @c EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This call is used to begin an eject operation on @p disk. The operation will
|
* This call is used to begin an eject operation on @p disk. The operation will
|
||||||
* run asynchronously in a pipe, emitting an EEZE_EVENT_DISK_EJECT event with the disk object
|
* run asynchronously in a pipe, emitting an EEZE_EVENT_DISK_EJECT event with the disk object
|
||||||
|
@ -389,7 +390,7 @@ EAPI const char *eeze_disk_mount_point_get(Eeze_Disk *disk);
|
||||||
* @brief Set the mount point of a disk
|
* @brief Set the mount point of a disk
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @param mount_point The mount point
|
* @param mount_point The mount point
|
||||||
* @return EINA_TRUE on success, else EINA_FALSE
|
* @return @c EINA_TRUE on success, @c EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This function sets the mount point associated with @p disk.
|
* This function sets the mount point associated with @p disk.
|
||||||
* Note that to determine whether the disk is actually mounted, eeze_disk_mounted_get should be used.
|
* Note that to determine whether the disk is actually mounted, eeze_disk_mounted_get should be used.
|
||||||
|
@ -402,7 +403,7 @@ EAPI Eina_Bool eeze_disk_mount_point_set(Eeze_Disk *disk, const char *mount
|
||||||
* @brief Set the mount options using flags
|
* @brief Set the mount options using flags
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @param opts An ORed set of #Eeze_Mount_Opts
|
* @param opts An ORed set of #Eeze_Mount_Opts
|
||||||
* @return EINA_TRUE on success, else EINA_FALSE
|
* @return @c EINA_TRUE on success, @c EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This function replaces the current mount opts of a disk with the ones in @p opts.
|
* This function replaces the current mount opts of a disk with the ones in @p opts.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
|
@ -422,7 +423,7 @@ EAPI unsigned long eeze_disk_mountopts_get(Eeze_Disk *disk);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Begin watching mtab and fstab
|
* @brief Begin watching mtab and fstab
|
||||||
* @return #EINA_TRUE if watching was started, else #EINA_FALSE
|
* @return @c EINA_TRUE if watching was started, @c EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This function creates inotify watches on /etc/mtab and /etc/fstab and watches
|
* This function creates inotify watches on /etc/mtab and /etc/fstab and watches
|
||||||
* them for changes. This function should be used when expecting a lot of disk
|
* them for changes. This function should be used when expecting a lot of disk
|
||||||
|
@ -443,14 +444,14 @@ EAPI void eeze_mount_tabs_unwatch(void);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Scan /etc/mtab a single time
|
* @brief Scan /etc/mtab a single time
|
||||||
* @return #EINA_TRUE if mtab could be scanned, else #EINA_FALSE
|
* @return @c EINA_TRUE if mtab could be scanned, @c EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This function is used to perform a single scan on /etc/mtab. It is used to gather
|
* This function is used to perform a single scan on /etc/mtab. It is used to gather
|
||||||
* information about mounted filesystems which can then be used with your #Eeze_Disk objects
|
* information about mounted filesystems which can then be used with your #Eeze_Disk objects
|
||||||
* where appropriate. These files will automatically be scanned any time a mount point or mount state
|
* where appropriate. These files will automatically be scanned any time a mount point or mount state
|
||||||
* is requested unless eeze_mount_tabs_watch has been called previously, in which case data is stored for
|
* is requested unless eeze_mount_tabs_watch has been called previously, in which case data is stored for
|
||||||
* use.
|
* use.
|
||||||
* If this function is called after eeze_mount_tabs_watch, #EINA_TRUE will be returned.
|
* If this function is called after eeze_mount_tabs_watch, @c EINA_TRUE will be returned.
|
||||||
* @see eeze_mount_tabs_watch, eeze_mount_fstab_scan
|
* @see eeze_mount_tabs_watch, eeze_mount_fstab_scan
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
|
@ -458,14 +459,14 @@ EAPI Eina_Bool eeze_mount_mtab_scan(void);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Scan /etc/fstab a single time
|
* @brief Scan /etc/fstab a single time
|
||||||
* @return #EINA_TRUE if mtab could be scanned, else #EINA_FALSE
|
* @return @c EINA_TRUE if mtab could be scanned, @c EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This function is used to perform a single scan on /etc/fstab. It is used to gather
|
* This function is used to perform a single scan on /etc/fstab. It is used to gather
|
||||||
* information about mounted filesystems which can then be used with your #Eeze_Disk objects
|
* information about mounted filesystems which can then be used with your #Eeze_Disk objects
|
||||||
* where appropriate. These files will automatically be scanned any time a mount point or mount state
|
* where appropriate. These files will automatically be scanned any time a mount point or mount state
|
||||||
* is requested unless eeze_mount_tabs_watch has been called previously, in which case data is stored for
|
* is requested unless eeze_mount_tabs_watch has been called previously, in which case data is stored for
|
||||||
* use.
|
* use.
|
||||||
* If this function is called after eeze_mount_tabs_watch, #EINA_TRUE will be returned.
|
* If this function is called after eeze_mount_tabs_watch, @c EINA_TRUE will be returned.
|
||||||
* @see eeze_mount_tabs_watch, eeze_mount_mtab_scan
|
* @see eeze_mount_tabs_watch, eeze_mount_mtab_scan
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
|
@ -476,7 +477,7 @@ EAPI Eina_Bool eeze_mount_fstab_scan(void);
|
||||||
*
|
*
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @param property The property to get; full list of these is a FIXME
|
* @param property The property to get; full list of these is a FIXME
|
||||||
* @return A stringshared char* with the property or NULL on failure
|
* @return A stringshared char* with the property or @c NULL on failure.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
@ -487,7 +488,7 @@ EAPI const char *eeze_disk_udev_get_property(Eeze_Disk *disk, const char *pro
|
||||||
*
|
*
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @param sysattr The sysattr to get; full list of these is a FIXME
|
* @param sysattr The sysattr to get; full list of these is a FIXME
|
||||||
* @return A stringshared char* with the sysattr or NULL on failure
|
* @return A stringshared char* with the sysattr or @c NULL on failure.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
@ -510,9 +511,10 @@ EAPI const char *eeze_disk_udev_get_parent(Eeze_Disk *disk);
|
||||||
*
|
*
|
||||||
* @param disk The disk to walk
|
* @param disk The disk to walk
|
||||||
* @param sysattr The attribute to find
|
* @param sysattr The attribute to find
|
||||||
* @param value OPTIONAL: The value that @p sysattr should have, or NULL
|
* @param value OPTIONAL: The value that @p sysattr should have, or @c NULL.
|
||||||
*
|
*
|
||||||
* @return If the sysattr (with value) is found, returns TRUE. Else, false.
|
* @return If the sysattr (with value) is found, returns @c EINA_TRUE,
|
||||||
|
* @EINA_FALSE otherwise.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
EAPI Eina_Bool eeze_disk_udev_walk_check_sysattr(Eeze_Disk *disk, const char *sysattr, const char *value);
|
EAPI Eina_Bool eeze_disk_udev_walk_check_sysattr(Eeze_Disk *disk, const char *sysattr, const char *value);
|
||||||
|
@ -524,7 +526,7 @@ EAPI Eina_Bool eeze_disk_udev_walk_check_sysattr(Eeze_Disk *disk, const cha
|
||||||
* @param disk The disk
|
* @param disk The disk
|
||||||
* @param sysattr The attribute to find
|
* @param sysattr The attribute to find
|
||||||
*
|
*
|
||||||
* @return The stringshared value of @p sysattr if found, or NULL
|
* @return The stringshared value of @p sysattr if found, or @c NULL.
|
||||||
* @since 1.1
|
* @since 1.1
|
||||||
*/
|
*/
|
||||||
EAPI const char *eeze_disk_udev_walk_get_sysattr(Eeze_Disk *disk, const char *sysattr);
|
EAPI const char *eeze_disk_udev_walk_get_sysattr(Eeze_Disk *disk, const char *sysattr);
|
||||||
|
|
|
@ -56,7 +56,7 @@
|
||||||
* that the return value is attributed to the @a list variable, this needs to
|
* that the return value is attributed to the @a list variable, this needs to
|
||||||
* be done every time we use a a function that alters the contents of the list.
|
* be done every time we use a a function that alters the contents of the list.
|
||||||
*
|
*
|
||||||
* Now that we have a list we some elements in it we can look at it's contents.
|
* Now that we have a list with some elements in it we can look at it's contents.
|
||||||
* @until printf
|
* @until printf
|
||||||
*
|
*
|
||||||
* There are many ways of accessing elements in the list, including by it's
|
* There are many ways of accessing elements in the list, including by it's
|
||||||
|
@ -151,7 +151,7 @@
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @page eina_list_03_example_page Reordering Eina_List elments
|
* @page eina_list_03_example_page Reordering Eina_List elements
|
||||||
* @dontinclude eina_list_03.c
|
* @dontinclude eina_list_03.c
|
||||||
*
|
*
|
||||||
* If you don't know how to create lists see
|
* If you don't know how to create lists see
|
||||||
|
@ -190,7 +190,7 @@
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @page eina_list_03_c Reordering Eina_List elments example
|
* @page eina_list_03_c Reordering Eina_List elements example
|
||||||
*
|
*
|
||||||
* @include eina_list_03.c
|
* @include eina_list_03.c
|
||||||
* @example eina_list_03.c
|
* @example eina_list_03.c
|
||||||
|
|
|
@ -75,7 +75,7 @@
|
||||||
* We then check data for corresponding tag:
|
* We then check data for corresponding tag:
|
||||||
* @until EINA_FALSE
|
* @until EINA_FALSE
|
||||||
*
|
*
|
||||||
* We are doing the formatting in same time and put all the <post> children
|
* We are doing the formatting in same time and put all the \<post\> children
|
||||||
* in str.
|
* in str.
|
||||||
* @until EINA_FALSE
|
* @until EINA_FALSE
|
||||||
*
|
*
|
||||||
|
|
Loading…
Reference in New Issue