Man Linux: Main Page and Category List

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.