95 lines
3.5 KiB
Groff
95 lines
3.5 KiB
Groff
|
.TH "OPENBOX" "1"
|
||
|
|
.SH "NAME"
|
||
|
|
openbox \(em Next generation, highly configurable window manager
|
||
|
|
|
||
|
|
.SH "SYNOPSIS"
|
||
|
|
.PP
|
||
|
|
\fBopenbox\fR [\fB\-\-help\fP] [\fB\-\-version\fP] [\fB\-\-replace\fP] [\fB\-\-reconfigure\fP] [\fB\-\-sm-disable\fP] [\fB\-\-sync\fP] [\fB\-\-debug\fP] [\fB\-\-debug-focus\fP] [\fB\-\-debug-xinerama\fP]
|
||
|
|
.SH "DESCRIPTION"
|
||
|
|
.PP
|
||
|
|
Openbox is a next generation, highly
|
||
|
|
configurable window manager. Openbox is compliant with the
|
||
|
|
latest window manager standards.
|
||
|
|
.PP
|
||
|
|
You can start Openbox in three ways:
|
||
|
|
.PP
|
||
|
|
If you run a display manager such as GDM, you will find 3 entries
|
||
|
|
in the login session type menu for Openbox:
|
||
|
|
\fBGNOME/Openbox\fR, \fBKDE/Openbox\fR and \fBOpenbox\fR. If you want to use Openbox
|
||
|
|
within GNOME or KDE, you can choose the appropriate entry, and it will
|
||
|
|
launch GNOME or KDE with Openbox as the window manager.
|
||
|
|
.PP
|
||
|
|
The third option at log in, which is \fBOpenbox\fR without a session manager, uses the \fBopenbox-session\fR command to start Openbox. On log in, \fBopenbox\fR will
|
||
|
|
run the ~/.config/openbox/autostart.sh script if it exists, and will run
|
||
|
|
the system-wide script /opt/openbox/etc/xdg/openbox/autostart.sh otherwise. You
|
||
|
|
may place anything you want to run automatically in those files, for
|
||
|
|
example:
|
||
|
|
|
||
|
|
.PP
|
||
|
|
.RS
|
||
|
|
.PP
|
||
|
|
.nf
|
||
|
|
xsetroot \-solid grey &
|
||
|
|
gnome-settings-daemon &
|
||
|
|
.fi
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
Make sure that each line is followed by a "&" or else the script will
|
||
|
|
stop there and further commands will not be executed. You can use the
|
||
|
|
/opt/openbox/etc/xdg/openbox/autostart.sh file as an example for creating your
|
||
|
|
own.
|
||
|
|
.PP
|
||
|
|
The default /opt/openbox/etc/xdg/openbox/autostart.sh runs a number of things
|
||
|
|
with Openbox.
|
||
|
|
.PP
|
||
|
|
Lastly, if you use \fBstartx\fR to launch your X
|
||
|
|
session, you can set up a ~/.xinitrc file to run
|
||
|
|
\fBopenbox-session\fR and follow the same directions as
|
||
|
|
above regarding the autostart.sh file.
|
||
|
|
.PP
|
||
|
|
You can use the \fBobconf\fR tool to configure Openbox
|
||
|
|
easily with a graphical interface, however more in-depth configuration
|
||
|
|
is possible by editing the configuration files by hand. Please note that
|
||
|
|
\fBobconf\fR older than version 2.0 may not work at all
|
||
|
|
for you.
|
||
|
|
.PP
|
||
|
|
The default configuration and menu files are installed in
|
||
|
|
/opt/openbox/etc/xdg/openbox/, and the user configuration is placed in
|
||
|
|
~/.config/openbox/. You can copy the default configuration and menus
|
||
|
|
to ~/.config/openbox and edit it to your liking.
|
||
|
|
.SH "OPTIONS"
|
||
|
|
.PP
|
||
|
|
These are the possible options that \fBopenbox\fR accepts:
|
||
|
|
.IP "\fB\-\-help\fP" 10
|
||
|
|
Show a summary of the options available.
|
||
|
|
.IP "\fB\-\-version\fP" 10
|
||
|
|
Show the version of the program.
|
||
|
|
.IP "\fB\-\-replace\fP" 10
|
||
|
|
Replace the currently running window manager.
|
||
|
|
.IP "\fB\-\-reconfigure\fP" 10
|
||
|
|
If Openbox is already running on the display, tell it to
|
||
|
|
reload its configuration.
|
||
|
|
.IP "\fB\-\-sm-disable\fP" 10
|
||
|
|
Do not connect to the session manager.
|
||
|
|
.IP "\fB\-\-sync\fP" 10
|
||
|
|
Run in synchronous mode (for debugging).
|
||
|
|
.IP "\fB\-\-debug\fP" 10
|
||
|
|
Display debugging output.
|
||
|
|
.IP "\fB\-\-debug-focus\fP" 10
|
||
|
|
Display debugging output for focus handling.
|
||
|
|
.IP "\fB\-\-debug-xinerama\fP" 10
|
||
|
|
Split the display into two fake xinerama regions, if
|
||
|
|
xinerama is not already enabled. This is for debugging
|
||
|
|
xinerama support.
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.PP
|
||
|
|
obconf (1), openbox-gnome-session (1), openbox-kde-session (1).
|
||
|
|
|
||
|
|
.PP
|
||
|
|
The program's full documentation is available on the website:
|
||
|
|
\fBhttp://openbox.org/\fP
|
||
|
|
.PP
|
||
|
|
Please report bugs to: \fBhttp://bugzilla.icculus.org/
|
||
|
|
\fP
|
||
|
|
.\" created by instant / docbook-to-man, Mon 14 May 2007, 22:02
|