.\" This file was generated by (a slightly modified) kdemangen.pl and edited by hand
.TH KREADCONFIG 1 "June 2006" "K Desktop Environment" "Read KConfig entries"
.SH NAME
kreadconfig
\- Read KConfig entries (for use in shell scripts)
.SH SYNOPSIS
\fBkreadconfig\fP [Qt\-options] [KDE\-options] [options] 
.SH DESCRIPTION
\fBkreadconfig\fP is a command line tool to retrieve values from KDE configuration files.
.sp 1
If a file given via option \fB\-\-file\fP does not contain a path the KDE standard configuration directory is used.
.SS Example:
.TP
\fBkreadconfig \-\-group\fP Directories \fB--key\fP dir_tmp
read the \fBvalue\fP for \fBkey\fP dir_tmp in \fBgroup\fP Directories from KDE's main configuration file

.SH OPTIONS
.SS Options:
.TP
.B  \-\-file  <file>
Use <file> instead of global config
.TP
.B  \-\-group  <group>
Group to look in [KDE]
.TP
.B  \-\-key  <key>
Key to look for
.TP
.B  \-\-default  <default>
Default value
.TP
.B  \-\-type  <type>
Type of variable
.SS Generic options:
.TP
.B  \-\-help  
Show help about options
.TP
.B  \-\-help\-qt  
Show Qt specific options
.TP
.B  \-\-help\-kde  
Show KDE specific options
.TP
.B  \-\-help\-all  
Show all options
.TP
.B  \-\-author  
Show author information
.TP
.B \-v,  \-\-version  
Show version information
.TP
.B  \-\-license  
Show license information
.TP
.B  \-\-  
End of options
.SS 
.SS Qt options:
.TP
.B  \-\-display  <displayname>
Use the X-server display 'displayname'
.TP
.B  \-\-session  <sessionId>
Restore the application for the given 'sessionId'
.TP
.B  \-\-cmap  
Causes the application to install a private color
map on an 8\-bit display
.TP
.B  \-\-ncols  <count>
Limits the number of colors allocated in the color
cube on an 8\-bit display, if the application is
using the QApplication::ManyColor color
specification
.TP
.B  \-\-nograb  
tells Qt to never grab the mouse or the keyboard
.TP
.B  \-\-dograb  
running under a debugger can cause an implicit
\-nograb, use \-dograb to override
.TP
.B  \-\-sync  
switches to synchronous mode for debugging
.TP
.B \-\-fn,  \-\-font  <fontname>
defines the application font
.TP
.B \-\-bg,  \-\-background  <color>
sets the default background color and an
application palette (light and dark shades are
calculated)
.TP
.B \-\-fg,  \-\-foreground  <color>
sets the default foreground color
.TP
.B \-\-btn,  \-\-button  <color>
sets the default button color
.TP
.B  \-\-name  <name>
sets the application name
.TP
.B  \-\-title  <title>
sets the application title (caption)
.TP
.B  \-\-visual  TrueColor
forces the application to use a TrueColor visual on
an 8\-bit display
.TP
.B  \-\-inputstyle  <inputstyle>
sets XIM (X Input Method) input style. Possible
values are onthespot, overthespot, offthespot and
root
.TP
.B  \-\-im  <XIM server>
set XIM server
.TP
.B  \-\-noxim  
disable XIM
.TP
.B  \-\-reverse  
mirrors the whole layout of widgets
.SS 
.SS KDE options:
.TP
.B  \-\-caption  <caption>
Use 'caption' as name in the titlebar
.TP
.B  \-\-icon  <icon>
Use 'icon' as the application icon
.TP
.B  \-\-miniicon  <icon>
Use 'icon' as the icon in the titlebar
.TP
.B  \-\-config  <filename>
Use alternative configuration file
.TP
.B  \-\-dcopserver  <server>
Use the DCOP Server specified by 'server'
.TP
.B  \-\-nocrashhandler  
Disable crash handler, to get core dumps
.TP
.B  \-\-waitforwm  
Waits for a WM_NET compatible windowmanager
.TP
.B  \-\-style  <style>
sets the application GUI style
.TP
.B  \-\-geometry  <geometry>
sets the client geometry of the main widget - see man X for the argument format
.SS

.SH FILES
.I /etc/kde3/system.kdeglobals
global KDE configuration file
.I ~/.kde/share/config
standard configuration directory

.SH AUTHORS
.nf
Bernhard Rosenkraenzer <bero@redhat.com>
.br

.br
.fi
Please use http://bugs.kde.org to report bugs; do not mail the author directly.
.PP
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.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common\-licenses/GPL.