diff -ur globus_gram_client-10.4.orig/globus_gram_client_attr.c globus_gram_client-10.4/globus_gram_client_attr.c
--- globus_gram_client-10.4.orig/globus_gram_client_attr.c 2009-11-19 03:01:59.000000000 +0100
+++ globus_gram_client-10.4/globus_gram_client_attr.c 2011-06-05 10:09:12.042143957 +0200
@@ -33,7 +33,7 @@
* @ingroup globus_gram_client_attr
*
* @details
- * The @a globus_gram_client_attr_init() function creates a new opaque
+ * The globus_gram_client_attr_init() function creates a new opaque
* structure that can be used to specify custom attributes for performing
* GRAM client operations.
*
@@ -42,9 +42,9 @@
* attribute.
*
* @return
- * Upon success, @a globus_gram_client_attr_init() modifies the @a attr
+ * Upon success, globus_gram_client_attr_init() modifies the @a attr
* parameter to point to a new GRAM client attribute and returns
- * @a GLOBUS_SUCCESS. If an error occurs, @a globus_gram_client_attr_init()
+ * @a GLOBUS_SUCCESS. If an error occurs, globus_gram_client_attr_init()
* returns an integer error code and value of @a attr is undefined.
*
* @retval GLOBUS_SUCCESS
@@ -84,7 +84,7 @@
* @ingroup globus_gram_client_attr
*
* @details
- * The @a globus_gram_client_attr_destroy() function destroys and frees
+ * The globus_gram_client_attr_destroy() function destroys and frees
* a GRAM client attribute. After this function returns, the value pointed
* to by @a attr is no longer valid and must not be used.
*
@@ -93,9 +93,9 @@
* the attribute will be freed and it will be an invalid attribute.
*
* @return
- * Upon success, @a globus_gram_client_attr_destroy() destroys the
+ * Upon success, globus_gram_client_attr_destroy() destroys the
* attribute pointed to by the @a attr parameter and sets it to an invalid
- * state. If an error occurs, @a globus_gram_client_attr_destroy()
+ * state. If an error occurs, globus_gram_client_attr_destroy()
* returns an integer error code and value of @a attr is unchanged.
*
* @retval GLOBUS_SUCCESS
@@ -138,7 +138,7 @@
* @ingroup globus_gram_client_attr
*
* @details
- * The @a globus_gram_client_attr_set_credential() function sets the
+ * The globus_gram_client_attr_set_credential() function sets the
* value of the @b credential in an attribute to the GSSAPI credential
* named by the @a credential parameter. This is done as a shallow copy, so
* the value of @a credential must not be freed until the attribute will
@@ -153,10 +153,10 @@
* to use the default security credential.
*
* @return
- * Upon success, @a globus_gram_client_attr_set_credential() modifies the
+ * Upon success, globus_gram_client_attr_set_credential() modifies the
* the attribute pointed to by the @a attr parameter to use the credential
* specified by the @a credential parameter and returns @a GLOBUS_SUCCESS.
- * If an error occurs, @a globus_gram_client_attr_set_credential()
+ * If an error occurs, globus_gram_client_attr_set_credential()
* returns an integer error code and the attribute named by @a attr is
* unchanged.
*
@@ -190,7 +190,7 @@
* @ingroup globus_gram_client_attr
*
* @details
- * The @a globus_gram_client_attr_get_credential() function gets the
+ * The globus_gram_client_attr_get_credential() function gets the
* value of the @b credential in an attribute and modifies the @a credential
* parameter to point to it. This is a shallow copy.
*
@@ -201,11 +201,11 @@
* credential which the @a attr is currently using.
*
* @return
- * Upon success, @a globus_gram_client_attr_get_credential() modifies the
+ * Upon success, globus_gram_client_attr_get_credential() modifies the
* the value pointed to by the @a credential parameter to be the same
* credential as that being used by the attribute named by the @a attr
* parameter and returns @a GLOBUS_SUCCESS.
- * If an error occurs, @a globus_gram_client_attr_get_credential()
+ * If an error occurs, globus_gram_client_attr_get_credential()
* returns an integer error code and the value pointed to by the
* @a credential parameter is undefined.
*
@@ -251,7 +251,7 @@
* @ingroup globus_gram_client_attr
*
* @details
- * The @a globus_gram_client_attr_set_delegation_mode() function sets the
+ * The globus_gram_client_attr_set_delegation_mode() function sets the
* value of the @b delegation_mode in an attribute to the delegation mode
* in the @a mode parameter.
*
@@ -266,10 +266,10 @@
* The new value of the delegation mode.
*
* @return
- * Upon success, @a globus_gram_client_attr_set_delegation_mode() modifies
+ * Upon success, globus_gram_client_attr_set_delegation_mode() modifies
* the the attribute named by the @a attr parameter to use the delegation
* mode in the @a mode parameter and returns GLOBUS_SUCCESS.
- * If an error occurs, @a globus_gram_client_attr_set_delegation_mode()
+ * If an error occurs, globus_gram_client_attr_set_delegation_mode()
* returns an integer error code and the @a delegation_mode attribute
* value is unchanged.
*
@@ -310,7 +310,7 @@
* @ingroup globus_gram_client_attr
*
* @details
- * The @a globus_gram_client_attr_get_delegation_mode() function gets the
+ * The globus_gram_client_attr_get_delegation_mode() function gets the
* value of the @b delegation_mode in an attribute and modifies the
* @a mode parameter to point to its value.
*
@@ -321,10 +321,10 @@
* which the @a attr is currently using.
*
* @return
- * Upon success, @a globus_gram_client_attr_get_delegation_mode() modifies
+ * Upon success, globus_gram_client_attr_get_delegation_mode() modifies
* the the value pointed to by the @a mode parameter as described above
* and returns @a GLOBUS_SUCCESS.
- * If an error occurs, @a globus_gram_client_attr_get_delegation_mode()
+ * If an error occurs, globus_gram_client_attr_get_delegation_mode()
* returns an integer error code and the value pointed to by the
* @a mode parameter is undefined.
*
diff -ur globus_gram_client-10.4.orig/globus_gram_client.c globus_gram_client-10.4/globus_gram_client.c
--- globus_gram_client-10.4.orig/globus_gram_client.c 2010-05-03 14:58:14.000000000 +0200
+++ globus_gram_client-10.4/globus_gram_client.c 2011-06-05 10:09:12.064143664 +0200
@@ -342,7 +342,7 @@
* @ingroup globus_gram_client
*
* @details
- * The @a globus_gram_client_debug() function enables
+ * The globus_gram_client_debug() function enables
* the displaying of internal GRAM debug messages to standard output. Most
* of the information printed by this debugging system is related to errors
* that occur during GRAM Client API functions. The messages printed to
@@ -691,7 +691,7 @@
* @ingroup globus_gram_client
*
* @details
- * The @a globus_gram_client_version() function returns the version of the
+ * The globus_gram_client_version() function returns the version of the
* GRAM protocol understood by this implementation.
*
* @return The integer protocol revision.
@@ -709,7 +709,7 @@
* @ingroup globus_gram_client
*
* @details
- * The @a globus_gram_client_set_credentials() function causes subsequent
+ * The globus_gram_client_set_credentials() function causes subsequent
* GRAM operations to use the GSSAPI credential @a new_credentials.
* These operations include job requests, job signals, callback registration,
* and job state callbacks. After this function returns, the caller must not
@@ -719,7 +719,7 @@
* New GSSAPI credential to use.
*
* @return
- * Upon success, @a globus_gram_client_set_credentials() returns
+ * Upon success, globus_gram_client_set_credentials() returns
* GLOBUS_SUCCESS. There are no error values returned by this fucntion.
*
* @retval GLOBUS_SUCCESS
@@ -736,13 +736,13 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_register_ping() function sends a
+ * The globus_gram_client_register_ping() function sends a
* specially-formatted GRAM protocol message which checks to
* see if a Gatekeeper is running on a given PORT, and whether that
* Gatekeeper is configured to support the desired job manager service.
* This is used for diagnostic purposes.
*
- * If @a globus_gram_client_register_ping() determines that this request could
+ * If globus_gram_client_register_ping() determines that this request could
* not be processed before contacting the gatekeeper (for example, a malformed
* @a resource_manager_contact), it will return an error, and the
* @a regiser_callback function will not be called. Otherwise, the success or
@@ -766,7 +766,7 @@
* parameter.
*
* @return
- * Upon success, @a globus_gram_client_register_ping() returns
+ * Upon success, globus_gram_client_register_ping() returns
* GLOBUS_SUCCESS and the @a register_callback function will be called once
* the ping operation completes. If an error occurs, this function returns
* an integer error code and the function pointed to by the
@@ -832,7 +832,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_ping() function sends a
+ * The globus_gram_client_ping() function sends a
* specially-formatted GRAM protocol message which checks to
* see if a Gatekeeper is running on a given PORT, and whether that
* Gatekeeper is configured to support the desired job manager service.
@@ -844,7 +844,7 @@
* this function will contact.
*
* @return
- * Upon success, @a globus_gram_client_ping() contacts the gatekeeper
+ * Upon success, globus_gram_client_ping() contacts the gatekeeper
* service and returns @a GLOBUS_SUCCESS. If an error occurs, this
* function returns an integer error code.
*
@@ -901,7 +901,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_get_jobmanager_version() function sends a message
+ * The globus_gram_client_get_jobmanager_version() function sends a message
* to a GRAM service which returns information about the job manager version
* in the value pointed to by the @a extensions parameter. Note that job
* managers prior to GT5 do not support the version request and so will return
@@ -917,7 +917,7 @@
* GRAM5 are @a toolkit-version and @a version.
*
* @return
- * Upon success, @a globus_gram_client_get_jobmanager_version() function
+ * Upon success, globus_gram_client_get_jobmanager_version() function
* returns GLOBUS_SUCCESS and modifies the @a extensions parameter as
* described above. If an error occurs, the integer error code will be
* returned and the value pointed to by the @a extensions parameter is
@@ -995,7 +995,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_register_get_jobmanager_version() function sends a
+ * The globus_gram_client_register_get_jobmanager_version() function sends a
* message to a GRAM service which returns information about the job manager
* version to the function pointed to by the @a info_callback function. Note
* that job managers prior to GT5 do not support the version request and so
@@ -1018,7 +1018,7 @@
* parameter.
*
* @return
- * Upon success, @a globus_gram_client_register_get_jobmanager_version()
+ * Upon success, globus_gram_client_register_get_jobmanager_version()
* function returns GLOBUS_SUCCESS and begins processing the version
* request to contact @a resource_manager_contact; when complete, the
* @a info_callback function will be called.
@@ -1093,11 +1093,11 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_register_job_request() function sends a
+ * The globus_gram_client_register_job_request() function sends a
* GRAM protocol message to a service to request that it start a job on behalf
* of the client.
*
- * If @a globus_gram_client_register_job_request() determines that this request
+ * If globus_gram_client_register_job_request() determines that this request
* could not be processed before contacting the gatekeeper (for example, a
* malformed @a resource_manager_contact), it will return an error, and the
* @a regiser_callback function will not be called. Otherwise, the success or
@@ -1131,7 +1131,7 @@
* parameter.
*
* @return
- * Upon success, @a globus_gram_client_register_job_request() returns
+ * Upon success, globus_gram_client_register_job_request() returns
* GLOBUS_SUCCESS and the @a register_callback function will be called once
* the job request operation completes. If an error occurs, this function
* returns an integer error code and the function pointed to by the
@@ -1200,10 +1200,10 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_job_request() function sends a
+ * The globus_gram_client_job_request() function sends a
* GRAM protocol message to a service to request that it start a job on behalf
- * of the client. Unlike, @a globus_gram_client_register_job_request(),
- * @a globus_gram_client_job_request() blocks until the job
+ * of the client. Unlike, globus_gram_client_register_job_request(),
+ * globus_gram_client_job_request() blocks until the job
* request has been processed by the service.
*
* @param resource_manager_contact
@@ -1227,7 +1227,7 @@
* and the return code is @a GLOBUS_GRAM_PROTOCOL_ERROR_WAITING_FOR_COMMIT.
*
* @return
- * Upon success, @a globus_gram_client_job_request() returns
+ * Upon success, globus_gram_client_job_request() returns
* GLOBUS_SUCCESS and modifies the value pointed to by @a job_contact as
* described above. If an error occurs, this function
* returns an integer error code and the value pointed to by
@@ -1307,11 +1307,11 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_register_job_request_with_info() function sends a
+ * The globus_gram_client_register_job_request_with_info() function sends a
* GRAM protocol message to a service to request that it start a job on behalf
* of the client.
*
- * If @a globus_gram_client_register_job_request_with_info() determines that
+ * If globus_gram_client_register_job_request_with_info() determines that
* this request could not be processed before contacting the gatekeeper (for
* example, a malformed @a resource_manager_contact), it will return an error,
* and the @a callback function will not be called. Otherwise, the
@@ -1348,7 +1348,7 @@
* parameter.
*
* @return
- * Upon success, @a globus_gram_client_register_job_request_with_info()
+ * Upon success, globus_gram_client_register_job_request_with_info()
* returns GLOBUS_SUCCESS and the @a callback function will be
* called once the job request operation completes. If an error occurs,
* this function returns an integer error code and the function pointed to
@@ -1416,11 +1416,11 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_job_request_with_info() function sends a
+ * The globus_gram_client_job_request_with_info() function sends a
* GRAM protocol message to a service to request that it start a job on behalf
* of the client. Unlike,
- * @a globus_gram_client_register_job_request_with_info(),
- * @a globus_gram_client_job_request_with_info() blocks until the job
+ * globus_gram_client_register_job_request_with_info(),
+ * globus_gram_client_job_request_with_info() blocks until the job
* request has been processed by the service.
*
* @param resource_manager_contact
@@ -1445,10 +1445,10 @@
* @param info
* An output parameter pointing to a structure to hold the extensions in
* the GRAM response. The caller is responsible for destroying this by
- * calling the @a globus_gram_client_job_info_destroy() function.
+ * calling the globus_gram_client_job_info_destroy() function.
*
* @return
- * Upon success, @a globus_gram_client_job_request_with_info() returns
+ * Upon success, globus_gram_client_job_request_with_info() returns
* GLOBUS_SUCCESS and modifies the values pointed to by @a job_contact and
* @a info as described above. If an error occurs, this function
* returns an integer error code and the value pointed to by
@@ -1531,7 +1531,7 @@
* @ingroup globus_gram_client
*
* @details
- * The @a globus_gram_client_error_string() function takes a GRAM error code
+ * The globus_gram_client_error_string() function takes a GRAM error code
* value and returns the associated error code string. The string is statically
* allocated by the Globus GRAM Client library and should not be modified or
* freed. The string is intended to complete a sentence of the form
@@ -1541,7 +1541,7 @@
* The error code to translate into a string.
*
* @return
- * The @a globus_gram_client_error_string() function returns a static
+ * The globus_gram_client_error_string() function returns a static
* string containing an explanation of the error.
*
*/
@@ -1642,14 +1642,14 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_job_cancel() function cancels a
+ * The globus_gram_client_job_cancel() function cancels a
* GRAM job. Depending on the job's current state, this cancellation may be
* immediate or require a delay for interacting with the LRM servicing the
* job. Notification when the job has been successfully canceled will be
* sent to all client contacts registered for notifications after the
* cancellation has been completely processed. Unlike,
- * @a globus_gram_client_register_job_cancel(),
- * @a globus_gram_client_job_cancel() blocks until the job
+ * globus_gram_client_register_job_cancel(),
+ * globus_gram_client_job_cancel() blocks until the job
* cancel request has been processed by the service.
*
@@ -1658,9 +1658,9 @@
* GRAM job contact that this function will contact to cancel the job.
*
* @return
- * Upon succes, @a globus_gram_client_job_cancel() returns
+ * Upon succes, globus_gram_client_job_cancel() returns
* @a GLOBUS_SUCCESS if the cancellation was successful posted to the
- * service. If an error occurs, @a globus_gram_client_job_cancel()
+ * service. If an error occurs, globus_gram_client_job_cancel()
* returns one of the #globus_gram_protocol_error_t values
* values indicating why the client could not cancel the job.
*
@@ -1715,7 +1715,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_register_job_cancel() function sends a message
+ * The globus_gram_client_register_job_cancel() function sends a message
* to a GRAM service to cancel a GRAM job. Depending on the job's current
* state, this cancellation may be immediate or require a delay for
* interacting with the LRM servicing the job. In either case, this function
@@ -1740,9 +1740,9 @@
* parameter.
*
* @return
- * Upon succes, @a globus_gram_client_register_job_cancel() returns
+ * Upon succes, globus_gram_client_register_job_cancel() returns
* @a GLOBUS_SUCCESS if the cancellation was successful posted to the
- * service. If an error occurs, @a globus_gram_client_register_job_cancel()
+ * service. If an error occurs, globus_gram_client_register_job_cancel()
* returns one an integer error code indicating why it could not cancel the
* job.
*
@@ -1808,12 +1808,12 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_job_signal() function sends a signal message to
+ * The globus_gram_client_job_signal() function sends a signal message to
* a job managed by the GRAM service.
* Signals consist of a signal number and an optional string
* argument. The meanings of the signals supported by the GRAM job manager
* are defined in the GRAM Protocol documentation.
- * Unlike @a globus_gram_client_register_job_signal(), this function blocks
+ * Unlike globus_gram_client_register_job_signal(), this function blocks
* until the signal has been delivered and acknowledged by the GRAM service.
*
* @param job_contact
@@ -1833,7 +1833,7 @@
* set to @a GLOBUS_GRAM_PROTOCOL_JOB_STATE_FAILED by this function.
*
* @return
- * Upon success, @a globus_gram_client_job_signal() returns GLOBUS_SUCCESS
+ * Upon success, globus_gram_client_job_signal() returns GLOBUS_SUCCESS
* after sending the signal and receiving a response and modifies the
* @a job_status and @a failure_code parameters as described above. If an
* error occurs, this function returns an integer error code indicating
@@ -1960,7 +1960,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_register_job_signal() function sends a signal
+ * The globus_gram_client_register_job_signal() function sends a signal
* message to a job managed by the GRAM service.
* Signals consist of a signal number and an optional string
* argument. The meanings of the signals supported by the GRAM job manager
@@ -1989,7 +1989,7 @@
* parameter.
*
* @return
- * Upon success, @a globus_gram_client_job_register_signal() returns
+ * Upon success, globus_gram_client_job_register_signal() returns
* GLOBUS_SUCCESS after beginnning to send the signal to the GRAM job and
* registers the @a register_callback function to be called once that
* has completed. If an error occurs, this function returns an integer
@@ -2094,7 +2094,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_status() function queries the current status of
+ * The globus_gram_client_status() function queries the current status of
* the job associated with the job contact,
* returning its current status, as well as the job's failure reason if it has
* failed in this function's return parameters. This function blocks until
@@ -2113,11 +2113,11 @@
* the value will be set to 0.
*
* @return
- * Upon success, the @a globus_gram_client_job_status() function returns
+ * Upon success, the globus_gram_client_job_status() function returns
* @a GLOBUS_SUCCESS, sends a job state query to the job named by
* @a job_contact and parses the service response, modifying the values
* pointed to by @a job_status and @a failure_code as described above. If
- * an error occurs, @a globus_gram_client_job_status() returns an integer
+ * an error occurs, globus_gram_client_job_status() returns an integer
* error code.
*
* @retval GLOBUS_GRAM_SUCCESS
@@ -2200,7 +2200,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_register_job_status() function initiates a
+ * The globus_gram_client_register_job_status() function initiates a
* query of the current status of the job associated with the @a job contact
* parameter. The job's status and failure code are passed to the function
* pointed to by the @a register_callback parameter. This function returns
@@ -2222,12 +2222,12 @@
* parameter.
*
* @return
- * Upon success, the @a globus_gram_client_register_job_status() function
+ * Upon success, the globus_gram_client_register_job_status() function
* returns @a GLOBUS_SUCCESS and begins to send a job state query to the
* job named by @a job_contact and registers the function pointed to by
* the @a register_callback parameter to be called once the status query
* terminates or fails. If an error occurs,
- * @a globus_gram_client_register_job_status() returns an integer
+ * globus_gram_client_register_job_status() returns an integer
* error code.
*
* @retval GLOBUS_GRAM_SUCCESS
@@ -2297,7 +2297,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_register_job_status_with_info() function initiates
+ * The globus_gram_client_register_job_status_with_info() function initiates
* a query of the current status of the job associated with the @a job contact
* parameter. Job information is returned via the @a job_info parameter passed
* to the function pointed to by the @a info_callback parameter.
@@ -2319,12 +2319,12 @@
* parameter.
*
* @return
- * Upon success, the @a globus_gram_client_register_job_status_with_info()
+ * Upon success, the globus_gram_client_register_job_status_with_info()
* function returns @a GLOBUS_SUCCESS and begins to send a job state query
* to the job named by @a job_contact and registers the function pointed to
* by the @a info_callback parameter to be called once the status query
* terminates or fails. If an error occurs,
- * @a globus_gram_client_register_job_status_with_info() returns an integer
+ * globus_gram_client_register_job_status_with_info() returns an integer
* error code.
*
* @retval GLOBUS_GRAM_SUCCESS
@@ -2395,7 +2395,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_status_with_info() function queries the current
+ * The globus_gram_client_status_with_info() function queries the current
* status of the job associated with the job contact,
* returning its current status, as well as the job's failure reason if it has
* failed in this function's return parameters. This function blocks until
@@ -2413,11 +2413,11 @@
* @a GLOBUS_SUCCESS.
*
* @return
- * Upon success, the @a globus_gram_client_job_status_with_info() function
+ * Upon success, the globus_gram_client_job_status_with_info() function
* returns @a GLOBUS_SUCCESS, sends a job state query to the job named by
* @a job_contact and parses the service response, modifying the structure
* pointed to by @a info as described above. If
- * an error occurs, @a globus_gram_client_job_status_with_info() returns an
+ * an error occurs, globus_gram_client_job_status_with_info() returns an
* integer error code.
*
* @retval GLOBUS_GRAM_SUCCESS
@@ -2483,7 +2483,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_job_callback_register() function contacts a
+ * The globus_gram_client_job_callback_register() function contacts a
* GRAM service managing a job and instructs it to send subsequent job state
* callbacks to the client listening for callbacks at the contact url named
* by the @a callback_contact parameter. This function blocks until the
@@ -2499,7 +2499,7 @@
* @param callback_contact
* A URL string containing a GRAM client callback. This string is
* normally be generated by a process calling
- * @a globus_gram_client_callback_allow().
+ * globus_gram_client_callback_allow().
* @param job_status
* An output parameter pointing to an integer to set to the status
* of the job after the registration message has been processed.
@@ -2510,12 +2510,12 @@
* the value will be set to 0.
*
* @return
- * Upon success, the @a globus_gram_client_job_callback_register() function
+ * Upon success, the globus_gram_client_job_callback_register() function
* returns @a GLOBUS_SUCCESS, sends a registration request the job named by
* @a job_contact and parses the service response, modifying the values
* pointed to by the @a job_status and @a failure_code parameters as
* described above. If an error occurs,
- * @a globus_gram_client_job_callback_register() returns an
+ * globus_gram_client_job_callback_register() returns an
* integer error code indicating why it can't register the callback
* contact. The return code may be any value defined by the
* @a globus_gram_protocol_error_t enumeration in addition to those
@@ -2620,7 +2620,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_job_callback_unregister() function contacts a
+ * The globus_gram_client_job_callback_unregister() function contacts a
* GRAM service managing a job and instructs it to stop sending job state
* callbacks to the client listening for callbacks at the contact url named
* by the @a callback_contact parameter. This function blocks until the
@@ -2634,7 +2634,7 @@
* @param callback_contact
* A URL string containing a GRAM client callback. This string is
* normally be generated by a process calling
- * @a globus_gram_client_callback_allow().
+ * globus_gram_client_callback_allow().
* @param job_status
* An output parameter pointing to an integer to set to the status
* of the job after the registration message has been processed.
@@ -2645,12 +2645,12 @@
* the value will be set to 0.
*
* @return
- * Upon success, the @a globus_gram_client_job_callback_unregister()
+ * Upon success, the globus_gram_client_job_callback_unregister()
* function returns @a GLOBUS_SUCCESS, sends an unregister request the job
* named by @a job_contact and parses the service response, modifying the
* values pointed to by the @a job_status and @a failure_code parameters as
* described above. If an error occurs,
- * @a globus_gram_client_job_callback_unregister() returns an
+ * globus_gram_client_job_callback_unregister() returns an
* integer error code indicating why it can't unregister the callback
* contact. The return code may be any value defined by the
* @a globus_gram_protocol_error_t enumeration in addition to those
@@ -2755,7 +2755,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_job_refresh_credentials() function sends a
+ * The globus_gram_client_job_refresh_credentials() function sends a
* "renew" signal to a GRAM service and then initiates the delegation of
* a new credential to the job manager and job. This prevents errors that
* can occur when a credential expires. This function blocks until the
@@ -2771,12 +2771,12 @@
* process's default credential.
*
* @return
- * Upon success, the @a globus_gram_client_job_refresh_credentials()
+ * Upon success, the globus_gram_client_job_refresh_credentials()
* function returns @a GLOBUS_SUCCESS, sends an proxy renew request the job
* named by @a job_contact, parses the service response and performs a
* GSSAPI delegation to send a new credential to the job service.
* If an error occurs,
- * @a globus_gram_client_job_refresh_credentials() returns an
+ * globus_gram_client_job_refresh_credentials() returns an
* integer error code indicating why it can't refresh the job service's
* credential. The return code may be any value defined by the
* @a globus_gram_protocol_error_t enumeration in addition to those
@@ -2836,7 +2836,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_register_job_refresh_credentials() function sends
+ * The globus_gram_client_register_job_refresh_credentials() function sends
* a "renew" signal to a GRAM service and then initiates the delegation of
* a new credential to the job manager and job. This prevents errors that
* can occur when a credential expires. This function returns as
@@ -2864,10 +2864,10 @@
* parameter.
*
* @return
- * Upon success, the @a globus_gram_client_job_refresh_credentials()
+ * Upon success, the globus_gram_client_job_refresh_credentials()
* function returns @a GLOBUS_SUCCESS and begins sending the "renew"
* request to the GRAM service. If an error occurs,
- * @a globus_gram_client_job_refresh_credentials() returns an
+ * globus_gram_client_job_refresh_credentials() returns an
* integer error code indicating why it can't refresh the job service's
* credential. The return code may be any value defined by the
* @a globus_gram_protocol_error_t enumeration in addition to those
@@ -2932,7 +2932,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_register_job_callback_registration() function
+ * The globus_gram_client_register_job_callback_registration() function
* initiates the protocol to contact a GRAM service and request that it
* send subsequent job state callbacks to the client listening for callbacks at
* the contact url named by the @a callback_contact parameter. This function
@@ -2950,7 +2950,7 @@
* @param callback_contact
* A URL string containing a GRAM client callback. This string is
* normally be generated by a process calling
- * @a globus_gram_client_callback_allow().
+ * globus_gram_client_callback_allow().
* @param attr
* A set of client attributes to use to contact the job. If no
* custom attributes are needed, the caller should pass the value
@@ -2965,7 +2965,7 @@
*
* @return
* Upon success, the
- * @a globus_gram_client_register_job_callback_registration() function
+ * globus_gram_client_register_job_callback_registration() function
* returns @a GLOBUS_SUCCESS, begins to send a registration request to
* the job named by @a job_contact, and schedules the @a register_callback
* to be called once the registration completes or fails.
@@ -3059,7 +3059,7 @@
* @ingroup globus_gram_client_job_functions
*
* @details
- * The @a globus_gram_client_register_job_callback_unregistration() function
+ * The globus_gram_client_register_job_callback_unregistration() function
* initiates the protocol to contact a GRAM service and request that it
* stop sending job state callbacks to the client listening at
* the contact url named by the @a callback_contact parameter. This function
@@ -3073,7 +3073,7 @@
* @param callback_contact
* A URL string containing a GRAM client callback. This string is
* normally be generated by a process calling
- * @a globus_gram_client_callback_allow().
+ * globus_gram_client_callback_allow().
* @param attr
* A set of client attributes to use to contact the job. If no
* custom attributes are needed, the caller should pass the value
@@ -3088,12 +3088,12 @@
*
* @return
* Upon success, the
- * @a globus_gram_client_register_job_callback_unregistration()
+ * globus_gram_client_register_job_callback_unregistration()
* function returns @a GLOBUS_SUCCESS, begins sending an unregister request
* to the job named by @a job_contact and schedules the function pointed to
* by the @a register_callback parameter to be called.
* If an error occurs,
- * @a globus_gram_client_register_job_callback_unregistration() returns an
+ * globus_gram_client_register_job_callback_unregistration() returns an
* integer error code indicating why it can't process the unregister
* request.
*
@@ -3199,11 +3199,11 @@
* and set to the URL that the GRAM callback listener is waiting on.
*
* @return
- * Upon success, @a globus_gram_client_callback_allow() returns
+ * Upon success, globus_gram_client_callback_allow() returns
* @a GLOBUS_SUCCESS opens a TCP port to accept job state updates and
* modifies the value pointed to by the @a callback_contact parameter
* as described above. If an error occurs,
- * @a globus_gram_client_callback_allow() returns an integer error code.
+ * globus_gram_client_callback_allow() returns an integer error code.
*
* @retval GLOBUS_SUCCESS
* Success
@@ -3320,11 +3320,11 @@
* and set to the URL that the GRAM callback listener is waiting on.
*
* @return
- * Upon success, @a globus_gram_client_callback_allow() returns
+ * Upon success, globus_gram_client_callback_allow() returns
* @a GLOBUS_SUCCESS opens a TCP port to accept job state updates and
* modifies the value pointed to by the @a callback_contact parameter
* as described above. If an error occurs,
- * @a globus_gram_client_callback_allow() returns an integer error code.
+ * globus_gram_client_callback_allow() returns an integer error code.
*
* @retval GLOBUS_SUCCESS
* Success
@@ -3437,11 +3437,11 @@
* the current process.
*
* @return
- * Upon success, @a globus_gram_client_callback_disallow() returns
+ * Upon success, globus_gram_client_callback_disallow() returns
* @a GLOBUS_SUCCESS, closes the network port associated with the
* @a callback_contact parameter and stops further callbacks from
* occurring. If an error occurs,
- * @a globus_gram_client_callback_disallow() returns an integer error code.
+ * globus_gram_client_callback_disallow() returns an integer error code.
*
* @retval GLOBUS_SUCCESS
* Success
@@ -3494,9 +3494,9 @@
* @ingroup globus_gram_client
*
* @details
- * The @a globus_gram_client_job_contact_free() function frees a job
+ * The globus_gram_client_job_contact_free() function frees a job
* contact string that was allocated by a call to one of the functions
- * in the @a globus_gram_client_job_request() family. The free() function
+ * in the globus_gram_client_job_request() family. The free() function
* can be used in place of this function. After this function returns, the
* string pointed to by the @a job_contact parameter has an undefined value.
*
@@ -4328,7 +4328,7 @@
* @ingroup globus_gram_client
*
* @details
- * The @a globus_gram_client_job_info_destroy() function frees data pointed
+ * The globus_gram_client_job_info_destroy() function frees data pointed
* to by the @a extensions and @a job_contact fields of the
* @a globus_gram_client_job_info_t structure pointed to by the
* @a info parameter.
diff -ur globus_gram_client-10.4.orig/globus_gram_client.h globus_gram_client-10.4/globus_gram_client.h
--- globus_gram_client-10.4.orig/globus_gram_client.h 2010-02-10 12:15:20.000000000 +0100
+++ globus_gram_client-10.4/globus_gram_client.h 2011-06-05 10:09:12.066143636 +0200
@@ -75,10 +75,10 @@
* @details
* The @a globus_gram_client_callback_func_t type describes the function
* signature for job state callbacks. A pointer to a function
- * of this type is passed to the @a globus_gram_client_callback_allow()
+ * of this type is passed to the globus_gram_client_callback_allow()
* function to create a callback contact. The contact string can be passed to
- * @a globus_gram_client_job_request() or
- * @a globus_gram_client_job_callback_register() to let the job management
+ * globus_gram_client_job_request() or
+ * globus_gram_client_job_callback_register() to let the job management
* service know to where to send information on GRAM job state changes.
*
* @param user_callback_arg
@@ -86,10 +86,10 @@
* @param job_contact
* A string containing the job contact. This string indicates which job
* this callback is referring to. It should in most cases match the return
- * value @a job_contact from a call to @a globus_gram_client_job_request()
+ * value @a job_contact from a call to globus_gram_client_job_request()
* or in the @a job_contact parameter to the
* @a globus_gram_client_nonblocking_func_t used with
- * @a globus_gram_client_register_job_request(). However, in some cases,
+ * globus_gram_client_register_job_request(). However, in some cases,
* the port number in the job contact URL may change if the job manager
* is restarted.
* @param state
@@ -146,11 +146,11 @@
* The @a #globus_gram_client_info_callback_func_t type describes the function
* signature for job state callbacks that carry any GRAM protocol extensions
* beyond the set used in GRAM2. A pointer to a function
- * of this type is passed to the @a globus_gram_client_info_callback_allow()
+ * of this type is passed to the globus_gram_client_info_callback_allow()
* function to create a callback contact that can handle extensions. The
* contact string can be passed to
- * @a globus_gram_client_job_request() or
- * @a globus_gram_client_job_callback_register() to let the job management
+ * globus_gram_client_job_request() or
+ * globus_gram_client_job_callback_register() to let the job management
* service know to where to send information on GRAM job state changes.
*
* @param user_callback_arg
@@ -199,14 +199,14 @@
* signature for callbacks which indicate that a GRAM operation has completed.
* A pointer to a function of this type is passed to the
* following functions:
- * - @a globus_gram_client_register_job_request()
- * - @a globus_gram_client_register_job_cancel()
- * - @a globus_gram_client_register_job_status()
- * - @a globus_gram_client_register_job_refresh_credentials()
- * - @a globus_gram_client_register_job_signal()
- * - @a globus_gram_client_register_job_callback_registration()
- * - @a globus_gram_client_register_job_callback_unregistration()
- * - @a globus_gram_client_register_ping()
+ * - globus_gram_client_register_job_request()
+ * - globus_gram_client_register_job_cancel()
+ * - globus_gram_client_register_job_status()
+ * - globus_gram_client_register_job_refresh_credentials()
+ * - globus_gram_client_register_job_signal()
+ * - globus_gram_client_register_job_callback_registration()
+ * - globus_gram_client_register_job_callback_unregistration()
+ * - globus_gram_client_register_ping()
*
* @param user_callback_arg
* Application-specific callback information.