Reference

kwriteconfig(1)

Write KConfig entries (for use in shell scripts)

NAME

kwriteconfig - Write KConfig entries (for use in shell scripts)

SYNOPSIS

kwriteconfig [Qt-options] [KDE-options] [options] value

DESCRIPTION

kwriteconfig is a command line tool to write values in KDE configuration files. Nonexisting files/groups/keys will be created.

If a file given via option --file does not contain a path the KDE standard configuration directory is used.

Example:

kwriteconfig --file myrc --group Directories --key dir_tmp /tmp

writes the value for key dir_tmp in group Directories in configuration file myrc

OPTIONS

Arguments:

value

The value to write. Mandatory, on a shell use '' for empty

Options:

--file <file>

Use <file> instead of global config

--group <group>

Group to look in [KDE]

--key <key>

Key to look for

--type <type>

Type of variable. Use "bool" for a boolean, otherwise it is treated as a string

Generic options:

--help

Show help about options

--help-qt

Show Qt specific options

--help-kde

Show KDE specific options

--help-all

Show all options

--author

Show author information

-v, --version

Show version information

--license

Show license information

--

End of options

Qt options:

--display <displayname>

Use the X-server display 'displayname'

--session <sessionId>

Restore the application for the given 'sessionId'

--cmap

Causes the application to install a private color map on an 8-bit display

--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

--nograb

tells Qt to never grab the mouse or the keyboard

--dograb

running under a debugger can cause an implicit -nograb, use -dograb to override

--sync

switches to synchronous mode for debugging

--fn, --font <fontname>

defines the application font

--bg, --background <color>

sets the default background color and an application palette (light and dark shades are calculated)

--fg, --foreground <color>

sets the default foreground color

--btn, --button <color>

sets the default button color

--name <name>

sets the application name

--title <title>

sets the application title (caption)

--visual TrueColor

forces the application to use a TrueColor visual on an 8-bit display

--inputstyle <inputstyle>

sets XIM (X Input Method) input style. Possible values are onthespot, overthespot, offthespot and root

--im <XIM server>

set XIM server

--noxim

disable XIM

--reverse

mirrors the whole layout of widgets

KDE options:

--caption <caption>

Use 'caption' as name in the titlebar

--icon <icon>

Use 'icon' as the application icon

--miniicon <icon>

Use 'icon' as the icon in the titlebar

--config <filename>

Use alternative configuration file

--dcopserver <server>

Use the DCOP Server specified by 'server'

--nocrashhandler

Disable crash handler, to get core dumps

--waitforwm

Waits for a WM_NET compatible windowmanager

--style <style>

sets the application GUI style

--geometry <geometry>

sets the client geometry of the main widget - see man X for the argument format

Luis Pedro Coelho <[email protected]>

AUTHORS

Bernhard Rosenkraenzer <[email protected]>

Please use http://bugs.kde.org to report bugs; do not mail the authors directly.

This manual page was written by Holger Hartmann <[email protected]> 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.