.\" gtk-options.7 - Standard Command Line Options for Gnome Programs
.\" Copyright 2003  Jochen Voss <voss@debian.org>
.\" You may redistribute and modify this manual page
.\" under the terms of the GPL.
.TH gtk\-options 7 "2003\-10\-20" "GTK 2" "GTK User\'s Manual"
.SH NAME
gtk\-options \- Standard Command Line Options for GTK Programs
.SH SYNOPSIS
.IR "program " [ "standard options" "] [" "specific options" "] " arguments
.SH DESCRIPTION
This manual page describes the command line options, which are common
to all GTK based applications.
.SH OPTIONS
.SS GTK OPTIONS
.TP
\fB\-\-gtk\-module\fR=\fIMODULE\fR
Load an additional Gtk module.
.TP
\fB\-\-gtk\-debug\fR=\fIFLAGS\fR
A colon separated list of GTK debugging flags to set.
Valid flags are
.IR objects ,
.IR misc ,
.IR signals ,
.IR dnd ,
and
.IR plugsocket .
The special value
.I all
enables all flags.
.TP
\fB\-\-gtk\-no\-debug\fR=\fIFLAGS\fR
GTK debugging flags to unset.  Use this options to override the
.I GTK_DEBUG
environment variable.
.TP
\fB\-\-g\-fatal\-warnings\fR
Make all warnings fatal.
.SS GDK OPTIONS
.TP
\fB\-\-display\fR=\fIDISPLAY\fR
Set the X display to use.  Use this option to override the
.I DISPLAY
environment variable.
.TP
\fB\-\-screen\fR=\fISCREEN\fR
X screen to use.  Use this options to override the screen part
of the
.I DISPLAY
environment variable (see the
.I DISPLAY NAMES
section of the
.IR X (7x)
manual page).
.TP
\fB\-\-sync\fR
Make X calls synchronous.  This slows down the program considerably,
but may be useful for debugging purposes.
.TP
\fB\-\-no\-xshm\fR
Do not use the X server\'s XSHM shared memory extension.  This slows down the
program.
.TP
\fB\-\-name\fR=\fINAME\fR
Program name as used by the window manager.
.TP
\fB\-\-class\fR=\fICLASS\fR
Program class as used by the window manager.
.HP
\fB\-\-gxid_host\fR=\fIHOST\fR
.HP
\fB\-\-gxid_port\fR=\fIPORT\fR
.HP
\fB\-\-xim\-preedit\fR
.TP
\fB\-\-xim\-status\fR
Control the X input method.
.TP
\fB\-\-gdk\-debug\fR=\fIFLAGS\fR
A colon\-separated list of GDK debugging flags to set.  This only works
if your GDK library was compile with debugging support.  Valid flags
are
.IR events ,
.IR misc ,
.IR dnd ,
.IR color\-context ,
and
.IR xim .
The special value
.I all
enables all valid flags.
.TP
\fB\-\-gdk\-no\-debug\fR=\fIFLAGS\fR
A colon\-separated list of GDK debugging flags to unset.
Use this options to override the
.I GDK_DEBUG
environment variable.
.SH "SEE ALSO"
.BR X (7x),
the GTK documentation, and
the GDK documentation.
.PP
For most GTK programs there will be additional command line options,
which are specific to the program.  These will be explained in the
application\'s documentation.
.SH AUTHOR
This manual page was written by Jochen Voss <voss@debian.org>.