Reunite xdrproc_t with its comment in xdr.h

Commit 4b9d7f7c107f01a61600fddcd8cde3812d0366a2 moved the declaration
of xdrproc_t later in the file so that it could refer to XDR, but did
not move the preceding comment.  Move the comment and edit it for
accuracy.

[ghudson@mit.edu: expanded commit message; edited comment]

diff --git a/src/include/gssrpc/xdr.h b/src/include/gssrpc/xdr.h
index 4e5c29bdc2db15f96c416f13e7b7746a3ce6f130..57cd577e6241bac671a3e623bf8c55c284ec28ca 100644 (file)
--- a/src/include/gssrpc/xdr.h
+++ b/src/include/gssrpc/xdr.h
@@ -91,18 +91,6 @@ enum xdr_op {
 #define RNDUP(x)  ((((x) + BYTES_PER_XDR_UNIT - 1) / BYTES_PER_XDR_UNIT) \
                    * BYTES_PER_XDR_UNIT)
 
-/*
- * A xdrproc_t exists for each data type which is to be encoded or decoded.
- *
- * The second argument to the xdrproc_t is a pointer to an opaque pointer.
- * The opaque pointer generally points to a structure of the data type
- * to be decoded.  If this pointer is 0, then the type routines should
- * allocate dynamic storage of the appropriate size and return it.
- * bool_t      (*xdrproc_t)(XDR *, caddr_t *);
- *
- * XXX can't actually prototype it, because some take three args!!!
- */
-
 /*
  * The XDR handle.
  * Contains operation which is being applied to the stream,
@@ -142,6 +130,10 @@ typedef struct XDR {
        int             x_handy;        /* extra private word */
 } XDR;
 
+/*
+ * A xdrproc_t exists for each data type which is to be encoded or decoded.
+ * The second argument points to an object of the data type.
+ */
 typedef        bool_t (*xdrproc_t)(XDR *, void *);
 
 /*