Apache log integration -- moved documentation to config-dist.php.

config-dist.php

@@ -254,8 +254,17 @@ $CFG->admin = 'admin';
 //     $CFG->apacheloguser = 0; // Turn this feature off. Default value.
 //     $CFG->apacheloguser = 1; // Log user id.
 //     $CFG->apacheloguser = 2; // Log full name in cleaned format. ie, Darth Vader will be displayed as darth_vader.
-//     $CFG->apacheloguser = 3; // Log username. CAUTION: Use of this value will expose usernames in the Apache log,
-//                                 If you are going to publish your log in any cases, this will be a BIG security problem.
+//     $CFG->apacheloguser = 3; // Log username. 
+// To get the values logged in Apache's log, add to your httpd.conf
+// the following statements. In the General part put:
+//     LogFormat "%h %l %{MOODLEUSER}n %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" moodleformat
+// And in the part specific to your Moodle install / virtualhost:
+//     CustomLog "/your/path/to/log" moodleformat
+// CAUTION: Use of this option will expose usernames in the Apache log,
+// If you are going to publish your log, or the output of your web stats analyzer
+// this will weaken the security of your website.
+// 
+
 
 //=========================================================================
 // ALL DONE!  To continue installation, visit your main page with a browser

lang/en/docs/install.html

@@ -209,15 +209,6 @@ php_value post_max_size 2M
       <pre>cp lib/htaccess .htaccess</pre>
     </blockquote>
   </blockquote>
-  <blockquote>
-    <p>(Optional) To include the username of the current user in the Apache access log, add the following into your httpd.conf:</p>
-    <blockquote>
-      <pre>
-LogFormat "%h %l %{MOODLEUSER}n %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" moodle
-CustomLog "/your/path/to/log" moodle</pre>
-    </blockquote>
-    <p>And then replace the "/your/path/to/log" to your http access log or to a new one. If your Moodle copy runs in a virtual host, add the lines in the corresponding <VirtualHost> block. Please refer to the Apache documentation for more information.</p>
-  </blockquote>
 <p>&nbsp;</p>
 <h3 class="sectionheading"><a name="database"></a>4.2 Creating a database</h3>