X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=doc%2Fopenbox.1.sgml;h=6921a66618bd5f07980a110ec4608bbf04a807ec;hb=8eea9dcdb77e004e67c23061eaecce26e8cd4e68;hp=742a181403f802b29d597fc106243d86c6e02b4a;hpb=5c96972bfffacb7dc24c96673f85e413e5c87b94;p=chaz%2Fopenbox
diff --git a/doc/openbox.1.sgml b/doc/openbox.1.sgml
index 742a1814..6921a666 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.
@@ -40,18 +40,19 @@ 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:
@@ -62,35 +63,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 withing 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 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:
+
-
+
+ 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. The default
- configuration files are installed in @configdir@/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.
-
- There are 3 default configuration files, rc.xmlrc-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.
+ is possible by editing the configuration files by hand.
+ 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.OPTIONS
@@ -119,7 +125,15 @@ manpage.1: manpage.sgml
If Openbox is already running on the display, tell it to
- reload it's configuration.
+ reload its configuration.
+
+
+
+
+
+ If Openbox is already running on the display, tell it to
+ restart. This is useful if you have upgraded Openbox and don't
+ want to restart X.
@@ -146,16 +160,24 @@ manpage.1: manpage.sgml
Display debugging output for focus handling.
+
+
+
+ Split the display into two fake xinerama regions, if
+ xinerama is not already enabled. This is for debugging
+ xinerama support.
+
+ 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/