From: Dana Jansens <danakj@orodu.net>
Date: Tue, 15 May 2007 23:00:05 +0000 (+0000)
Subject: openbox.1 wasnt added, oops
X-Git-Tag: openbox-3_3_991-RELEASE~32
X-Git-Url: http://git.openbox.org/?a=commitdiff_plain;h=e1309e91884433598658de4bc1d119c6a2d203c9;p=dana%2Fopenbox.git

openbox.1 wasnt added, oops
---

diff --git a/doc/openbox.1 b/doc/openbox.1
new file mode 100644
index 00000000..f3f12c1f
--- /dev/null
+++ b/doc/openbox.1
@@ -0,0 +1,92 @@
+.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 
+If you don't want to run Openbox within a desktop environment, then 
+it is recommended that you instead set up a ~/.xsession file and 
+use the \fBDefault\fR session type. The ~/.xsession file 
+should start any applications you want to run at startup, and then run 
+\fBopenbox\fR at the end, such as: 
+.PP 
+.RS 
+.PP 
+.nf 
+xsetroot \-solid grey & 
+gnome-settings-daemon & 
+exec \fBopenbox\fR 
+.fi 
+.RE 
+.PP 
+Lastly, if you use \fBstartx\fR to launch your X 
+session, you should set up a ~/.xinitrc file, exactly the same as the 
+above ~/.xsession 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 files are installed in 
+/opt/openbox/etc/xdg/openbox/, and the user configuration is placed in 
+~/.config/openbox/. You can copy the default configuration 
+to ~/.config/openbox and edit it to your liking. 
+.PP 
+There are 3 default configuration files, \fBrc.xml\fP, 
+\fBrc-gnome.xml\fP, and \fBrc-kde.xml\fP. The 
+rc-gnome.xml is used when you run 
+\fBopenbox-gnome-session\fR and the rc-kde.xml is used when 
+you run \fBopenbox-kde-session\fR. The configuration 
+files should be named the same in ~/.config/openbox/. 
+.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, Sun 13 May 2007, 20:35