summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorGravatar Christophe Fergeau2011-03-11 22:56:55 +0100
committerGravatar Martin Szulecki2011-03-12 03:18:22 +0100
commit559b81461e699c00b418e36e0873d2d7e0c6860c (patch)
tree1622d0061afc2fb838e5ff90ff69d9c608c96ffd /src
parent0b0ce44c138e57d7e638bd8d400ec5260c92d9c7 (diff)
downloadlibimobiledevice-559b81461e699c00b418e36e0873d2d7e0c6860c.tar.gz
libimobiledevice-559b81461e699c00b418e36e0873d2d7e0c6860c.tar.bz2
Add some doxygen markup to mobilesync API doc
Add some missing (), \a and # to let doxygen know that something is a function, a parameter name or a type. This lets doxygen formats these elements in a nicer way (by creating links, changing the font, ...)
Diffstat (limited to 'src')
-rw-r--r--src/mobilesync.c14
1 files changed, 7 insertions, 7 deletions
diff --git a/src/mobilesync.c b/src/mobilesync.c
index 4a54851..c444c8e 100644
--- a/src/mobilesync.c
+++ b/src/mobilesync.c
@@ -39,12 +39,12 @@
#define EMPTY_PARAMETER_STRING "___EmptyParameterString___"
/**
- * Convert an device_link_service_error_t value to an mobilesync_error_t value.
+ * Convert an #device_link_service_error_t value to an #mobilesync_error_t value.
* Used internally to get correct error codes when using device_link_service stuff.
*
- * @param err A device_link_service_error_t error code
+ * @param err A #device_link_service_error_t error code
*
- * @return A matching mobilesync_error_t error code,
+ * @return A matching #mobilesync_error_t error code,
* MOBILESYNC_E_UNKNOWN_ERROR otherwise.
*/
static mobilesync_error_t mobilesync_error(device_link_service_error_t err)
@@ -70,9 +70,9 @@ static mobilesync_error_t mobilesync_error(device_link_service_error_t err)
* Connects to the mobilesync service on the specified device.
*
* @param device The device to connect to.
- * @param port Destination port (usually given by lockdownd_start_service).
+ * @param port Destination port (usually given by lockdownd_start_service()).
* @param client Pointer that will be set to a newly allocated
- * mobilesync_client_t upon successful return.
+ * #mobilesync_client_t upon successful return.
*
* @retval MOBILESYNC_E_SUCCESS on success
* @retval MOBILESYNC_E_INVALID_ARG if one or more parameters are invalid
@@ -116,7 +116,7 @@ mobilesync_error_t mobilesync_client_new(idevice_t device, uint16_t port,
* @param client The mobilesync client to disconnect and free.
*
* @retval MOBILESYNC_E_SUCCESS on success
- * @retval MOBILESYNC_E_INVALID_ARG if client is NULL.
+ * @retval MOBILESYNC_E_INVALID_ARG if \a client is NULL.
*/
mobilesync_error_t mobilesync_client_free(mobilesync_client_t client)
{
@@ -805,7 +805,7 @@ mobilesync_error_t mobilesync_cancel(mobilesync_client_t client, const char* rea
* if none is known yet which for instance is true on first synchronization.
* @param computer_anchor An arbitrary string to use as anchor for the computer.
*
- * @return A new mobilesync_anchors_t struct. Must be freed using mobilesync_anchors_free().
+ * @return A new #mobilesync_anchors_t struct. Must be freed using mobilesync_anchors_free().
*/
mobilesync_anchors_t mobilesync_anchors_new(const char *device_anchor, const char *computer_anchor)
{