From ec8b02a7c417377e80697a157b46ba23a3763db1 Mon Sep 17 00:00:00 2001
From: David Edmundson <kde@davidedmundson.co.uk>
Date: Thu, 15 Sep 2016 11:59:22 +0100
Subject: [PATCH] More config descriptions

Reviewers: hein, #plasma, mart

Reviewed By: mart

Subscribers: mart, hein, plasma-devel

Tags: #plasma

Differential Revision: https://phabricator.kde.org/D2766
---
 .../package/contents/config/main.xml          | 23 +++++++++++++++----
 applets/lock_logout/contents/config/main.xml  |  5 ++++
 2 files changed, 23 insertions(+), 5 deletions(-)

diff --git a/applets/digital-clock/package/contents/config/main.xml b/applets/digital-clock/package/contents/config/main.xml
index b8b3d8dc7..eb6240701 100644
--- a/applets/digital-clock/package/contents/config/main.xml
+++ b/applets/digital-clock/package/contents/config/main.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="UTF-8"?>
+c<?xml version="1.0" encoding="UTF-8"?>
 <kcfg xmlns="http://www.kde.org/standards/kcfg/1.0"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.kde.org/standards/kcfg/1.0
@@ -7,50 +7,63 @@
 
   <group name="Appearance">
     <entry name="showLocalTimezone" type="Bool">
+      <label>Whether the timezone should be displayed when the clock is showing the local timezone.</label>
       <default>false</default>
     </entry>
     <entry name="showSeconds" type="Bool">
+      <label>Whether seconds should be shown in the clock.</label>
       <default>false</default>
     </entry>
     <entry name="showDate" type="Bool">
+      <label>Whether the date should be shown next to the clock.</label>
       <default>false</default>
     </entry>
     <entry name="dateFormat" type="string">
+      <label>The date format to display. Options are: shortDate, longDate or isoDate.</label>
       <default>shortDate</default>
     </entry>
     <entry name="fontFamily" type="string">
+      <label>Font family. e.g "arial". The system font is used if this is not set.</label>
       <default></default>
     </entry>
     <entry name="boldText" type="Bool">
+      <label>Sets the font to bold.</label>
       <default>false</default>
     </entry>
     <entry name="italicText" type="Bool">
+      <label>Sets the font to italic.</label>
       <default>false</default>
     </entry>
     <entry name="timeFormat" type="string">
       <default>default</default>
     </entry>
     <entry name="selectedTimeZones" type="StringList">
-        <default>Local</default>
+      <label>A list of the time zones available on mouse wheel. Requires wheelChangesTimezone to be true. Format is "Europe/London". Special entry "Local" indicates system time zone.</label>
+      <default>Local</default>
     </entry>
     <entry name="lastSelectedTimezone" type="String">
+      <label>When multiple time zones are configured, this is the one shown on widget restore.</label>
       <default>Local</default>
     </entry>
     <entry name="wheelChangesTimezone" type="Bool">
+      <label>Whether the mouse wheel switches between the timezones configured in selectedTimeZones.</label>
       <default>false</default>
     </entry>
     <entry name="displayTimezoneAsCode" type="Bool">
+      <label>Whether the timezone is displayed as a code i.e. "GMT" or full text i.e. "London".</label>
       <default>true</default>
     </entry>
     <entry name="showWeekNumbers" type="Bool">
+      <label>Whether the calendar should show week numbers.</label>
       <default>false</default>
     </entry>
     <entry name="use24hFormat" type="UInt">
-        <default>1</default>
+      <label>Force the clock to use 12/24 hour time, instead of following the user locale.</label>
+      <default>1</default>
     </entry>
     <entry name="enabledCalendarPlugins" type="StringList">
-        <default></default>
+      <label>A list of plugins where additional calendar event data can be sourced.</label>
+      <default></default>
     </entry>
   </group>
-
 </kcfg>
diff --git a/applets/lock_logout/contents/config/main.xml b/applets/lock_logout/contents/config/main.xml
index 346964dd3..188ef1aba 100644
--- a/applets/lock_logout/contents/config/main.xml
+++ b/applets/lock_logout/contents/config/main.xml
@@ -7,18 +7,23 @@
 
   <group name="General">
     <entry name="show_requestShutDown" type="Bool">
+      <label>Show an option to shut down the system.</label>
       <default>true</default>
     </entry>
     <entry name="show_lockScreen" type="Bool">
+      <label>Show an option to lock the system.</label>
       <default>true</default>
     </entry>
     <entry name="show_switchUser" type="Bool">
+      <label>Show an option to switch user.</label>
       <default>false</default>
     </entry>
     <entry name="show_suspendToDisk" type="Bool">
+      <label>Show an option to suspend the system to disk (hibernate).</label>
       <default>false</default>
     </entry>
     <entry name="show_suspendToRam" type="Bool">
+      <label>Show an option to suspend the system suspend.</label>
       <default>false</default>
     </entry>
   </group>