summaryrefslogtreecommitdiffstats
path: root/ubuntu/maverick/tdelibs/debian/man/tdestartupconfig-trinity.1
blob: 4f0f6c6e216fe7a89bb0604b622e4a3913ca1b3e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
.\" This file was generated by (a slightly modified) kdemangen.pl and edited by hand
.TH KSTARTUPCONFIG 1 "Jun 2006" "Trinity Desktop Environment" "configuration options loader"
.SH NAME
tdestartupconfig, tdedostartupconfig
\- TDE configuration options loader
.SH SYNOPSIS
\fBtdestartupconfig\fP [$TDEHOME]
.sp 1
\fBtdedostartupconfig\fP
.SH DESCRIPTION
\fBtdestartupconfig\fP loads configuration options for use in \fBstarttde\fP. It saves loading time as there is no need to launch programs linked to TDE libraries. \fBstartupconfig\fP uses a cache of some Kconfig options that are updated by \fBtdedostartupconfig\fP. The cache is implemented as script file that is sourced and provides the options as shell variables.
.sp 1
The configuration options to load are stored in \fIstartupconfigkeys\fP 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.
.sp 1
\fBtdestartupconfig\fP stores every line from \fIstartupconfigkeys\fP in \fIstartupconfigfiles\fP 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 '*'.
.sp 1
If the timestamps of all relevant files are older than the timestamp of \fIstartupconfigfile\fP there is no need to update anything. Otherwise \fBtdedostartupconfig\fP is launched to create or update the necessary files.
.sp 1
\fBtdedostartupconfig\fP writes values of the options to \fIstartupconfig\fP. \fIstartupconfig\fP is a shell script that sets the values to shell variables. The variables are named <file>_<group>_<key>.
.sp 1
\fBNotes:\fP
.IP "     \-"
the \fIkdeglobals\fP config file is not used as a dependency for other config files
.IP "     \-"
do not use frequently changed config files since the checking is timestamp\-based
.IP "     \-"
if \fBtdeconf_update\fP is used to update an option also touch the matching global config file to allow \fBtdestartupconfig\fP to see changes
.SH OPTIONS
.TP
.B $TDEHOME
TDE home directory, if different to ~/.trinity
.SS
.SH FILES
In case $TDEHOME is not set ~/.trinity is assumed.
.TP
.I $TDEHOME/share/config/startupconfig
script, sourced to set shell variables with configuration options
.TP
.I $TDEHOME/share/config/startupconfigfiles
configuration options and files they belong to
.TP
.I $TDEHOME/share/config/startupconfigkeys
configuration options to load
.SH SEE ALSO
.BR tdeconf_update (1),\  starttde (1)
.SH AUTHORS
.nf
Lubos Lunak <[email protected]>
.br

.br
.fi
Please use http://bugs.trinitydesktop.org to report bugs, do not mail the author directly.
.PP
This manual page was written by Holger Hartmann <[email protected]> for the \fBDebian\fP 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.
.PP
On \fBDebian\fP systems, the complete text of the GNU General Public License can be found in /usr/share/common\-licenses/GPL.