minor wordsmithing

diff --git a/raddb/mods-available/soh b/raddb/mods-available/soh
index 0bb1367a64729d1729ccbf986229242bbaca4614..9e42ea97a23a02083517cabb088ef94175688e2d 100644 (file)
--- a/raddb/mods-available/soh
+++ b/raddb/mods-available/soh
@@ -8,8 +8,8 @@
 #
 #  = SoH Module
 #
-#  The `soh` module is used for decodes Microsoft's Statement of Health
-#  sub-protocol.
+#  The `soh` module is used for decoding Microsoft's "Statement of
+#  Health" sub-protocol.
 #
 #  See the below link for additional information about the SoH Protocol.
 #

diff --git a/raddb/mods-available/stats b/raddb/mods-available/stats
index fd46daa2b19d0702d9feda00280b84cacf0b4efa..3453b942c053ec0aec1f5af4a92bdf6ebd9f5a24 100644 (file)
--- a/raddb/mods-available/stats
+++ b/raddb/mods-available/stats
@@ -8,9 +8,9 @@
 #
 #  = Stats Module
 #
-#  The `stats` module tracks RADIUS statistics.
+#  The `stats` module tracks packet statistics.
 #
-#  It should be listed LAST in any `send ... { }` section.
+#  It should be listed *last* in any `send ... { }` section.
 #
 #  When listed in a `send` section, it will increment statistics for
 #  input / output packets.

diff --git a/raddb/mods-available/unix b/raddb/mods-available/unix
index f8d59c776f8bef73ccac81a078b3d15d5dbfd2e3..a83a8f97d570149d3447e5c88e5f45c50b7ad754 100644 (file)
--- a/raddb/mods-available/unix
+++ b/raddb/mods-available/unix
@@ -8,14 +8,15 @@
 #
 #  = Unix Module
 #
-#  The `unix` module calls the system functions to get the `known good`
-#  password.  This password is usually in the `crypt` form, and is
-#  incompatible with `CHAP`, `MS-CHAP`, `PEAP`, etc.
+#  The `unix` module calls the system `getpwent()` functions to get
+#  the `known good` password.  This password is usually in the `crypt`
+#  form, and is incompatible with `CHAP`, `MS-CHAP`, `PEAP`, etc.
 #
-#  If passwords are in /etc/shadow, you will need to set the `group`
-#  configuration in `radiusd.conf`.
+#  If the passwords are in /etc/shadow, you will need to set the
+#  `group` configuration in `radiusd.conf` so that the server can read
+#  /etc/shadow.
 #
-#  Look for `shadow`, and follow the instructions there.
+#  Look for "shadow", and follow the instructions there.
 #
 
 #
@@ -25,11 +26,14 @@ unix {
        #
        #  radwtmp:: The location of the `wtmp` file.
        #
-       #  The only use for 'radlast'.  If you don't use 'radlast',
+       #  The only use for `radlast`.  If you don't use `radlast`,
        #  then you can comment out this item.
        #
        #  NOTE: The radwtmp file may get large!  You should rotate it
        #  (cp /dev/null radwtmp), or just not use it.
        #
-       radwtmp = ${logdir}/radwtmp
+       #  The default is to not use radwtmp files.  It's better to
+       #  use a database.
+       #
+#      radwtmp = ${logdir}/radwtmp
 }

diff --git a/raddb/mods-available/utf8 b/raddb/mods-available/utf8
index 6b8b4997c7f6971a4e6cadf002a10d84c010fb7a..1e2a688e568166a65737cece1ef71e8ff7bc03f6 100644 (file)
--- a/raddb/mods-available/utf8
+++ b/raddb/mods-available/utf8
@@ -16,6 +16,10 @@
 #  An attribute of type "string" containing non-UTF-8 data makes
 #  the module return `FAIL`.
 #
+#  The module can be used as a simple check for non-conforming
+#  packets.  If the contents of the Access-Request packets are not
+#  UTF-8, it's likely best to just reject the request.
+#
 
 #
 #  ## Default instance