added docs for selectively disabling Cfg validation

1 files changed, 13 insertions, 7 deletions

diff --git a/doc/server/plugins/generators/cfg.txt b/doc/server/plugins/generators/cfg.txt
index 1d9d55927..031c9e3fc 100644
--- a/doc/server/plugins/generators/cfg.txt
+++ b/doc/server/plugins/generators/cfg.txt
@@ -237,13 +237,19 @@ For ``sudoers``, a very simple validator is::
 
 This uses the ``visudo`` command's built-in validation.
 
-.. note:
-
-    Before 1.3 is released, it will be possible to disable validation
-    in the configuration, but enable it for ``bcfg2-test``.  This is
-    recommended for heavily-used servers, since running an external
-    command is fairly resource intensive and could quickly exhaust the
-    file descriptors of a server.
+If you wish to disable validation, this can be done with the following
+setting in ``bcfg2.conf``::
+
+  [cfg]
+  validation=no
+
+If you have a very large number of validators, you may wish to disable
+validation by default to avoid slowing down the generation of
+configurations on the server, and use ``bcfg2-test`` (for instance, as
+a post-commit hook or as part of a code review process) to run
+validation.  You can do this by setting ``validation=no`` in
+``bcfg2.conf`` as described above, and then calling ``bcfg2-test``
+with the ``--cfg-validation`` flag.
 
 File permissions
 ================