----------------------------------------------------------- This is an automatically generated e-mail. To reply, visit: https://git.reviewboard.kde.org/r/109892/ -----------------------------------------------------------
(Updated April 13, 2014, 12:58 p.m.) Status ------ This change has been discarded. Review request for KDE Runtime. Repository: kde-runtime Description ------- 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 Diffs ----- kreadconfig/CMakeLists.txt c73c9ac kreadconfig/Messages.sh 55b886c kreadconfig/kconfig.cpp PRE-CREATION Diff: https://git.reviewboard.kde.org/r/109892/diff/ Testing ------- Thanks, Thomas Lübking