diff -ur globus_gass_transfer-3.4.orig/library/globus_gass_transfer_client.c globus_gass_transfer-3.4/library/globus_gass_transfer_client.c
--- globus_gass_transfer-3.4.orig/library/globus_gass_transfer_client.c 2006-01-19 06:54:50.000000000 +0100
+++ globus_gass_transfer-3.4/library/globus_gass_transfer_client.c 2009-06-14 09:26:35.000000000 +0200
@@ -533,11 +533,6 @@
* The length of the data to append to the url, if known. If this
* parameter is set to @a GLOBUS_GASS_LENGTH_UNKNOWN, then the append
* may fail if the protocol does not support arbitrarily-length files.
- * @param callback
- * Function to call once the URL has been accepted, referred, or
- * denied by the server.
- * @param user_arg
- * User-supplied argument to the callback function.
*
* @retval GLOBUS_SUCCESS
* The put was successfully initiated.
diff -ur globus_gass_transfer-3.4.orig/library/globus_gass_transfer.h globus_gass_transfer-3.4/library/globus_gass_transfer.h
--- globus_gass_transfer-3.4.orig/library/globus_gass_transfer.h 2006-01-19 06:54:50.000000000 +0100
+++ globus_gass_transfer-3.4/library/globus_gass_transfer.h 2009-06-14 09:39:51.000000000 +0200
@@ -47,8 +47,8 @@
* simple protocol-independent API.
*
* The GASS Transfer API provides a way to implement both
- * @link globus_gass_transfer_client client @endlink and
- * @link globus_gass_transfer_server server @endlink
+ * @link globus_gass_transfer_client client@endlink and
+ * @link globus_gass_transfer_server server@endlink
* components. These share common data block and request management
* functionality. Client-specific functions are provided to implement file
* "get", "put", and "append" operations. Server-specific functions are
@@ -62,7 +62,7 @@
* server-side support for the http and https protocols.
* An application which requires additional
* protocol support may add this through the @link
- * globus_gass_transfer_protocol protocol module interface @endlink.
+ * globus_gass_transfer_protocol protocol module interface@endlink.
*
* The GASS Transfer API is defined in the header file
* "globus_gass_transfer.h"
@@ -122,9 +122,9 @@
* For server operations, the request is initialized by calling
* globus_gass_transfer_accept().
*
- * The functions in the @link globus_gass_transfer_request request section
- * @endlink of this manual describe the functions available for accessing
- * information from a request handle.
+ * The functions in the @link globus_gass_transfer_request request
+ * section@endlink of this manual describe the functions available for
+ * accessing information from a request handle.
*
* Each request handle should be destroyed by calling
* globus_gass_transfer_request_destroy() once the user has completed
@@ -340,7 +340,7 @@
* file transfers. The operations supported by the GASS Transfer API
* are file get, put, and append. These operations are provided for
* HTTP, and HTTPS file servers. The @link
- * globus_gass_transfer_protocol protocol module interface @endlink
+ * globus_gass_transfer_protocol protocol module interface@endlink
* allows support for additional protocols to be added
* easily.
*
diff -ur globus_gass_transfer-3.4.orig/library/globus_gass_transfer_proto.c globus_gass_transfer-3.4/library/globus_gass_transfer_proto.c
--- globus_gass_transfer-3.4.orig/library/globus_gass_transfer_proto.c 2006-01-19 06:54:50.000000000 +0100
+++ globus_gass_transfer-3.4/library/globus_gass_transfer_proto.c 2009-06-14 09:36:49.000000000 +0200
@@ -150,9 +150,9 @@
* This function notifies the GASS Transfer Library that the protocol module
* has decided that a new request can be accepted on this particular listener.
* It must only be called after the GASS Transfer Library has called the
- * @link globus_gass_transfer_listener_proto_t::listen listen function @endlink
+ * @link globus_gass_transfer_listener_proto_s::listen listen function@endlink
* in a @link #globus_gass_transfer_listener_proto_t protocol module-specific
- * listener structure.
+ * listener structure@endlink.
*
* @param listener
* The listener handle which is now ready for accepting a new
diff -ur globus_gass_transfer-3.4.orig/library/globus_gass_transfer_proto.h globus_gass_transfer-3.4/library/globus_gass_transfer_proto.h
--- globus_gass_transfer-3.4.orig/library/globus_gass_transfer_proto.h 2006-01-19 06:54:50.000000000 +0100
+++ globus_gass_transfer-3.4/library/globus_gass_transfer_proto.h 2009-06-14 10:14:51.000000000 +0200
@@ -65,8 +65,8 @@
* must be called after the #GLOBUS_GASS_TRANSFER_MODULE has already been
* activated. Once registered, applications may use URLs of the scheme type
* provided by the protocol module for the standard @link
- * globus_gass_transfer_client client @endlink or @link
- * globus_gass_transfer_server server @endlink operations.
+ * globus_gass_transfer_client client@endlink or @link
+ * globus_gass_transfer_server server@endlink operations.
*/
#ifndef GLOBUS_GASS_INCLUDE_GLOBUS_GASS_PROTO_H
@@ -88,9 +88,17 @@
EXTERN_C_BEGIN
/* Module-specific types */
+/**
+ * Protocol module request handling structure.
+ * @ingroup globus_gass_transfer_protocol
+ * @see #globus_gass_transfer_request_proto_s */
typedef struct globus_gass_transfer_request_proto_s
globus_gass_transfer_request_proto_t;
+/**
+ * Protocol module listener handling structure.
+ * @ingroup globus_gass_transfer_protocol
+ * @see #globus_gass_transfer_listener_proto_s */
typedef struct globus_gass_transfer_listener_proto_s
globus_gass_transfer_listener_proto_t;
@@ -223,7 +231,7 @@
* A protocol-specific attribute set, created by calling the
* protocol module's
* @link globus_gass_transfer_proto_descriptor_t::new_requestattr
- * new_requestattr function pointer @endlink.
+ * new_requestattr function pointer@endlink.
*/
typedef void
(* globus_gass_transfer_proto_new_request_t)(
@@ -246,7 +254,7 @@
* A protocol-specific attribute set, created by calling the
* protocol module's
* @link globus_gass_transfer_proto_descriptor_t::new_listenerattr
- * new_listenerattr function pointer @endlink.
+ * new_listenerattr function pointer@endlink.
* @param scheme
* The URL scheme that the server has requested for the new listener.
* This will be one the scheme associated with a particular
@@ -368,16 +376,16 @@
globus_gass_transfer_requestattr_t * attr);
/**
- * @struct globus_gass_transfer_request_proto_t
+ * @struct globus_gass_transfer_request_proto_s
* Protocol module request handling structure.
* @ingroup globus_gass_transfer_protocol
*
* This structure is created by a GASS transfer protocol module to
* handle a particular request. It is created in response to a
- * @link globus_gass_transfer_listener_proto_t::accept
- * listener's accept method @endlink or a @link
+ * @link globus_gass_transfer_listener_proto_s::accept
+ * listener's accept method@endlink or a @link
* globus_gass_transfer_proto_descriptor_t::new_request
- * protocol module's new_request method @endlink.
+ * protocol module's new_request method@endlink.
*
* Memory management of this structure is the responsibility of the protocol
* module. The destroy method will be called when the GASS Transfer library
@@ -431,7 +439,7 @@
};
/**
- * @struct globus_gass_transfer_listener_proto_t
+ * @struct globus_gass_transfer_listener_proto_s
* Protocol module listener handling structure.
* @ingroup globus_gass_transfer_protocol
*/
diff -ur globus_gass_transfer-3.4.orig/library/globus_gass_transfer_request.c globus_gass_transfer-3.4/library/globus_gass_transfer_request.c
--- globus_gass_transfer-3.4.orig/library/globus_gass_transfer_request.c 2006-01-19 06:54:50.000000000 +0100
+++ globus_gass_transfer-3.4/library/globus_gass_transfer_request.c 2009-06-14 09:38:41.000000000 +0200
@@ -41,7 +41,7 @@
* @param request
* The request to query.
*
- * @return The @link #globus_gass_transfer_request_type_t type @endlink
+ * @return The @link #globus_gass_transfer_request_type_t type@endlink
* of the request.
*/
globus_gass_transfer_request_type_t
@@ -627,9 +627,9 @@
*
* @param request
* The request to destroy.
- * @param GLOBUS_SUCCESS
+ * @retval GLOBUS_SUCCESS
* The request handle reference was successfully destroyed.
- * @param GLOBUS_GASS_TRANSFER_ERROR_INVALID_USE
+ * @retval GLOBUS_GASS_TRANSFER_ERROR_INVALID_USE
* Either an invalid request handle or one which is actively being
* used was passed to this function as the @a request parameter.
*/
diff -ur globus_gass_transfer-3.4.orig/library/globus_gass_transfer_server.c globus_gass_transfer-3.4/library/globus_gass_transfer_server.c
--- globus_gass_transfer-3.4.orig/library/globus_gass_transfer_server.c 2006-01-19 06:54:50.000000000 +0100
+++ globus_gass_transfer-3.4/library/globus_gass_transfer_server.c 2009-06-14 09:26:35.000000000 +0200
@@ -302,6 +302,8 @@
* @param request
* A pointer to a new request handle. This request handle will
* be initialized when the callback function is invoked.
+ * @param attr
+ * Request attributes.
* @param listener
* The listener handle to register for the new request.
* @param callback