document manual module ordering

diff --git a/raddb/radiusd.conf.in b/raddb/radiusd.conf.in
index 434576013642c328d63cca5d876b541db3d0e7c7..4d1220c94ea1057d4ca202a15bb4c8ff0df05441 100644 (file)
--- a/raddb/radiusd.conf.in
+++ b/raddb/radiusd.conf.in
@@ -626,7 +626,22 @@ modules {
        #
 
        #
-       #  As of 3.0, modules are in mods-enabled/.  Files matching
+       #  Some modules have ordering issues.  e.g. "sqlippool" uses
+       #  the configuration from "sql".  In that case, the "sql"
+       #  module must be read off of disk before the "sqlippool".
+       #  However, the directory inclusion below just reads the
+       #  directory from start to finish.  Which means that the
+       #  modules are read off of disk randomly.
+       #
+       #  As of 3.0.18, you can list individual modules *before* the
+       #  directory inclusion.  Those modules will be loaded first.
+       #  Then, when the directory is read, those modules will be
+       #  skipped and not read twice.
+       #
+#      $INCLUDE mods-enabled/sql
+
+       #
+       #  Modules are in mods-enabled/.  Files matching
        #  the regex /[a-zA-Z0-9_.]+/ are loaded.  The modules are
        #  initialized ONLY if they are referenced in a processing
        #  section, such as authorize, authenticate, accounting,