NAME
kstartupconfig, kdostartupconfig - KDE configuration options loader
SYNOPSIS
kstartupconfig [$KDEHOME]
kdostartupconfig
DESCRIPTION
kstartupconfig loads configuration options for use in startkde. It
saves loading time as there is no need to launch programs linked to KDE
libraries. startupconfig uses a cache of some Kconfig options that are
updated by kdostartupconfig. The cache is implemented as script file
that is sourced and provides the options as shell variables.
The configuration options to load are stored in startupconfigkeys as
one option per line. They follow the format <file> <group> <key>
<default>. A complete group is addressed as <file> [<group>]. The
configuration options are processed in the specified order so the
missing default values for groups can be specified as single options
after the group option.
kstartupconfig stores every line from startupconfigkeys in
startupconfigfiles followed by the paths of all files relevant to the
option. Lines with non-existent files start with ’!’ in case they are
created later. The list of files is terminated by a line starting with
’*’.
If the timestamps of all relevant files are older than the timestamp of
startupconfigfile there is no need to update anything. Otherwise
kdostartupconfig is launched to create or update the necessary files.
kdostartupconfig writes values of the options to startupconfig.
startupconfig is a shell script that sets the values to shell
variables. The variables are named <file>_<group>_<key>.
Notes:
- the kdeglobals config file is not used as a dependency for other
config files
- do not use frequently changed config files since the checking is
timestamp-based
- if kconf_update is used to update an option also touch the
matching global config file to allow kstartupconfig to see
changes
OPTIONS
$KDEHOME
KDE home directory, if different to ~/.kde
FILES
In case $KDEHOME is not set ~/.kde is assumed.
$KDEHOME/share/config/startupconfig
script, sourced to set shell variables with configuration
options
$KDEHOME/share/config/startupconfigfiles
configuration options and files they belong to
$KDEHOME/share/config/startupconfigkeys
configuration options to load
SEE ALSO
kconf_update(1), startkde(1)
AUTHORS
Lubos Lunak <l.lunak@kde.org>
Please use http://bugs.kde.org to report bugs, do not mail the author
directly.
This manual page was written by Holger Hartmann
<Holger_Hartmann@gmx.de> for the Debian Project (but may be used by
others). Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU General Public License, Version 2
or any later version published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License
can be found in /usr/share/common-licenses/GPL.