diff --git a/doc/openbox-session.1 b/doc/openbox-session.1 new file mode 100644 index 00000000..1aded857 --- /dev/null +++ b/doc/openbox-session.1 @@ -0,0 +1,39 @@ +.TH "OPENBOX" "1" +.SH "NAME" +openbox-session \(em Runs an Openbox session without any session manager. + +.SH "DESCRIPTION" +.PP +\fBopenbox-session\fR runs an openbox session without +any session manager. Without a session manager, you will not be able +to save your state from one log in to the next. +.PP +On log in, \fBopenbox-session\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. +.SH "SEE ALSO" +.PP +openbox(1), openbox-kde-session (1), openbox-gnome-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 diff --git a/doc/openbox.1 b/doc/openbox.1 new file mode 100644 index 00000000..7416b081 --- /dev/null +++ b/doc/openbox.1 @@ -0,0 +1,94 @@ +.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