DOC: management: clarify usage of -V with -c

In ticket #3065 an user complained that no success message is printed
anymore when using -c. The message does not appear by default since
version 2.9. This patch clarify the documentation.

Must be backported as far as 2.8.

diff --git a/doc/management.txt b/doc/management.txt
index 2c2756283be4fe18a78443440f6c7a6b5bb6b05e..2ba12a5b89d28b7c629a4b3105f337f9af591604 100644 (file)
--- a/doc/management.txt
+++ b/doc/management.txt
@@ -200,6 +200,12 @@ list of options is :
   -c : only performs a check of the configuration files and exits before trying
     to bind. The exit status is zero if everything is OK, or non-zero if an
     error is encountered. Presence of warnings will be reported if any.
+    By default this option does not report a success message. Combined with
+    "-V" this will print the message "Configuration file is valid" upon
+    success.
+
+    Scripts must use the exit status to dertermine the success of the
+    command.
 
   -cc : evaluates a condition as used within a conditional block of the
     configuration. The exit status is zero if the condition is true, 1 if the