1 files changed, 26 insertions, 17 deletions

diff --git a/doc/developer-guidelines.sgml b/doc/developer-guidelines.sgml
index 1ce78ff4..599b2a16 100644
--- a/doc/developer-guidelines.sgml
+++ b/doc/developer-guidelines.sgml
@@ -83,10 +83,18 @@
                 STDOUT and not print to STDERR.</para>
 
                 <section><title>Print only one line of text</title>
-                <para>Nagios will only grab the first line of text from STDOUT
-                when it notifies contacts about potential problems. If you print
-                multiple lines, you're out of luck (though this will be a feature of 
-                Nagios 3). Remember, keep your output short and to the point.</para>
+                <para>Starting with version 3, Nagios will process plugins' multiline
+                output, which should be formatted as:</para>
+                <literallayout>
+                SERVICE STATUS: First line of output | First part of performance data
+                Any number of subsequent lines of output, but note that buffers
+                may have a limited size | Second part of performance data, which
+                may have continuation lines, too
+                </literallayout>
+                <para>Note, however, that the default configs still do not include
+                the output's continuation lines into the notifications sent when
+                Nagios notifies contacts about potential problems.
+                Thus, keep your output short and to the point.</para>
 
                 <para>Output should be in the format:</para>
                 <literallayout>
@@ -269,10 +277,6 @@
                                                 <entry>@10:20</entry>
                                                 <entry>&ge; 10 and &le; 20, (inside the range of {10 .. 20})</entry>
                                         </row>
-                                        <row>
-                                                <entry>10</entry>
-                                                <entry>&lt; 0 or &gt; 10, (outside the range of {0 .. 10})</entry>
-                                        </row>
                                 </tbody>
                         </tgroup>
                 </table>
@@ -303,15 +307,15 @@
                                         </row>
                                         <row>
                                                 <entry>check_stuff -w~:0 -c10</entry>
-                                                <entry>Critical if "stuff" is above 10; Warn if "stuff" is above zero</entry>
+                                                <entry>Critical if "stuff" is above 10; Warn if "stuff" is above zero (will be critical if "stuff" is less than 0)</entry>
                                         </row>
                                         <row>
                                                 <entry>check_stuff -c5:6</entry>
-                                                <entry>The only noncritical range is 5:6</entry>
+                                                <entry>Critical if "stuff" is less than 5 or more than 6</entry>
                                         </row>
                                         <row>
-                                                <entry>check_stuff -c10:20</entry>
-                                                <entry>Critical if "stuff" is less than 10 or over 20</entry>
+                                                <entry>check_stuff -c@10:20</entry>
+                                                <entry>OK if stuff is less than 10 or higher than 20, otherwise critical </entry>
                                         </row>
                                 </tbody>
                         </tgroup>
@@ -319,10 +323,14 @@
                 </section>
 
                 <section><title>Performance data</title>
-                <para>Performance data is defined by Nagios as "everything after the | of the plugin output" -
-                please refer to Nagios documentation for information on capturing this data to logfiles.
-                However, it is the responsibility of the plugin writer to ensure the 
-                performance data is in a "Nagios plugins" format.
+                <para>Nagios 3 and newer will concatenate the parts following a "|" in a) the first
+                line output by the plugin, and b) in the second to last line, into a string it
+                passes to whatever performance data processing it has configured. (Note that it
+                currently does not insert additional whitespace between both, so the plugin needs
+                to provide some to prevent the last pair of a) and the first of b) getting run
+                together.) Please refer to the Nagios documentation for information on how to
+                configure such processing. However, it is the responsibility of the plugin writer
+                to ensure the performance data is in a "Nagios plugins" format.
                 This is the expected format:</para>
 
                 <literallayout>
@@ -351,7 +359,8 @@
                 <listitem><para>min and max are not required if UOM=%</para>
                         </listitem>
                 <listitem><para>value, min and max in class [-0-9.]. Must all be the
-                        same UOM</para>
+                        same UOM. value may be a literal "U" instead, this would indicate that the
+                        actual value couldn't be determined</para>
                         </listitem>
                 <listitem><para>warn and crit are in the range format (see 
                         <xref linkend="thresholdformat">). Must be the same UOM</para>