X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;ds=sidebyside;f=doc%2Fopenbox.1.sgml;h=2e0c3c833039a1493685e0aa1ca8b026a33f93cf;hb=6b038948cc9747e2a4a06f52136ccdcb19993340;hp=1cce5545d1465eeca6df6e7e60bda9bf02ffded4;hpb=f58ece609523b5cc4c825c4af185e5a6fdd00210;p=chaz%2Fopenbox
diff --git a/doc/openbox.1.sgml b/doc/openbox.1.sgml
index 1cce5545..2e0c3c83 100644
--- a/doc/openbox.1.sgml
+++ b/doc/openbox.1.sgml
@@ -30,8 +30,8 @@ manpage.1: manpage.sgml
&dhpackage;
- Next generation, highly configurable window manager
-
+ A minimalistic, highly configurable, next generation window
+ manager with extensive standards support.
@@ -50,9 +50,8 @@ manpage.1: manpage.sgml
DESCRIPTION
- Openbox is a next generation, highly
- configurable window manager. Openbox is compliant with the
- latest window manager standards.
+ Openbox is minimalistic, highly configurable, next generation window
+ manager with extensive standards support.
You can start Openbox in three ways:
@@ -63,30 +62,39 @@ manpage.1: manpage.sgml
within GNOME or KDE, you can choose the appropriate entry, and it will
launch GNOME or KDE with Openbox as the window manager.
- 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 Default session type. The ~/.xsession file
- should start any applications you want to run at startup, and then run
- &dhpackage; at the end, such as:
+ The third option at log in, which is Openbox
+ without a session manager, uses the openbox-session
+ command to start Openbox. On log in, &dhpackage; 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:
+
-
+
xsetroot -solid grey &
- gnome-settings-daemon &
- exec &dhpackage;
+ gnome-settings-daemon &
+
+ 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.
+
+ The default @configdir@/openbox/autostart.sh runs a number of things
+ with Openbox.
Lastly, if you use startx 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
+ openbox-session and follow the same directions as
+ above regarding the autostart.sh file.
You can use the obconf 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
- obconf older than version 2.0 may not work at all
- for you.
+ is possible by editing the configuration files by hand.
- The default configuration files are installed in
- @configdir@/openbox/rc.xml, and the user configuration is placed in
- ~/.config/openbox/rc.xml. You can copy the default configuration
+ 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 and menus
to ~/.config/openbox and edit it to your liking.
@@ -156,11 +164,11 @@ manpage.1: manpage.sgml
SEE ALSO
- obconf (1), openbox-gnome-session (1), openbox-kde-session (1).
-
+ obconf (1), openbox-session(1), openbox-gnome-session(1),
+ openbox-kde-session(1).
The program's full documentation is available on the website:
- http://openbox.org/
+ http://icculus.org/openbox/
Please report bugs to: http://bugzilla.icculus.org/