X-Git-Url: https://git.brokenzipper.com/gitweb?a=blobdiff_plain;f=doc%2Fopenbox.1.in;h=d17cb12b17fc959644a5d872c61f6d9b7246b4cf;hb=9215a741e728760181816b3017ceac1f7c24ff5c;hp=f2eeb53b7121c2c36f623093a52c8809f867b554;hpb=dfc5f034581f5a26cba5c4811500438f89f0634a;p=chaz%2Fopenbox diff --git a/doc/openbox.1.in b/doc/openbox.1.in index f2eeb53b..d17cb12b 100644 --- a/doc/openbox.1.in +++ b/doc/openbox.1.in @@ -69,9 +69,9 @@ openbox \- a window manager for X11 .\".PP .\"Openbox uses its own graphics class to render its images on the fly. .\"By using style files, you can determine at a great level how your desktop looks. -.\"Openbox currently uses its own protocol to communicate with other clients such -.\"as the pager. Work is underway to support the new window manager specification -.\"that both GNOME and KDE use. +.\"Openbox currently uses the Blackbox protocol to communicate with other clients +.\"such as the pager. Work is underway to support the new window manager +.\"specification that both GNOME and KDE use. .SH OPTIONS Openbox supports the following command line options: .TP @@ -90,7 +90,7 @@ Start Openbox on the specified display. Programs started by Openbox will have the .B DISPLAY environment variable set to this value, too. -.SH RUNNING BLACKBOX +.SH RUNNING OPENBOX This program is usually started by the user's startup script, most times called .IR ~/.xinitrc . To run openbox, modify the script by adding @@ -108,9 +108,11 @@ On exit or restart, Openbox will save user defaults in the file .I ~/.openbox/rc in the user's home directory. Some resources in this file can be edited by hand. -.SH USING BLACKBOX -From version 0.60.x, Openbox does no keyboard handling by itself; instead, it -relies on an external program +.SH USING OPENBOX +Openbox does no keyboard handling by itself; instead, it relies on an external +program +.IR epist (1) +or .IR bbkeys (1) for this. So, in this section, we will discuss all mouse commands. @@ -312,8 +314,8 @@ An tag is required to end the submenu. .TP .B [reconfig] (label) -When selected, this item rereads the current style and menu files and -applies any changes. +When selected, this item rereads the current style, menu files and rc file, +and applies any changes. This is useful for creating a new style or theme, as you don't have to constantly restart Openbox every time you save your style. However, Openbox automagically rereads the menu whenever it changes. @@ -638,7 +640,6 @@ handleWidth: a number of pixels > 0 ! When not specified, frameWidth defaults to the value of bevelWidth. frameWidth: a number of pixels >= 0 - ! This command is executed whenever this style is selected. ! Typically it sets the root window to a nice picture. rootCommand: Shell command, e.g. \fIbsetroot -mod 4 4 -fg rgb: 5/6/6 -bg grey20\fR @@ -661,6 +662,28 @@ can easily set lots of keys with a single command, e.g. *font: lucidasans-10 .EE This sets already nice defaults for many components. +.PP +Openbox also lets you pick what the small graphics in the buttons and in the manu look like. It uses the X Bitmap file format (.xbm extension). The style resources are as follows: +.EX +! Close, maximize, sticky and iconify +! buttons on a window. +window.button.close.mask: xbm file +window.button.max.mask: xbm file +window.button.stick.mask: xbm file +window.button.icon.mask: xbm file + +! The icon for submenus in a menu. +menu.arrow.mask: xbm file + +! The icon for a selected option or workspace +! in the menus. +menu.selected.mask: xbm file + +! The left and right buttons in the toolbar +toolbar.button.left.mask: xbm file +toolbar.button.right.mask: xbm file +.EE +If the xbm file value is the path to a .xbm image. If the value is absolute, it uses that file. If the file is just a file name, e.g. `close.xbm', it uses ~/.openbox/buttons/close.xbm. .SH THE SLIT The slit is a special Openbox window frame that can contain dockable applications, e.g. the `bbtools' or WindowMaker's dockapps. @@ -791,17 +814,12 @@ many individuals around the world. .PP The official Openbox website: .nh -.B http://FILLMEINNOW/ -.hy -.br -The bug and feature request page, as well as current releases can be found at: -.nh -.B http://FILLMEINNOW/ +.B http://openbox.sunsite.dk/ .hy .br Many themes and other contributions: .nh -.B http://bb.themes.org/ +.B http://themes.freshmeat.net/ .hy .PP This manpage was put together by Wilbert Berendsen @@ -810,4 +828,4 @@ This manpage was put together by Wilbert Berendsen .hy Numerous other languages will be available. .SH SEE ALSO -.IR bsetroot (1), \ bbkeys (1) \" not there, yet ;-( +.IR bsetroot (1), \ bbkeys (1), \ xftlsfonts (1), \ epist (1)