X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=doc%2Fopenbox.1.sgml;h=281f2a01f839d4eefa881b0e1c7b059f1a1c30e6;hb=16c0fb84bc8c4b2547850148a60f3c82092ba104;hp=b173655414ce21bbbd55b8034ded7b4ec11aae6d;hpb=db750e5cb03b0507a268f5581fc952b5214cf846;p=chaz%2Fopenbox
diff --git a/doc/openbox.1.sgml b/doc/openbox.1.sgml
index b1736554..281f2a01 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,6 +40,7 @@ manpage.1: manpage.sgml
+
@@ -50,9 +51,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 +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 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:
+
-
+
+ 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
@@ -105,13 +106,14 @@ manpage.1: manpage.sgml
- Show a summary of the options available.
+ Show a summary of the command line options available
+ and exit.
- Show the version of the program.
+ Show the version of the program and exit.
@@ -120,6 +122,12 @@ manpage.1: manpage.sgml
Replace the currently running window manager.
+
+
+
+ Specify the path to the config file to use.
+
+
@@ -127,6 +135,20 @@ manpage.1: manpage.sgml
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.
+
+
+
+
+
+ Exit Openbox.
+
+
@@ -139,6 +161,12 @@ manpage.1: manpage.sgml
Run in synchronous mode (for debugging).
+
+
+
+ Run CMD after starting.
+
+
@@ -151,6 +179,12 @@ manpage.1: manpage.sgml
Display debugging output for focus handling.
+
+
+
+ Display debugging output for session management.
+
+
@@ -164,8 +198,8 @@ 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/