Try to clarify what client_ip/client_addr means and point to useragent_ip

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1331115 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/include/httpd.h b/include/httpd.h
index ef5f26227add12928547a0fa8faf4d6f18254b95..c63747b889bf1ca9f76782c733dc445a62f6022e 100644 (file)
--- a/include/httpd.h
+++ b/include/httpd.h
@@ -1019,6 +1019,7 @@ struct request_rec {
 
     /** remote address information from conn_rec, can be overridden if
      * necessary by a module.
+     * This is the address that originated the request.
      */
     apr_sockaddr_t *useragent_addr;
     char *useragent_ip;
@@ -1064,10 +1065,14 @@ struct conn_rec {
     /* Information about the connection itself */
     /** local address */
     apr_sockaddr_t *local_addr;
-    /** remote address */
+    /** remote address; this is the end-point of the next hop, for the address
+     *  of the request creator, see useragent_addr in request_rec
+     */
     apr_sockaddr_t *client_addr;
 
-    /** Client's IP address */
+    /** Client's IP address; this is the end-point of the next hop, for the
+     *  IP of the request creator, see useragent_ip in request_rec
+     */
     char *client_ip;
     /** Client's DNS name, if known.  NULL if DNS hasn't been checked,
      *  "" if it has and no address was found.  N.B. Only access this though