document the order that config options are handled

diff --git a/bti.1 b/bti.1
index e8413d6a92e2b587f365ac24c27a10b5fe2428dd..3fe86d9a0947dd555885075919136d5e7f7d45d3 100644 (file)
--- a/bti.1
+++ b/bti.1
@@ -266,6 +266,22 @@ The http proxy needed to send data out to the Internet\&.
 There is an example config file called
 \FCbti\&.example\F[]
 in the source tree that shows the structure of the file if you need an example to work off of\&.
 There is an example config file called
 \FCbti\&.example\F[]
 in the source tree that shows the structure of the file if you need an example to work off of\&.

+.PP
+Configuration options have the following priority:
+.PP
+.RS 4
+command line option
+.RE
+.PP
+.RS 4
+config file option
+.RE
+.PP
+.RS 4
+environment variables
+.RE
+.PP
+For example, command line options always override any config file option, or any environment variables\&.

 .SH "AUTHOR"
 .PP
 Written by Greg Kroah\-Hartman
 .SH "AUTHOR"
 .PP
 Written by Greg Kroah\-Hartman

diff --git a/bti.xml b/bti.xml
index 1be3b5b16ffffebd796da27513b0a44680f31d13..96f424a67ac80cd358e68b1cc94b73cc956b0240 100644 (file)
--- a/bti.xml
+++ b/bti.xml
@@ -204,6 +204,27 @@
            <filename>bti.example</filename> in the source tree that shows
            the structure of the file if you need an example to work off of.
          </para>
            <filename>bti.example</filename> in the source tree that shows
            the structure of the file if you need an example to work off of.
          </para>

+         <para>
+           Configuration options have the following priority:
+        </para>
+         <variablelist>
+           <varlistentry>
+             <term></term>
+             <listitem><para>command line option</para></listitem>
+           </varlistentry>
+           <varlistentry>
+            <term></term>
+            <listitem><para>config file option</para></listitem>
+           </varlistentry>
+           <varlistentry>
+             <term></term>
+             <listitem><para>environment variables</para></listitem>
+           </varlistentry>
+         </variablelist>
+        <para>
+          For example, command line options always override any config file
+          option, or any environment variables.
+         </para>

        </refsect1>
 
        <refsect1><title>AUTHOR</title>
        </refsect1>
 
        <refsect1><title>AUTHOR</title>