X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=doc%2Fopenbox.1.sgml;h=281f2a01f839d4eefa881b0e1c7b059f1a1c30e6;hb=bced74beaa9ff03e0810ff1d61a3704040841942;hp=a8f2fe74554e16cf761775b1faf1e4ecd745db17;hpb=0951fbeea5669d3ee3d88fdbacba4ac1dff6acfb;p=chaz%2Fopenbox
diff --git a/doc/openbox.1.sgml b/doc/openbox.1.sgml
index a8f2fe74..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,19 +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:
@@ -63,29 +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 file is installed in @confdir@/xdg/openbox/rc.xml, and the
- user configuration is placed in ~/.config/openbox/rc.xml. You can copy
- the default configuration to ~/.config/openbox and edit it to your
- liking.
+ 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
@@ -95,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.
@@ -110,23 +122,37 @@ manpage.1: manpage.sgml
Replace the currently running window manager.
+
+
+
+ Specify the path to the config file to use.
+
+ If Openbox is already running on the display, tell it to
- reload it's configuration.
+ reload its configuration.
-
+
- Do not connect to the session manager.
+ 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.
-
+
- Specify the configuration profile to use.
+ Exit Openbox.
+
+
+
+
+
+ Do not connect to the session manager.
@@ -135,6 +161,12 @@ manpage.1: manpage.sgml
Run in synchronous mode (for debugging).
+
+
+
+ Run CMD after starting.
+
+
@@ -147,13 +179,27 @@ manpage.1: manpage.sgml
Display debugging output for focus handling.
+
+
+
+ Display debugging output for session management.
+
+
+
+
+
+ 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/