From: Michael Friedrich <michael.friedrich@netways.de>
Date: Fri, 24 Jan 2014 15:28:21 +0000 (+0100)
Subject: Documentation: Add disable/override objects/attribute section.
X-Git-Tag: v0.0.7~33
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=db20f28b992a5e149798b8d423b4b619471188ac;p=icinga2

Documentation: Add disable/override objects/attribute section.

Fixes #5442
---

diff --git a/doc/4.1-configuration-syntax.md b/doc/4.1-configuration-syntax.md
index cd96ee8b2..4550f49a4 100644
--- a/doc/4.1-configuration-syntax.md
+++ b/doc/4.1-configuration-syntax.md
@@ -271,6 +271,31 @@ templates though in general they are.
 Parent objects are resolved in the order they're specified using the
 `inherits` keyword.
 
+### Disable/Override Objects and Attributes
+
+Object attributes can be overridden by defining the additional changed attribute
+directly on the object. Use the `+=` operator for the inline services dictionary.
+
+    services["overridden-custom-attr"] += {
+      custom = {
+        notes = "disabled all custom attr"
+      }
+    }
+
+If you don't require an attribute inherited from templates, you can simply
+override its value by setting it explicitely to `null`.
+
+    services["no-custom-attr"] += {
+      custom = null
+    }
+
+
+The same method applies for disabling services defined in the inline `services`
+dictionary by exiplicitely overriding their value with `null`.
+
+    services["ping6"] = null
+
+
 ### Variables
 
 Global variables can be set using the `var` and `const` keywords: