kstartupconfig1

Usage

Overview

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

$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