From: Alan T. DeKok <aland@freeradius.org>
Date: Fri, 8 Feb 2019 22:26:15 +0000 (-0500)
Subject: minor wordsmithing
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=81a75890219;p=thirdparty%2Ffreeradius-server.git

minor wordsmithing
---

diff --git a/raddb/mods-available/soh b/raddb/mods-available/soh
index 0bb1367a647..9e42ea97a23 100644
--- 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 fd46daa2b19..3453b942c05 100644
--- 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 f8d59c776f8..a83a8f97d57 100644
--- 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 6b8b4997c7f..1e2a688e568 100644
--- 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