Improvements to explain about AcceptPathInfo

lang/en/docs/faq.html

@@ -24,9 +24,27 @@ The requested URL /moodle/file.php/2/myfile.jpg was not found on this server.
 
 <blockquote>
 <hr>
-<p><b>Answer:</b> Some web servers don't support the default method Moodle uses to pass arguments to a script.</p>
-<p>As Admin, go into the "Configure Variables" page and change the setting for 
-   "slasharguments".  You should now be able to access your uploaded files.</p>
+<p><b>Answer:</b> Your web server needs to be configured to allow the part of the URL 
+after a script name to be passed directly to the script.  This is 
+usually enabled in Apache 1, but is usually disabled by default in 
+Apache 2.  To turn it on, add these lines to your httpd.conf, or to 
+a .htaccess file in your local directory (see the 
+<A HREF="./?file=install.html#webserver">Install documentation</A> for more details): 
+
+<blockquote>
+<pre>&lt;IfDefine APACHE2>
+     <b>AcceptPathInfo</b> on
+&lt;/IfDefine>
+</pre>
+</blockquote>
+
+<p>If you are not using another type of web server then you can switch Moodle 
+   to use an alternative method.  The disadvantages are a slight loss of 
+   performance for your users and you won't be able to use relative links 
+   within HTML resources.
+<p>To use this alternative method: login as Admin, go into the "Configure Variables" page 
+   and change the setting for "<b>slasharguments</b>".  You should now be able to 
+   access your uploaded files.</p>
 </blockquote>
 
 

lang/en/docs/install.html

@@ -164,7 +164,19 @@
   </blockquote>
   <p>Just make sure index.php is in the list (and preferably towards the start 
     of the list, for efficiency).</p>
-  <p>Secondly, Moodle requires a number of PHP settings to be active for it to 
+  <p>Secondly, if you are using Apache 2, then you should turn on the <i>AcceptPathInfo</i>
+     variable, which allows scripts to be passed arguments like http://server/file.php/arg1/arg2.
+     This is essential to allow relative links between your resources, and also 
+     provides a performance boost for people using your Moodle web site.  You can 
+     turn this on by adding these lines to your httpd.conf file.</p>
+<blockquote>
+<pre>&lt;IfDefine APACHE2>
+     <b>AcceptPathInfo</b> on
+&lt;/IfDefine>
+</pre>
+</blockquote>
+
+  <p>Thirdly, Moodle requires a number of PHP settings to be active for it to 
      work.  <B>On most servers these will already be the default settings.</B>
      However, some PHP servers (and some of the more recent PHP versions) may 
      have things set differently.  These are defined in PHP's configuration
@@ -188,6 +200,11 @@ session.bug_compat_warn = Off
      This only works on Apache servers and only when Overrides have been allowed.
      <BLOCKQUOTE><PRE>
 DirectoryIndex index.php index.html index.htm
+
+&lt;IfDefine APACHE2>
+     <b>AcceptPathInfo</b> on
+&lt;/IfDefine>
+
 php_value magic_quotes_gpc On
 php_value magic_quotes_runtime Off
 php_value file_uploads On