Slightly clearer documentation

diff --git a/config-dist.php b/config-dist.php
index c9e6a4bd1f8929cac11f85d39affe698f677ed21..7c5842070067f6a8e7bc92636381da5eb939c67b 100644 (file)
--- a/config-dist.php
+++ b/config-dist.php
@@ -38,8 +38,9 @@
 //                                                                       //\r
 //   mysql      - the prefix is optional, but useful when installing     //\r
 //                into databases that already contain tables.            //\r
+//\r
 //   postgres7  - the prefix is REQUIRED, regardless of whether the      //\r
-//                database is empty of not.                              //\r
+//                database already contains tables.                      //\r
 \r
 $CFG->dbtype    = "mysql";       // mysql or postgres7 (for now)\r
 $CFG->dbhost    = "localhost";   // eg localhost or db.isp.com \r
@@ -54,7 +55,9 @@ $CFG->prefix    = "mdl_";        // Prefix to use for all table names
 // 2. WEB SITE LOCATION\r
 //=========================================================================\r
 // Now you need to tell Moodle where it is located. Specify the full\r
-// web address where moodle has been installed (without trailing slash)\r
+// web address to where moodle has been installed.  If your web site \r
+// is accessible via multiple URLs then choose the most natural one \r
+// that your students would use.  Do not include a trailing slash.\r
 \r
 $CFG->wwwroot   = "http://example.com/moodle";\r
 \r
@@ -63,7 +66,12 @@ $CFG->wwwroot   = "http://example.com/moodle";
 // 3. SERVER FILES LOCATION\r
 //=========================================================================\r
 // Next, specify the full OS directory path to this same location\r
-// For Windows this might be something like "C:\apache\htdocs\moodle"\r
+// For Windows this might be something like this:\r
+//\r
+//    $CFG->dirroot = "C:\Program Files\Easyphp\www\moodle"\r
+//\r
+// Make sure all the upper/lower case is exactly the same as it is on your\r
+// computer otherwise you may experience some problems (a known bug in PHP)\r
 \r
 $CFG->dirroot   = "/web/moodle";\r
 \r
@@ -72,10 +80,13 @@ $CFG->dirroot   = "/web/moodle";
 // 4. DATA FILES LOCATION\r
 //=========================================================================\r
 // Now you need a place where Moodle can save uploaded files.  This\r
-// directory should be writeable by the web server user (usually 'nobody'\r
-// or 'apache'), but it should not be accessible directly via the web.\r
+// directory should be readable AND WRITEABLE by the web server user \r
+// (usually 'nobody' or 'apache'), but it should not be accessible \r
+// directly via the web.\r
+//\r
 // - On hosting systems you might need to make sure that your "group" has\r
 //   no permissions at all, but that "others" have full permissions.\r
+//\r
 // - On Windows systems you might specify something like "C:\moodledata"\r
 \r
 $CFG->dataroot  = "/home/moodledata";\r
@@ -98,7 +109,7 @@ $CFG->buggy_referer = false;
 //=========================================================================\r
 \r
 \r
-$CFG->libdir    = "$CFG->dirroot/lib";   // Do not change this\r
+$CFG->libdir    = "$CFG->dirroot/lib";        // Do not change this\r
 require_once("$CFG->libdir/setup.php");       // Do not change this\r
 \r
 // MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES, \r