X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=doc%2Fopenbox.1.sgml;h=281f2a01f839d4eefa881b0e1c7b059f1a1c30e6;hb=2ea60e77c085a724b2ec28273e24e12ece0e84f3;hp=b2b4a8363e0875dbb19b39515cbf0ea0ed54c0f1;hpb=e10dd09e4831c2226a30b0454ff0a7615e590269;p=chaz%2Fopenbox diff --git a/doc/openbox.1.sgml b/doc/openbox.1.sgml index b2b4a836..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: + -
+
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. The default - configuration file is installed in @configdir@/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/