1jwm(1)                      General Commands Manual                     jwm(1)
2
3
4

NAME

6       JWM - Joe's Window Manager
7
8

SYNOPSIS

10       jwm [options]
11

DESCRIPTION

13       JWM is a window manager for the X11 Window System.
14
15

OPTIONS

17       -display display
18              This option specifies the display to use; see X(1).
19
20       -exit
21              Exit JWM by sending _JWM_EXIT to the root window.
22
23       -h
24              Display a help message and exit.
25
26       -p
27              Parse the configuration file and exit.  It is a good idea to use
28              this after making modifications to  the  configuration  file  to
29              ensure there are no errors.
30
31       -restart
32              Restart JWM by sending _JWM_RESTART to the root window.
33
34       -v
35              Display version information and exit.
36
37

FILES

39       /etc/system.jwmrc
40              The default JWM configuration file.
41
42       ~/.jwmrc
43              Local configuration file. Copy the default configuration file to
44              this location to make user-specific changes.
45
46

CONFIGURATION

48       OVERVIEW
49              Configuration of JWM is done by editing ".jwmrc".  This file  is
50              XML  making it easy to edit, either by hand or programmatically.
51              The example.jwmrc gives an example configuration  file.   Before
52              restarting  JWM,  it is a good idea to run "jwm -p" to make sure
53              the configuration file is free of errors.  Otherwise you may end
54              up without a root menu.
55
56       ROOT MENU
57              The  root  menu  in JWM is the primary way of starting programs.
58              It also provides a way to restart or exit  the  window  manager.
59              The  outer  most  tag  is RootMenu. The following attributes are
60              supported:
61
62              onroot list
63                     Determine which buttons on the root window  activate  the
64                     menu.  This is a list of integers specifying buttons. The
65                     default is "123".  Note that multiple root menus  may  be
66                     specified by using different buttons for different menus.
67                     The range of possible button values is 0 to 9 inclusive.
68
69              height int
70                     Height of each menu  item  in  pixels.  0  indicates  the
71                     largest  menu item will determine the height. The default
72                     is 0.
73
74              labeled bool
75                     Determines if a label appears at the  top  of  the  menu.
76                     Default is false.
77
78              label string
79                     The  label  to display at the top of the menu. Default is
80                     "JWM".
81
82              Within the RootMenu tag, the following tags are supported:
83
84              Menu
85                     This tag creates a submenu item. Any of the tags  allowed
86                     within  the  RootMenu  tag,  including  the  Menu tag are
87                     allowed within this element. The following attributes are
88                     supported:
89
90                     height int
91                            Height  of  each  menu item in pixels. 0 indicates
92                            the largest menu item will determine  the  height.
93                            The default is inherited from the parent menu.
94
95                     label string
96                            The label to use. No default.
97
98                     icon string
99                            The icon to use for this menu. No default.
100
101                     labeled bool
102                            Determines  if  a  label appears at the top of the
103                            menu. Default is false.
104
105              Include
106                     Include the contents of a file into the  menu  structure.
107                     The  file must start with a "JWM" tag. The file is speci‐
108                     fied by the text of the tag.  If  the  text  starts  with
109                     "exec:" then the output of a program is used.
110
111              Program
112                     The  Program tag provides a way to start an external pro‐
113                     gram. The text in this tag is the command used  to  start
114                     the program.  The following attributes are supported:
115
116                     label string
117                            The  label  to display. Default is the text of the
118                            tag.
119
120                     icon string
121                            The icon to use. No default.
122
123              Separator
124                     This tag simply puts a line in  the  menu  allowing  menu
125                     divisions.  No text or attributes are used.
126
127              Desktops
128                     Add  a  desktop menu. This will add a submenu with a list
129                     of desktops that can be used to change the current  desk‐
130                     top.  The following attributes are supported:
131
132                     label string
133                            The  label  to  use  for  the menu. The default is
134                            "Desktops".
135
136                     icon string
137                            The icon to use for this item. No default.
138
139              SendTo
140                     Add a "send to" menu to the menu. After selecting an item
141                     from  this  menu,  a  window may be selected to send that
142                     window to the selected desktop.  The following attributes
143                     are supported:
144
145                     label string
146                            The label to use. The default is "SendTo".
147
148                     icon string
149                            The icon to use for this item. No default.
150
151              Stick
152                     Add  a  stick/unstick window operation to the menu. After
153                     selecting this item a window may be  selected  to  toggle
154                     the   sticky   state   of  that  window.   The  following
155                     attributes are supported:
156
157                     label string
158                            The label to use. The default is "Stick".
159
160                     icon string
161                            The icon to use for this item. No default.
162
163              Maximize
164                     Add a  maximize  window  operation  to  the  menu.  After
165                     selecting  this  item  a window may be selected to toggle
166                     the  maximized  state  of  that  window.   The  following
167                     attributes are supported:
168
169                     label string
170                            The label to use. The default is "Maximize".
171
172                     icon string
173                            The icon to use for this item. No default.
174
175              Minimize
176                     Add  a  minimize  window  operation  to  the  menu. After
177                     selecting this item a window may be selected to  minimize
178                     that window.  The following attributes are supported:
179
180                     label string
181                            The label to use. The default is "Minimize".
182
183                     icon string
184                            The icon to use for this item. No default.
185
186              Shade
187                     Add  a  shade/unshade window operation to the menu. After
188                     selecting this item a window may be  selected  to  toggle
189                     the   shaded   status  of  that  window.   The  following
190                     attributes are supported:
191
192                     label string
193                            The label to use. The default is "Shade".
194
195                     icon string
196                            The icon to use for this item. No default.
197
198              Move
199                     Add a move window operation to the menu. After  selecting
200                     this  item  a window may be selected to move that window.
201                     The following attributes are supported:
202
203                     label string
204                            The label to use. The default is "Move".
205
206                     icon string
207                            The icon to use for this item. No default.
208
209              Resize
210                     Add a resize window operation to the menu. After  select‐
211                     ing  this  item  a  window may be selected to resize that
212                     window.  The following attributes are supported:
213
214                     label string
215                            The label to use. The default is "Resize".
216
217                     icon string
218                            The icon to use for this item. No default.
219
220              Kill
221                     Add a kill window operation to the menu. After  selecting
222                     this  item  a window may be selected to kill that window.
223                     The following attributes are supported:
224
225                     label string
226                            The label to use. The default is "Kill".
227
228                     icon string
229                            The icon to use for this item. No default.
230
231              Close
232                     Add a close window operation to the menu. After selecting
233                     this  item a window may be selected to close that window.
234                     The following attributes are supported:
235
236                     label string
237                            The label to use. The default is "Close".
238
239                     icon string
240                            The icon to use for this item. No default.
241
242              Restart
243                     This tag adds a menu item to restart the window  manager.
244                     The following attributes are supported:
245
246                     label string
247                            The label to use. The default is "Restart".
248
249                     icon string
250                            The icon to use. No default.
251
252              Exit
253                     This  tag adds a menu item to exit the window manager. If
254                     text is present within this tag, it is interpreted  as  a
255                     command  to run when JWM exits. This can be used to start
256                     another window manager.   The  following  attributes  are
257                     supported:
258
259                     label string
260                            The label to use. The default is "Exit".
261
262                     icon string
263                            The icon to use. No default.
264
265                     confirm bool
266                            Determine if a confirm dialog appears before exit‐
267                            ing. Default is true.
268
269                     Note that confirm dialogs can be disabled  completely  at
270                     the compile-time.
271
272       TRAYS
273              One  or  more  trays  may be created via the Tray tag.  This tag
274              supports the following attributes:
275
276              autohide bool
277                     Allows this tray  to  hide  itself  when  not  activated.
278                     Default is false.
279
280              x int
281                     The  x-coordinate  of  the  tray. This may be negative to
282                     indicate an offset from the right of the screen.
283
284              y int
285                     The y-coordinate of the tray. This  may  be  negative  to
286                     indicate an offset from the bottom of the screen.
287
288              width int
289                     The  width  of the tray. 0 indicates that the tray should
290                     compute an optimal width depending on  what  it  contains
291                     and the layout. 0 is the default.
292
293              height int
294                     The  height of the tray. 0 indicates that the tray should
295                     compute an optimal height depending on what  it  contains
296                     and the layout. 0 is the default.
297
298              border int
299                     The  width  of the border. The default is 1. Valid values
300                     are between 0 and 32 inclusive.
301
302              layer int
303                     The layer of the tray. The default is 8. Valid values are
304                     between 0 and 12 inclusive.
305
306              layout { vertical | horizontal }
307                     The layout of the tray. The default is horizontal.
308
309              valign { fixed | top | center | bottom }
310                     The vertical alignment of the tray. The default is fixed.
311
312              halign { fixed | left | center | right }
313                     The  horizontal  alignment  of  the  tray. The default is
314                     fixed.
315
316              Within this tag the following tags are supported:
317
318              Clock
319                     Add a clock to the tray. The text of this tag is  a  com‐
320                     mand  to run when the clock is clicked. This tag supports
321                     the following attributes:
322
323                     format string
324                            The format of the clock. See strftime(3).
325
326                     zone string
327                            The time zone of the clock.  See tzset(3).
328
329                     width int
330                            The width of the clock. 0 indicates that the width
331                            should  be  determined from the length of the text
332                            to be displayed.
333
334                     height int
335                            The height of the  clock.  0  indicates  that  the
336                            height should be determined from the font used.
337
338              Dock
339                     Add  a dock for system notifications. This can be used by
340                     those programs that use  the  _NET_SYSTEM_TRAY_Sn  selec‐
341                     tion.  The  size of the Dock is dynamic based on the size
342                     of the tray and the number of items contained.  Only  one
343                     Dock is allowed per instance of JWM.
344
345              Pager
346                     Add  a pager to the tray.  A pager shows a miniature rep‐
347                     resentation of a  desktop.   When  over  the  pager,  the
348                     scroll  wheel  will  switch  desktops.   Holding down the
349                     right mouse button allows you to drag a window around  in
350                     the pager which changes its position on the real desktop.
351                     You can also drag a window in the pager from one  desktop
352                     to another.  This tag supports the following attributes:
353
354                     labeled bool
355                            Determines  if  the pager has text labels. Default
356                            is false.
357
358                     Also see the PAGER STYLE section for more information.
359
360              Swallow
361                     Swallow a program into the tray. The  text  of  this  tag
362                     gives  the command to run.  This tag supports the follow‐
363                     ing attributes:
364
365                     name string
366                            The name of the program to swallow. This attribute
367                            is required.
368
369                     width int
370                            The  width  of  the swallowed program. 0 indicates
371                            that the width should be determined from the  tray
372                            and  size  requested  from  the  program. 0 is the
373                            default.
374
375                     height int
376                            The height of the swallowed program.  0  indicates
377                            that the height should be determined from the tray
378                            and the size requested from the program. 0 is  the
379                            default.
380
381              TaskList
382                     Add  a task list to the tray.  This tag supports the fol‐
383                     lowing attribute:
384
385                     maxwidth int
386                            The maximum width of an item in the task  list.  0
387                            indicates no maximum.  The default is 0.
388
389              TrayButton
390                     Add a button to the tray. The text of this tag determines
391                     what action to take when the button is clicked. The  fol‐
392                     lowing actions are supported:
393
394                     root:n
395                            Show  root menu n.  Note that the default TrayBut‐
396                            ton action is root:1.
397
398                     exec: string
399                            Execute a command.
400
401                     showdesktop
402                            Minimize all windows on the current desktop.
403
404                     This tag supports the following attributes:
405
406                     label string
407                            A label to display. No default.
408
409                     popup string
410                            A string to be displayed for a  popup.  This  will
411                            default  to the value specified for label, if pro‐
412                            vided. If neither popup nor label are specified no
413                            popup will be shown.
414
415                     icon string
416                            An icon to display. No default.
417
418       INCLUDES
419              Other  configuration files may be included under the JWM tag via
420              the Include tag.  The text of this tag specifies the location of
421              an  additional  configuration  file. The path may be relative to
422              the loacation JWM was started, an absolute path, or a path  ref‐
423              erencing  an environment variable (using '$'). The format of the
424              configuration file is the same as the main configuration file.
425
426       GROUP SETTINGS
427              Program groups allow one to specify options  which  apply  to  a
428              group  of programs by name and/or class. A program group is cre‐
429              ated with the Group tag. As many program groups can  be  created
430              as  desired.  Within  the  Group tag the following tags are sup‐
431              ported:
432
433              Name
434                     The title of a program to match to be in this group. This
435                     field is case sensitive. a wild card, *, may be used.
436              Class
437                     The  window  class  for  a program to match to be in this
438                     group. This field is case sensitive. A wild card, *,  may
439                     be used.
440              Option
441                     An  option  for  this  group.  Possible options are given
442                     below:
443
444                     border
445                            Causes windows in this group to have a border.
446
447                     desktop:#
448                            The desktop on which windows in this group will be
449                            started.
450
451                     icon:string
452                            The icon to be used for windows in this group.
453
454                     layer: #
455                            The  layer  on which windows in this group will be
456                            started.
457
458                     maximized
459                            Make windows in this group initially maximized.
460
461                     hmax
462                            Make windows in this group maximize horizontally.
463
464                     vmax
465                            Make windows in this group maximize vertically.
466
467                     minimized
468                            Make windows in this group initially minimized.
469
470                     noborder
471                            Causes windows in this group to be displayed with‐
472                            out a border.
473
474                     nofocus
475                            Prevents  windows  in  the group from grabbing the
476                            focus when mapped.
477
478                     nolist
479                            Causes the tray to ignore windows in this group.
480
481                     notitle
482                            Causes windows in this group to be displayed with‐
483                            out a title bar.
484
485                     pignore
486                            Ignore  initial  window position requested by pro‐
487                            gram.
488
489                     shaded
490                            Make windows in this group initially shaded.
491
492                     sticky
493                            Make windows in this group sticky.
494
495                     opacity:#
496                            Set the opacity for windows in  this  group.   The
497                            value is a number between 0.0 and 1.0 inclusive.
498
499                     title
500                            Causes windows in this group to have a title bar.
501
502       WINDOW STYLE
503              The WindowStyle tag controls the look of window borders.  Within
504              this tag, the following tags are supported:
505
506              Font
507                     The font used for title bars. See the FONTS  section  for
508                     more information.
509
510              Width
511                     The  width of window borders in pixels. The default is 4,
512                     the minimum is 1, and the maximum is 32.
513
514              Height
515                     The height of window title bars in pixels. The default is
516                     20, the minimum is 2, and the maximum is 64.
517
518              Opacity
519                     The opacity of the window. This is a floating point value
520                     between 0.0 and 1.0.  Note that a composite manager, such
521                     as xcompmgr, is required for this.
522
523              Active
524                     The  colors  used  for  the active window. See the COLORS
525                     section for more information  on  colors.  The  following
526                     tags are supported:
527
528                     Text
529                            The  color  of text on the title bar.  The default
530                            is black.
531
532                     Title
533                            The color of the title  bar  (gradients  are  sup‐
534                            ported).  The default is red:red.
535
536                     Outline
537                            The  color  of the window outline.  The default is
538                            black.
539
540              Inactive
541                     The colors used for inactive windows. See the COLORS sec‐
542                     tion  for  more information on colors. The following tags
543                     are supported:
544
545                     Text
546                            The color of text on the title bar.   The  default
547                            is black.
548
549                     Title
550                            The  color  of  the  title bar (gradients are sup‐
551                            ported).  The default is gray:gray.
552
553                     Outline
554                            The color of the window outline.  The  default  is
555                            black.
556
557       TRAY STYLE
558              The  TrayStyle  tag controls the look of trays.  Within this tag
559              the following tag is supported:
560
561              Font
562                     The default tray font to use. See the FONTS  section  for
563                     more information.
564
565              Foreground
566                     The  default foreground color. See the COLORS section for
567                     more information.
568
569              Background
570                     The default background color. See the COLORS section  for
571                     more information.
572
573              Opacity
574                     The opacity of the window. This is a floating point value
575                     between 0.0 and 1.0.  Note that a composite manager, such
576                     as xcompmgr, is required for this.
577
578       TASK LIST STYLE
579              The TaskListStyle tag controls the look of task lists.  This tag
580              supports the following attribute:
581
582              insert mode
583                     This determines how new items are added to the task list.
584                     Valid options are left and right. The default is right.
585
586              Within this tag the following tags are supported:
587
588              Font
589                     The  font  used  for program names. See the FONTS section
590                     for more information.
591
592              Foreground
593                     The foreground color of the task  list  items.   See  the
594                     COLORS section for more information.
595
596              Background
597                     The  background  color  of the task list items (gradients
598                     are supported).  See the COLORS section for more informa‐
599                     tion.
600
601              ActiveForeground
602                     The  foreground color of an active item on the task list.
603                     See the COLORS section for more information.
604
605              ActiveBackground
606                     The background color of an active item on the  task  list
607                     (gradients  are  supported).  See  the COLORS section for
608                     more information.
609
610       CLOCK STYLE
611              The ClockStyle tag controls the look  of  clocks.   Within  this
612              tag, the following tags are supported.
613
614              Font
615                     The  font  used.  See the FONTS section for more informa‐
616                     tion.
617
618              Foreground
619                     The color of the text. See the COLORS  section  for  more
620                     information.
621
622              Background
623                     The  background  color.  See  the COLORS section for more
624                     information.
625
626       PAGER STYLE
627              The PagerStyle tag controls the look  of  pagers.   Within  this
628              tag, the following tags are supported:
629
630              Outline
631                     The  color  of  the  outline  around windows shown in the
632                     pager. See the COLORS section for more information.
633
634              Foreground
635                     The color of inactive windows shown in the pager. See the
636                     COLORS section for more information.
637
638              Background
639                     The  background  color  of inactive desktops shown in the
640                     pager. See the COLORS section for more information.
641
642              ActiveForeground
643                     The color of active windows shown in the pager.  See  the
644                     COLORS section for more information.
645
646              ActiveBackground
647                     The  background  color  of  active  desktops shown in the
648                     pager. See the COLORS section for more information.
649
650              Text
651                     The color to use for pager labels. See the COLORS section
652                     for more information.
653
654              Font
655                     The  font to use for pager labels. See the COLORS section
656                     for more information.
657
658       MENU STYLE
659              The MenuStyle tag controls the look of the menus  in  JWM  (this
660              includes  the  root menu and window menus).  Within this tag the
661              following tags are supported:
662
663              Font
664                     The font used on menus See the  FONTS  section  for  more
665                     information.
666
667              Foreground
668                     The  text  color  of  inactive menu items. See the COLORS
669                     section for more information.
670
671              Background
672                     The background color of inactive menu items. See the COL‐
673                     ORSsection for more information.
674
675              ActiveForeground
676                     The text color of active menu items.  See the COLORS sec‐
677                     tion for more information.
678
679              ActiveBackground
680                     Text background color of active menu items (gradients are
681                     supported).  See the COLORS section for more information.
682
683              Opacity
684                     The opacity of the window. This is a floating point value
685                     between 0.0 and 1.0.  Note that a composite manager, such
686                     as xcompmgr, is required for this.
687
688       POPUP STYLE
689              The  PopupStyle  tag  controls the look of popup windows such as
690              those shown when the mouse sits over a task list item.  This tag
691              supports the following attributes:
692
693              delay int
694                     The  delay  in  milliseconds before popups activate.  The
695                     default is 600.
696
697              enabled bool
698                     Determine if popups are shown. Default is true.
699
700              Within this tag the following tags are supported:
701
702              Font
703                     The font to use. See the FONTS section for more  informa‐
704                     tion.
705
706              Outline
707                     The  color  of the window outline. See the COLORS section
708                     for more information.
709
710              Foreground
711                     The text color. See the COLORS section for more  informa‐
712                     tion.
713
714              Background
715                     The  background  color.  See  the COLORS section for more
716                     information.
717
718       FONTS
719              Fonts for various parts of JWM are specified within a Font  tag.
720              The  text  of  this tag determines the font to use.  This can be
721              either a standard X font string or, if compiled  with  XFT  sup‐
722              port, an XFT font string.
723
724       COLORS
725              Colors  for  various  parts of JWM are specified within specific
726              tags (discribed above). Colors may either be hex triplets in RGB
727              format  (for example, #FF0000 is red) or by a name recognized by
728              the X server.  For components that support gradients, two colors
729              may be specified separated by a colon.
730
731       ICONS
732              Icons for windows that don't supply an icon via the _NET_WM_ICON
733              hint are located by searching the icon  search  path(s)  for  an
734              icon  whose  name (minus the ".xpm" or ".png" extension) matches
735              the instance name of the window  as  returned  in  the  WM_CLASS
736              hint.  If  this  lookup  fails, a default icon is supplied. This
737              icon will be displayed for the window on it's title bar  and  on
738              the  task  list.  Icons that are not an appropriate size will be
739              scaled. Square icons work best.
740
741              For menu items, the icon path is searched for a match. the  icon
742              specified  for  a  menu  item must be the exact name of the icon
743              file with the extension.  If no match is  found,  a  blank  area
744              will  appear  where  the  icon should appear.  If an icon is not
745              specified for any menu item in a menu, no space  will  be  allo‐
746              cated for icons.
747
748              Zero  or  more  IconPath tags may be specified. The text of this
749              tag is assumed to be an absolute directory path to  a  directory
750              containing  XPM,  PNG,  and/or  JPEG  icons.  When searching for
751              icons, if multiple paths are provided, they will be searched  in
752              order until a match is made.  Note that icon, PNG, JPEG, and XPM
753              support are compile-time options.
754
755       KEY BINDINGS
756              Keyboard bindings in JWM are specified in Key tags.  Either  the
757              key  or  keycode attributes must be specified to determine which
758              key will cause an action. The optional attribute,  mask,  speci‐
759              fies what key mask, if any, must be in effect for the binding to
760              match. Finally, the text of the Key tag is the  action  to  per‐
761              form.
762
763              One or more of the following key masks may be specified for mask
764              (see xmodmap(1)):
765
766                     A      The "Alt" key (mod1).
767
768                     C      Control
769
770                     S      Shift
771
772                     1      mod1
773
774                     2      mod2
775
776                     3      mod3
777
778                     4      mod4
779
780                     5      mod5
781
782              The key specified in the key attribute must contain a valid  key
783              string for XStringToKeysym(3). These values are usually what one
784              would expect (for example, the escape key is called "Escape").
785
786              Valid actions for a key binding are:
787
788                     up     Move up. Not grabbed.
789
790                     down   Move down. Not grabbed.
791
792                     right  Move right. Not grabbed.
793
794                     left   Move left. Not grabbed.
795
796                     escape Stop a move/resize or exit a menu. Not grabbed.
797
798                     select Make a menu selection. Not grabbed.
799
800                     next   Move to the next window in the task list. Grabbed.
801
802                     nextstacked
803                            Move to the next window  in  the  stacking  order.
804                            Grabbed.
805
806                     prev   Move  to  the  previous  window  in the task list.
807                            Grabbed.
808
809                     prevstacked
810                            Move to the previous window in the stacking order.
811                            Grabbed.
812
813                     close  Close the active window. Grabbed.
814
815                     minimize
816                            Minimize the active window. Grabbed.
817
818                     maximize
819                            Maximize the active window. Grabbed.
820
821                     shade  Shade the active window. Grabbed.
822
823                     stick  Stick/unstick the active window. Grabbed.
824
825                     move   Move the active window. Grabbed.
826
827                     resize Resize the active window. Grabbed.
828
829                     root:n Show root menu n. Grabbed.
830
831                     window Show  the  window  menu  for  the  active  window.
832                            Grabbed.
833
834                     desktop#
835                            Switch to a specific desktop.  To  use  this,  "#"
836                            must be specified in the key section. The number 1
837                            to the number of desktops configured are then sub‐
838                            stituted for "#". Grabbed.
839
840                     rdesktop
841                            Move one desktop to the right. Grabbed.
842
843                     ldesktop
844                            Move one desktop to the left. Grabbed.
845
846                     udesktop
847                            Move up one desktop. Grabbed.
848
849                     ddesktop
850                            Move down one desktop. Grabbed.
851
852                     showdesktop
853                            Show/hide  the desktop (maximize/minimize all win‐
854                            dows). Grabbed.
855
856                     showtray
857                            Unhide the tray (when using autohide). Grabbed.
858
859                     exec:command
860                            Execute command. Grabbed.
861
862                     restart
863                            Restart JWM. Grabbed.
864
865              Note that keys that are grabbed will not be available to  appli‐
866              cations other than JWM since JWM will interpret these. Also note
867              that there are no default key bindings. Finally, it is  possible
868              to bind multiple key combinations to the same action.
869
870       MOUSE BINDINGS
871              Any button (other than the scroll wheel) on the root window will
872              bring up the root  menu  unless  otherwise  specified   via  the
873              onroot  attribute  of  RootMenu. Scrolling up on the root window
874              switches to the previous desktop and scrolling down switches  to
875              the next desktop.
876
877              The right button will show the window menu on the frame.
878
879              The  left  button will resize if on the border or move if in the
880              title bar.
881
882              The middle button will move anywhere on the frame.
883
884              A double click on the title bar of a window will toggle the max‐
885              imized state of the window. Scrolling up over the title bar will
886              shade the window and scrolling down  will  unshade  the  window.
887              When  a  menu is open, the scroll wheel will move through menus.
888              When over the pager, the  scroll  wheel  will  switch  desktops.
889              When over a task list, the scroll wheel will switch windows.
890
891       DESKTOPS
892              Virtual  desktops  are controlled with the Desktops tag.  Within
893              this tag the following attribute is supported:
894
895              width int
896                     The number of virtual desktops in the  horizontal  direc‐
897                     tion.  The default is 4.
898
899              height int
900                     The number of virtual desktops in the vertical direction.
901                     The default is 1.
902
903              Within the Desktops tag the following tags are supported:
904
905              Background
906                     The default background for desktops. The  type  attribute
907                     determines  the type of background and the text contained
908                     within this tag is the value. Valid types are:
909
910                     solid
911                            A solid color. See the  COLORS  section  for  more
912                            information.  This is the default.
913                     gradient
914                            A  gradient color. See the COLORS section for more
915                            information.
916                     image
917                            A stretched image. This may be  an  XPM,  PNG,  or
918                            JPEG  image.  Note  that support for XPM, PNG, and
919                            JPEG images must be compiled in and  icon  support
920                            is required.
921                     tile
922                            A  tiled image. Like image, but the image is tiled
923                            instead of stretched.
924                     command
925                            A command to run for setting the background.
926
927              Desktop
928                     Desktop-specific data. The name attribute may  be  speci‐
929                     fied to name the desktop (the default is the desktop num‐
930                     ber). Within this tag a Background tag may  be  specified
931                     for  a desktop-specific background.  See Background above
932                     for more information.
933
934       OTHER SETTINGS
935
936              The following tags may also be supplied:
937
938              DoubleClickDelta
939                     The number of pixels the mouse can move during  a  double
940                     click.   The default is 2. Valid values are between 0 and
941                     32 inclusive.
942
943              DoubleClickSpeed
944                     The maximum number of milliseconds between clicks  for  a
945                     double  click.   The  default  is  400.  Valid values are
946                     between 1 and 2000 inclusive.
947
948              FocusModel
949                     The focus model to be  used.  The  default  is  "sloppy".
950                     Valid  values  are  "click" (click to focus) and "sloppy"
951                     (focus follows mouse).
952
953              MoveMode
954                     The move mode. The default is "opaque". Valid values  are
955                     "opaque"   and   "outline".   The   optional  coordinates
956                     attribute determines the location of the move status win‐
957                     dow. Possible values are:
958
959                            off
960                                   Disable the status window.
961
962                            corner
963                                   Place  the  status  window in the corner of
964                                   the screen.
965
966                            window
967                                   Center the  status  window  on  the  window
968                                   being moved.
969
970                            screen
971                                   Center the status window on the screen.
972
973              ResizeMode
974                     The  resize  mode.  The default is "opaque". Valid values
975                     are "opaque"  and  "outline".  The  optional  coordinates
976                     attribute determines the location of the move status win‐
977                     dow. Possible values are:
978
979                            off
980                                   Disable the status window.
981
982                            corner
983                                   Place the status window in  the  corner  of
984                                   the screen.
985
986                            window
987                                   Center  the  status  window  on  the window
988                                   being resized.
989
990                            screen
991                                   Center the status window on the screen.
992
993              SnapMode
994                     The snap mode. The default is "border". Valid values  are
995                     "none"  (for  no snapping), "screen" (for snapping to the
996                     edge of the screen), and "border" (for  snapping  to  the
997                     borders   of   windows  and  the  screen).   An  optional
998                     attribute, distance, specifies the distance for snapping.
999                     The  default  is  5.  Valid  values  are between 1 and 32
1000                     inclusive.
1001
1002              StartupCommand
1003                     A command to run when JWM starts.
1004
1005              ShutdownCommand
1006                     A command to run when JWM exits.
1007
1008              RestartCommand
1009                     A command to run when JWM restarts.
1010
1011              ButtonClose
1012                     Path to a bitmask for the close button on windows.
1013
1014              ButtonMax
1015                     Path to a bitmask for the  maximize  button  on  inactive
1016                     windows.
1017
1018              ButtonMaxActive
1019                     Path  to a bitmask for the maximize button on active win‐
1020                     dows.
1021
1022              ButtonMin
1023                     Path to a bitmask for the minimize button on windows.
1024

AUTHOR

1026       Joe Wingbermuehle <joewing@joewing.net>
1027
1028

SEE ALSO

1030       X(1)
1031
1032
1033
1034
1035vsvn-500                          2011-09-02                            jwm(1)
Impressum