.\" This file was generated by (a slightly modified) kdemangen.pl and edited by hand
.TH KWRITECONFIG 1 "June 2006" "K Desktop Environment" "Write KConfig entries"
.SH NAME
kwriteconfig
\- Write KConfig entries (for use in shell scripts)
.SH SYNOPSIS
\fBkwriteconfig\fP [Qt\-options] [KDE\-options] [options] value 
.SH DESCRIPTION
\fBkwriteconfig\fP is a command line tool to write values in KDE configuration files.
Nonexisting files/groups/keys will be created.
.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
\fBkwriteconfig \-\-file\fP \fImyrc\fP \fB\-\-group\fP Directories \fB\-\-key\fP dir_tmp /tmp
writes the \fBvalue\fP for \fBkey\fP dir_tmp in \fBgroup\fP Directories in configuration \fBfile\fP \fImyrc\fP

.SH OPTIONS
.SS
.SS Arguments:
.TP
.B value
The value to write. Mandatory, on a shell use '' for empty
.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  \-\-type  <type>
Type of variable. Use "bool" for a boolean, otherwise it is treated as a string
.SS 
.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 AUTHORS
.nf
Luis Pedro Coelho <luis_pedro@netcabo.pt>
.br
Bernhard Rosenkraenzer <bero@redhat.com>
.br

.br
.fi
Please use http://bugs.kde.org to report bugs; do not mail the authors 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.