httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: httpd-2.0/docs/manual/mod core.xml
Date Mon, 21 Apr 2003 00:29:45 GMT
slive       2003/04/20 17:29:45

  Modified:    docs/manual/mod Tag: APACHE_2_0_BRANCH core.xml
    Add note about when to use <location>.  This dupes what is already discussed
    in sections.html, but it is important enough to repeat.
  Revision  Changes    Path
  No                   revision
  No                   revision +18 -4     httpd-2.0/docs/manual/mod/core.xml
  Index: core.xml
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/core.xml,v
  retrieving revision
  retrieving revision
  diff -u -d -b -u -r1.46.2.13 -r1.46.2.14
  --- core.xml	15 Apr 2003 22:56:31 -0000
  +++ core.xml	21 Apr 2003 00:29:44 -0000
  @@ -1700,10 +1700,24 @@
       <code>.htaccess</code> files are read, and after the <directive
       type="section" module="core">Files</directive> sections.</p>
  -    <p>Note that URLs do not have to line up with the filesystem at
  -    all, it should be emphasized that <directive
  -    type="section">Location</directive> operates completely
  -    outside the filesystem.</p>
  +    <p><directive type="section">Location</directive> sections operate
  +    completely outside the filesystem.  This has several consequences.
  +    Most importantly, <directive type="section">Location</directive>
  +    directives should not be used to control access to filesystem
  +    locations.  Since several different URLs may map to the same
  +    filesystem location, such access controls may by circumvented.</p>
  +    <note><title>When to use <directive 
  +    type="section">Location</directive></title>
  +    <p>Use <directive type="section">Location</directive> to apply
  +    directives to content that lives outside the filesystem.  For
  +    content that lives in the filesystem, use <directive
  +    type="section" module="core">Directory</directive> and <directive
  +    type="section" module="core">Files</directive>.  An exception is
  +    <code>&lt;Location /&gt;</code>, which is an easy way to 
  +    apply a configuration to the entire server.</p>
  +    </note>
       <p>For all origin (non-proxy) requests, the URL to be matched is a
       URL-path of the form <code>/path/</code>.  No scheme, hostname,

View raw message