From: Florian Forster <octo@collectd.org>
Date: Sat, 25 May 2013 07:58:46 +0000 (+0200)
Subject: collectd.conf(5): Document the new "LoadPlugin" behavior.
X-Git-Tag: collectd-5.4.0~40
X-Git-Url: https://git.verplant.org/?a=commitdiff_plain;h=deec59d985b53371caac1a1b364cfee63ecbf3bd;p=collectd.git

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

Github: #333
---

diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod
index 96c60ea7..326944f1 100644
--- 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>