<html>
<body>
<div style="font-family: Verdana, Arial, Helvetica, Sans-Serif;">
<table bgcolor="#f9f3c9" width="100%" cellpadding="8" style="border: 1px #c9c399 solid;">
<tr>
<td>
This is an automatically generated e-mail. To reply, visit:
<a href="https://git.reviewboard.kde.org/r/109892/">https://git.reviewboard.kde.org/r/109892/</a>
</td>
</tr>
</table>
<br />
<table bgcolor="#e0e0e0" width="100%" cellpadding="8" style="border: 1px gray solid;">
<tr>
<td>
<h1 style="margin-right: 0.2em; padding: 0; font-size: 10pt;">This change has been discarded.</h1>
</td>
</tr>
</table>
<br />
<table bgcolor="#fefadf" width="100%" cellspacing="0" cellpadding="8" style="background-image: url('https://git.reviewboard.kde.org/static/rb/images/review_request_box_top_bg.ab6f3b1072c9.png'); background-position: left top; background-repeat: repeat-x; border: 1px black solid;">
<tr>
<td>
<div>Review request for KDE Runtime.</div>
<div>By Thomas Lübking.</div>
<p style="color: grey;"><i>Updated April 13, 2014, 12:58 p.m.</i></p>
<div style="margin-top: 1.5em;">
<b style="color: #575012; font-size: 10pt;">Repository: </b>
kde-runtime
</div>
<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Description </h1>
<table width="100%" bgcolor="#ffffff" cellspacing="0" cellpadding="10" style="border: 1px solid #b8b5a0">
<tr>
<td>
<pre style="margin: 0; padding: 0; white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;">A CLI config tool.
It supports reading and writing of config entries.
Features beyond kread/writeconfig:
----------------------------------
- regular expression matching
- key/group deletion
- regexp based (mass) replacement
- regexp based entry listing
Usecases:
---------
a) kconfupdates:
Whenever you've got legacy settings and you need to update them you end up either writing a cpp blackbox (to the user) or a complex ('bash' != 'sh' ...) and slow script for it (latter sometimes not even being possible - original reason to write this ;-)
b) user assistance:
it is much simpler to ask a user to "kreadconfig --file kwinrc --group Compositing --key MaxFPS" than to explain the clickchain through the config GUI.
If you need more than one key, regexp driven maybe grouplisting can be very convenient.
c) key deletion:
right now the tool of choice for that is called "kwrite" ...
Syntax:
-------
kconfig <component>[/<group>[/<subgroup>[...]]] read|write|delete|list|replace [<key>] [<value>]
Examples: (to get you an idea)
---------
Let's say you want to show the configured MaxFPS of the compositor
$ kconfig kwinrc/Compositing read MaxFPS
MaxFPS: 60 (kwinrc/Compositing)
Unset it:
$ kconfig kwinrc/Compositing delete MaxFPS
Removed MaxFPS: 60
Add it:
$ kconfig kwinrc/Compositing write MaxFPS 60
New MaxFPS: 60
You got a 120Hz screen and want the compositor tick more?
$ kconfig kwinrc/Compositing write MaxFPS 120
MaxFPS: 60 -> 120
You forgot the actual key?
$ kconfig kwinrc/Compositing list max
MaxFPS: 120
Isn't there too much output for script invocation? (No)
$ MAX_FPS=`kconfig kwinrc/Compositing read MaxFPS`; echo $MAX_FPS
120
You want to alter a present MaxFPS key to MaxFps?
$ kconfig kwinrc/Compositing replace 'MaxFPS=(.*)' 'MaxFps=\1'
MaxFPS: 120 -> MaxFps: 120
List all electric borders - w/o knowing in what group they are:
$ kconfig 'kwinrc/.*' list electric
</pre>
</td>
</tr>
</table>
<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Diffs</b> </h1>
<ul style="margin-left: 3em; padding-left: 0;">
<li>kreadconfig/CMakeLists.txt <span style="color: grey">(c73c9ac)</span></li>
<li>kreadconfig/Messages.sh <span style="color: grey">(55b886c)</span></li>
<li>kreadconfig/kconfig.cpp <span style="color: grey">(PRE-CREATION)</span></li>
</ul>
<p><a href="https://git.reviewboard.kde.org/r/109892/diff/" style="margin-left: 3em;">View Diff</a></p>
</td>
</tr>
</table>
</div>
</body>
</html>