Index: modules/dblog/dblog.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/dblog/dblog.module,v
retrieving revision 1.1
diff -u -F^F -r1.1 dblog.module
--- modules/dblog/dblog.module	10 Apr 2007 10:10:27 -0000	1.1
+++ modules/dblog/dblog.module	10 Apr 2007 14:45:41 -0000
@@ -44,7 +44,7 @@
 function dblog_menu() {
   $items['admin/settings/logging/dblog'] = array(
     'title' => t('Database logging'),
-    'description' => t('Settings for logging to the Drupal database logs.'),
+    'description' => t('Settings for logging to the Drupal database logs. This is the most common method for small to medium sites on shared hosting. The logs are viewable from the admin pages.'),
     'page callback' => 'drupal_get_form',
     'page arguments' => array('dblog_admin_settings'),
   );
Index: modules/syslog/syslog.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/syslog/syslog.module,v
retrieving revision 1.1
diff -u -F^F -r1.1 syslog.module
--- modules/syslog/syslog.module	10 Apr 2007 10:10:27 -0000	1.1
+++ modules/syslog/syslog.module	10 Apr 2007 14:45:41 -0000
@@ -19,7 +19,7 @@
 function syslog_menu() {
   $items['admin/settings/logging/syslog'] = array(
     'title'          => t('Syslog'),
-    'description'    => t('Settings for syslog logging.'),
+    'description'    => t('Settings for syslog logging. Syslog is a system administration logging tool, where messages are routed by facility and severity. It is more suitable for medium to large sites, and would not be suitable for shared hosting environments.'),
     'page callback'  => 'drupal_get_form',
     'page arguments' => array('syslog_admin_settings'),
   );
@@ -29,10 +29,10 @@
 function syslog_admin_settings() {
   $form['syslog_faclity'] = array(
     '#type'          => 'select',
-    '#title'         => t('Syslog facility to send to'),
+    '#title'         => t('Syslog facility to send log to'),
     '#default_value' => variable_get('syslog_faclity', LOG_LOCAL0),
     '#options'       => syslog_facility_list(),
-    '#description'   => t('Select the syslog facility to send Drupal\'s messages to. For more information on syslog facilities, See !syslog_conf and !php', array(
+    '#description'   => t('Select the syslog facility to send Drupal\'s messages to. Syslog is a system administration logging tool, where messages are routed by facility and severity. It is more suitable for medium to large sites, and would not be suitable for shared hosting environments. In the file /etc/syslog.conf you define where messages go for any combination of facility and severity. For UNIX/Linux systems, Drupal can use the facilities user, local0 to local7, for Windows, you can only use the user facility. For more information on syslog facilities, severity levels, and how to setup a syslog.conf files, see !syslog_conf and !php', array(
       '!php'         => l("PHP's syslog", 'http://www.php.net/manual/en/function.openlog.php'),
       '!syslog_conf' => l('UNIX/Linux syslog.conf', 'http://www.rt.com/man/syslog.5.html'),
       )),
Index: modules/system/system.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/system/system.module,v
retrieving revision 1.464
diff -u -F^F -r1.464 system.module
--- modules/system/system.module	10 Apr 2007 10:10:27 -0000	1.464
+++ modules/system/system.module	10 Apr 2007 14:45:43 -0000
@@ -251,7 +251,7 @@
   );
   $items['admin/settings/logging'] = array(
     'title' => t('Logging and alerts'),
-    'description' => t('Settings for logging and alerts modules'),
+    'description' => t('Settings for logging and alerts modules. Various modules can route Drupal\'s system events to different destination, such as syslog, database, email, ...etc.'),
     'page callback' => 'system_logging_overview',
   );
   $items['admin/settings/performance'] = array(