collectd.conf(5): Document the new "LoadPlugin" behavior.

Github: #333

diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod
index 96c60ea7bbbf205638060ad4bf419c07d7998fc4..326944f152758cad2620313f7bcdd92d485c4ce1 100644 (file)
--- a/src/collectd.conf.pod
+++ b/src/collectd.conf.pod
@@ -80,6 +80,14 @@ options are allowed inside a B<LoadPlugin> block:
     Interval 10
   </LoadPlugin>
 
+Only the first B<LoadPlugin> statement or block for a given plugin name has any
+effect. This is useful when you want to split up the configuration into smaller
+files and want each file to be "self contained", i.e. it contains a B<Plugin>
+block I<and> then appropriate B<LoadPlugin> statement. The downside is that if
+you have multiple conflicting B<LoadPlugin> blocks, e.g. when they specify
+different intervals, only one of them (the first one encountered) will take
+effect and all others will be silently ignored.
+
 =over 4
 
 =item B<Globals> B<true|false>