minor pruning of comments in weewx.conf

weewx.conf

@@ -29,7 +29,7 @@ version = 3.0.0a1
     # Description of the station location.
     location = Hood River, Oregon
 
-    # Latitude, longitude in decimal degrees
+    # Latitude and longitude in decimal degrees
     latitude = 45.686
     longitude = -121.566
 
@@ -41,8 +41,7 @@ version = 3.0.0a1
     # in this file with a 'driver' parameter indicating the driver to be used.
     station_type = unspecified
 
-    # If you have a website, you may optionally specify an URL for
-    # its HTML server.
+    # If you have a website, you may specify an URL
     #station_url = http://www.example.com
 
     # The start of the rain year (1=January; 10=October, etc.). This is
@@ -118,28 +117,26 @@ version = 3.0.0a1
     # Where the generated reports should go, relative to WEEWX_ROOT:
     HTML_ROOT = public_html
 
-    # The database binding to be used in the reports
+    # The database binding indicates which data should be used in reports
     data_binding = wx_binding
     
     # Each subsection represents a report you wish to run.
 
     [[StandardReport]]
+        # See the customizing guide to change the units, plot types and line
+        # colors, modify the fonts, display additional sensor data, and other
+        # customizations.  Many of those changes can be made here by overriding
+        # parameters, or by modifying templates within the skin itself.
 
-        # See the customizing guide to change the units, change plot types and
-        # line colors, modify the fonts, display additional sensor data, and
-        # many other customizations.  Many of those changes can be made here
-        # by overriding parameters, or by modifying templates within the skin
-        # itself.
-
-        # The StandardReport uses the 'Standard' skin
+        # The StandardReport uses the 'Standard' skin, which contains the
+        # images, templates and plots for the report.
         skin = Standard
 
     [[FTP]]
-        skin = Ftp
-
         # FTP'ing the results to a webserver is treated as just another report,
         # albeit one with an unusual report generator!
-        #
+        skin = Ftp
+
         # If you wish to use FTP, uncomment and fill out the next four lines:
         #user = replace with your username
         #password = replace with your password
@@ -157,22 +154,16 @@ version = 3.0.0a1
         # Set to 1 to use passive mode, zero for active mode:
         passive = 1
 
-        # How many times to try to transfer a file before giving up:
-        max_tries = 3
-
     [[RSYNC]]
+        # rsync'ing to a webserver is treated as just another report
         skin = Rsync
 
-        # rsync'ing the results to a webserver is treated as just another
-        # report, much like the FTP report.
-        #
         # If you wish to use rsync, you must configure passwordless ssh using
         # public/private key authentication from the user account that weewx
         # runs as to the user account on the remote machine where the files
         # will be copied.
         #
-        # The following configure what system and remote path the files are
-        # sent to:
+        # The following determine where files will be sent:
         #server = replace with your server name, e.g, www.threefools.org
         #path = replace with the destination directory (e.g., /weather)
         #user = replace with your username
@@ -189,7 +180,7 @@ version = 3.0.0a1
 [StdConvert]
 
     # This service acts as a filter, converting the unit system coming from
-    # the hardware to a target output unit system.
+    # the hardware to a unit system in the database.
     #
     # The target_unit affects only the unit system in the database.  Once
     # chosen it cannot be changed without converting the entire database.
@@ -197,8 +188,7 @@ version = 3.0.0a1
     # corrupt data - the database will contain a mix of US and METRIC data.
     #
     # The value of target_unit does not affect the unit system for
-    # reporting - reports can display US, Metric, or any combination of
-    # units.
+    # reporting - reports can display US, Metric, or any combination of units.
     #
     # In most cases, target_unit should be left as the default: US
     #
@@ -259,13 +249,13 @@ version = 3.0.0a1
     # How often to check the weather station clock for drift (in seconds)
     clock_check = 14400
 
-    # How much it can drift before we will correct it (in seconds):
+    # How much it can drift before we will correct it (in seconds)
     max_drift = 5
 
 ##############################################################################
 
 [StdArchive]
-    # This section is for configuring the archive databases.
+    # This section is for configuring the archive service.
 
     # If your station hardware supports data logging then the archive interval
     # will be downloaded from the station.
@@ -306,13 +296,14 @@ version = 3.0.0a1
 
 [Databases]
     # This section defines the actual databases
-    
+
+    # A SQLite database is simply a single file
     [[archive_sqlite]]
         root = %(WEEWX_ROOT)s
         database_name = archive/weewx.sdb
         driver = weedb.sqlite
 
-    # MySQL databases require setting an appropriate 'user' and 'password'
+    # MySQL require a server (host) with name and password for access
     [[archive_mysql]]
         host = localhost
         user = weewx
@@ -323,7 +314,7 @@ version = 3.0.0a1
 ##############################################################################
 
 [Engine]
-    # This section configures the engine. It is for advanced customization.
+    # This section configures the engine.
 
     [[Services]]
         # These are the services the engine should run: