Improvements to explain about AcceptPathInfo

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

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