KSTARTUPCONFIG(1)

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.