From: William A. Rowe Jr <wrowe@apache.org>
Date: Thu, 2 Apr 2015 01:50:45 +0000 (+0000)
Subject: Not that hard to explain...
X-Git-Tag: 2.4.13~290
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=585608032162acdc66b25318fc3a3de6168a1295;p=apache

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 44b50a1d7a..64ab325de8 100644
--- 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;