Not that hard to explain...

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1670805 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/include/httpd.h b/include/httpd.h
index 44b50a1d7a5e82292c9ce3519b6dd8c265540603..64ab325de8d43c985d8f0f38131248e003db48f0 100644 (file)
--- a/include/httpd.h
+++ b/include/httpd.h
@@ -953,8 +953,9 @@ struct request_rec {
     char *uri;
     /** The filename on disk corresponding to this response */
     char *filename;
-    /* XXX: What does this mean? Please define "canonicalize" -aaron */
-    /** The true filename, we canonicalize r->filename if these don't match */
+    /** The true filename stored in the filesystem, as in the true alpha case
+     *  and alias correction, e.g. "Image.jpeg" not "IMAGE$1.JPE" on Windows.
+     *  The core map_to_storage canonicalizes r->filename when they mismatch */
     char *canonical_filename;
     /** The PATH_INFO extracted from this request */
     char *path_info;