summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar Christophe Fergeau2011-03-11 22:56:52 +0100
committerGravatar Martin Szulecki2011-03-12 03:18:21 +0100
commit6d11e7166019a92386ac2e9895859736450bd3b8 (patch)
tree20376ff2aed310f8243e137ff285f84455371096
parentd3faf0314f16051a820279f8b5668eed9a9c033c (diff)
downloadlibimobiledevice-6d11e7166019a92386ac2e9895859736450bd3b8.tar.gz
libimobiledevice-6d11e7166019a92386ac2e9895859736450bd3b8.tar.bz2
Use @retval in mobilesync.c doxygen
When enumerating a list of possible return codes in doxygen, these values can be listed using @retval instead of @return. This gives a prettier output. Since doing the conversion is tedious, I've only done mobilesync.c so far.
-rw-r--r--src/mobilesync.c87
1 files changed, 49 insertions, 38 deletions
diff --git a/src/mobilesync.c b/src/mobilesync.c
index b7567f2..6dacb9b 100644
--- a/src/mobilesync.c
+++ b/src/mobilesync.c
@@ -74,9 +74,10 @@ static mobilesync_error_t mobilesync_error(device_link_service_error_t err)
* @param client Pointer that will be set to a newly allocated
* mobilesync_client_t upon successful return.
*
- * @return MOBILESYNC_E_SUCCESS on success, MOBILESYNC_E_INVALID ARG if one
- * or more parameters are invalid, or DEVICE_LINK_SERVICE_E_BAD_VERSION if
- * the mobilesync version on the device is newer.
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID ARG if one or more parameters are invalid
+ * @retval DEVICE_LINK_SERVICE_E_BAD_VERSION if the mobilesync version on
+ * the device is newer.
*/
mobilesync_error_t mobilesync_client_new(idevice_t device, uint16_t port,
mobilesync_client_t * client)
@@ -114,8 +115,8 @@ mobilesync_error_t mobilesync_client_new(idevice_t device, uint16_t port,
*
* @param client The mobilesync client to disconnect and free.
*
- * @return MOBILESYNC_E_SUCCESS on success, or MOBILESYNC_E_INVALID_ARG
- * if client is NULL.
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID_ARG if client is NULL.
*/
mobilesync_error_t mobilesync_client_free(mobilesync_client_t client)
{
@@ -173,11 +174,12 @@ mobilesync_error_t mobilesync_send(mobilesync_client_t client, plist_t plist)
* @param sync_type A pointer to store the sync type reported by the device_anchor
* @param device_data_class_version The version of the data class storage on the device
*
- * @return MOBILESYNC_E_SUCCESS on success, MOBILESYNC_E_INVALID_ARG if
- * one of the parameters is invalid, MOBILESYNC_E_PLIST_ERROR if
- * the received plist is not of valid form, MOBILESYNC_E_SYNC_REFUSED if the
- * device refused to sync or MOBILESYNC_E_CANCELLED if the device explicitly
- * cancelled the sync request
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID_ARG if one of the parameters is invalid
+ * @retval MOBILESYNC_E_PLIST_ERROR if the received plist is not of valid form
+ * @retval MOBILESYNC_E_SYNC_REFUSED if the device refused to sync
+ * @retval MOBILESYNC_E_CANCELLED if the device explicitly cancelled the
+ * sync request
*/
mobilesync_error_t mobilesync_start(mobilesync_client_t client, const char *data_class, mobilesync_anchors_t anchors, uint64_t computer_data_class_version, mobilesync_sync_type_t *sync_type, uint64_t *device_data_class_version)
{
@@ -313,9 +315,10 @@ mobilesync_error_t mobilesync_start(mobilesync_client_t client, const char *data
*
* @param client The mobilesync client
*
- * @return MOBILESYNC_E_SUCCESS on success, MOBILESYNC_E_INVALID_ARG if
- * one of the parameters is invalid, MOBILESYNC_E_PLIST_ERROR if
- * the received plist is not of valid form
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID_ARG if one of the parameters is invalid
+ * @retval MOBILESYNC_E_PLIST_ERROR if the received plist is not of valid
+ * form
*/
mobilesync_error_t mobilesync_finish(mobilesync_client_t client)
{
@@ -409,8 +412,8 @@ static mobilesync_error_t mobilesync_get_records(mobilesync_client_t client, con
*
* @param client The mobilesync client
*
- * @return MOBILESYNC_E_SUCCESS on success, MOBILESYNC_E_INVALID_ARG if
- * one of the parameters is invalid
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID_ARG if one of the parameters is invalid
*/
mobilesync_error_t mobilesync_get_all_records_from_device(mobilesync_client_t client)
{
@@ -424,8 +427,8 @@ mobilesync_error_t mobilesync_get_all_records_from_device(mobilesync_client_t cl
*
* @param client The mobilesync client
*
- * @return MOBILESYNC_E_SUCCESS on success, MOBILESYNC_E_INVALID_ARG if
- * one of the parameters is invalid
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID_ARG if one of the parameters is invalid
*/
mobilesync_error_t mobilesync_get_changes_from_device(mobilesync_client_t client)
{
@@ -440,9 +443,10 @@ mobilesync_error_t mobilesync_get_changes_from_device(mobilesync_client_t client
* @param is_last_record A pointer to store a flag indiciating if this submission is the last one
* @param actions A pointer to additional flags the device is sending or NULL to ignore
*
- * @return MOBILESYNC_E_SUCCESS on success, MOBILESYNC_E_INVALID_ARG if
- * one of the parameters is invalid, MOBILESYNC_E_CANCELLED if the device
- * explicitly cancelled the session
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID_ARG if one of the parameters is invalid
+ * @retval MOBILESYNC_E_CANCELLED if the device explicitly cancelled the
+ * session
*/
mobilesync_error_t mobilesync_receive_changes(mobilesync_client_t client, plist_t *entities, uint8_t *is_last_record, plist_t *actions)
{
@@ -516,8 +520,8 @@ mobilesync_error_t mobilesync_receive_changes(mobilesync_client_t client, plist_
*
* @param client The mobilesync client
*
- * @return MOBILESYNC_E_SUCCESS on success, MOBILESYNC_E_INVALID_ARG if
- * one of the parameters is invalid
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID_ARG if one of the parameters is invalid
*/
mobilesync_error_t mobilesync_acknowledge_changes_from_device(mobilesync_client_t client)
{
@@ -560,12 +564,15 @@ static plist_t create_process_changes_message(const char *data_class, plist_t en
*
* @param client The mobilesync client
*
- * @return MOBILESYNC_E_SUCCESS on success, MOBILESYNC_E_INVALID_ARG if
- * one of the parameters is invalid, MOBILESYNC_E_PLIST_ERROR if
- * the received plist is not of valid form, MOBILESYNC_E_WRONG_DIRECTION if the
- * current sync direction does not permit this call, MOBILESYNC_E_CANCELLED if
- * the device explicitly cancelled the session or MOBILESYNC_E_NOT_READY if the
- * device is not ready to start receiving any changes
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID_ARG if one of the parameters is invalid
+ * @retval MOBILESYNC_E_PLIST_ERROR if the received plist is not of valid form
+ * @retval MOBILESYNC_E_WRONG_DIRECTION if the current sync direction does
+ * not permit this call
+ * @retval MOBILESYNC_E_CANCELLED if the device explicitly cancelled the
+ * session
+ * @retval MOBILESYNC_E_NOT_READY if the device is not ready to start
+ * receiving any changes
*/
mobilesync_error_t mobilesync_ready_to_send_changes_from_computer(mobilesync_client_t client)
{
@@ -639,9 +646,10 @@ mobilesync_error_t mobilesync_ready_to_send_changes_from_computer(mobilesync_cli
* @param actions Additional actions for the device created with mobilesync_actions_new()
* or NULL if no actions should be passed
*
- * @return MOBILESYNC_E_SUCCESS on success, MOBILESYNC_E_INVALID_ARG if
- * one of the parameters is invalid, MOBILESYNC_E_WRONG_DIRECTION if the
- * current sync direction does not permit this call
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID_ARG if one of the parameters is invalid,
+ * @retval MOBILESYNC_E_WRONG_DIRECTION if the current sync direction does
+ * not permit this call
*/
mobilesync_error_t mobilesync_send_changes(mobilesync_client_t client, plist_t entities, uint8_t is_last_record, plist_t actions)
{
@@ -677,11 +685,14 @@ mobilesync_error_t mobilesync_send_changes(mobilesync_client_t client, plist_t e
* @param client The mobilesync client
* @param mapping A pointer to an array plist containing a dict of identifier remappings
*
- * @return MOBILESYNC_E_SUCCESS on success, MOBILESYNC_E_INVALID_ARG if
- * one of the parameters is invalid, MOBILESYNC_E_PLIST_ERROR if
- * the received plist is not of valid form, MOBILESYNC_E_WRONG_DIRECTION if the
- * current sync direction does not permit this call or MOBILESYNC_E_CANCELLED if
- * the device explicitly cancelled the session
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID_ARG if one of the parameters is invalid
+ * @retval MOBILESYNC_E_PLIST_ERROR if the received plist is not of valid
+ * form
+ * @retval MOBILESYNC_E_WRONG_DIRECTION if the current sync direction does
+ * not permit this call
+ * @retval MOBILESYNC_E_CANCELLED if the device explicitly cancelled the
+ * session
*/
mobilesync_error_t mobilesync_remap_identifiers(mobilesync_client_t client, plist_t *mapping)
{
@@ -758,8 +769,8 @@ mobilesync_error_t mobilesync_remap_identifiers(mobilesync_client_t client, plis
* @param client The mobilesync client
* @param reason The reason to supply to the device for cancelling
*
- * @return MOBILESYNC_E_SUCCESS on success, MOBILESYNC_E_INVALID_ARG if
- * one of the parameters is invalid
+ * @retval MOBILESYNC_E_SUCCESS on success
+ * @retval MOBILESYNC_E_INVALID_ARG if one of the parameters is invalid
*/
mobilesync_error_t mobilesync_cancel(mobilesync_client_t client, const char* reason)
{