X-Git-Url: https://git.brokenzipper.com/gitweb?a=blobdiff_plain;f=doc%2Fopenbox.1.sgml;h=2e0c3c833039a1493685e0aa1ca8b026a33f93cf;hb=3d7c2f45ec846a487aa5c717de501b11ea9071b2;hp=b173655414ce21bbbd55b8034ded7b4ec11aae6d;hpb=db750e5cb03b0507a268f5581fc952b5214cf846;p=chaz%2Fopenbox
diff --git a/doc/openbox.1.sgml b/doc/openbox.1.sgml
index b1736554..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,39 +62,40 @@ 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
+ 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.
-
- There are 3 default configuration files, rc.xml,
- rc-gnome.xml, and rc-kde.xml. The
- rc-gnome.xml is used when you run
- openbox-gnome-session and the rc-kde.xml is used when
- you run openbox-kde-session. The configuration
- files should be named the same in ~/.config/openbox/.
-
OPTIONS
@@ -164,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/