From 336e7eed4e44fe9267234e4702db6fd613064dcd Mon Sep 17 00:00:00 2001
From: Siri Hansen <siri@erlang.org>
Date: Wed, 2 May 2018 18:57:23 +0200
Subject: Improve documentation of logger:set_*_config functions

---
 lib/kernel/doc/src/logger.xml | 38 ++++++++++++++++++++++++++++++++++++--
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/lib/kernel/doc/src/logger.xml b/lib/kernel/doc/src/logger.xml
index ded9c1fb37..2beefd1240 100644
--- a/lib/kernel/doc/src/logger.xml
+++ b/lib/kernel/doc/src/logger.xml
@@ -404,21 +404,55 @@ Current logger configuration:
 
     <func>
       <name name="set_logger_config" arity="1"/>
+      <fsummary>Set configuration data for the logger.</fsummary>
+      <desc>
+        <p>Set configuration data for the logger. This overwrites the
+          current logger configuration.</p>
+	<p>To modify the existing configuration,
+	  use <seealso marker="#set_logger_config-2"><c>set_logger_config/2</c>
+	  </seealso>, or read the current configuration
+	  with <seealso marker="#get_logger_config-0"><c>get_logger_config/0</c>
+	  </seealso>, then merge in your added or updated
+	  associations before writing it back.</p>
+      </desc>
+    </func>
+
+    <func>
       <name name="set_logger_config" arity="2"/>
       <fsummary>Add or update configuration data for the logger.</fsummary>
       <desc>
-        <p>Add or update configuration data for the logger.</p>
+        <p>Add or update configuration data for the logger. If the
+          given <c><anno>Key</anno></c> already exists, its associated
+          value will be set to <c><anno>Value</anno></c>. If it
+          doesn't exist, it will be added.</p>
       </desc>
     </func>
 
     <func>
       <name name="set_handler_config" arity="2"/>
+      <fsummary>Set configuration data for the specified handler.</fsummary>
+      <desc>
+        <p>Set configuration data for the specified handler. This
+          overwrites the current handler configuration.</p>
+	<p>To modify the existing configuration,
+	  use <seealso marker="#set_handler_config-3"><c>set_handler_config/3</c>
+	  </seealso>, or read the current configuration
+	  with <seealso marker="#get_handler_config-1"><c>get_handler_config/1</c>
+	  </seealso>, then merge in your added or updated
+	  associations before writing it back.</p>
+      </desc>
+    </func>
+
+    <func>
       <name name="set_handler_config" arity="3"/>
       <fsummary>Add or update configuration data for the specified
         handler.</fsummary>
       <desc>
         <p>Add or update configuration data for the specified
-          handler.</p>
+          handler. If the
+          given <c><anno>Key</anno></c> already exists, its associated
+          value will be set to <c><anno>Value</anno></c>. If it
+          doesn't exist, it will be added.</p>
       </desc>
     </func>
 
-- 
cgit v1.2.3