X-Git-Url: https://git.brokenzipper.com/gitweb?a=blobdiff_plain;f=doc%2Fopenbox.1.in;h=3d3ba30e7a62389aff2c875d41708186017353c1;hb=b43b612e3bb2a465abf968226de12d34b199b5ec;hp=ebf256bd015ec20942aae2776e8fe54de4cc097c;hpb=db750e5cb03b0507a268f5581fc952b5214cf846;p=chaz%2Fopenbox diff --git a/doc/openbox.1.in b/doc/openbox.1.in index ebf256bd..3d3ba30e 100644 --- a/doc/openbox.1.in +++ b/doc/openbox.1.in @@ -19,24 +19,33 @@ in the login session type menu for 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: +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 @configdir@/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 & -exec \fBopenbox\fR .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 +@configdir@/openbox/autostart.sh file as an example for creating your +own. +.PP +The default @configdir@/openbox/autostart.sh runs a number of things +with Openbox. +.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. +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 @@ -44,17 +53,10 @@ 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 +The default configuration and menu files are installed in @configdir@/openbox/, and the user configuration is placed in -~/.config/openbox/. You can copy the default configuration +~/.config/openbox/. You can copy the default configuration and menus 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: @@ -81,12 +83,12 @@ 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). - +obconf (1), openbox-session(1), openbox-gnome-session(1), +openbox-kde-session(1). .PP The program's full documentation is available on the website: -\fBhttp://openbox.org/\fP +\fBhttp://icculus.org/openbox/\fP .PP Please report bugs to: \fBhttp://bugzilla.icculus.org/ \fP -.\" created by instant / docbook-to-man, Sun 13 May 2007, 20:34 +.\" created by instant / docbook-to-man, Wed 16 May 2007, 01:19