1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810
|
.\" t
.\" @(#)fvwm-2.6.7 06 November 2016
.de EX \"Begin example
.ne 5
.if n .sp 1
.if t .sp .5
.nf
.in +.5i
..
.de EE
.fi
.in -.5i
.if n .sp 1
.if t .sp .5
..
.TH FvwmIconMan 1 "06 November 2016 (2.6.7)" Fvwm "Fvwm Modules"
.UC
.SH NAME
FvwmIconMan \- an fvwm icon manager
.SH SYNOPSIS
FvwmIconMan is spawned by fvwm, so no command line invocation will work.
.SH DESCRIPTION
FvwmIconMan is an icon manager modeled after the TWM icon manager.
The user may have multiple icon managers, each of which armed with
a list of window types which it manages. For example, the user may
have one manager which lists only emacs windows, and another which
lists everything else. You may also specify what resolution each
icon manager uses, for example, one icon manager may manage
windows on all desks, and another may manage only those on the
current desk, page or screen. FvwmIconMan can display the
miniature icons provided by fvwm for its managed windows. The
managers may have a maximum number of columns (and so grows
vertically), a maximum number of rows (and then grows
horizontally), or stay at a fixed size, and adjust the size of the
window buttons to fit (think win95's Taskbar). And when support is
compiled in for the X Shape extension, then the manager windows
may be shaped.
You can specify actions to be run when mouse, or key events are received. For
example, you could bind the first mouse button to iconify the selected window,
and make bindings for the arrow keys to navigate the manager window without
the mouse.
FvwmIconMan can be set to display which window currently has the keyboard
focus, and by binding the select event (see below) to the fvwm Focus function,
you can emulate the TWM icon manager's behavior.
.SH INITIALIZATION
During initialization, FvwmIconMan searches though the fvwm configuration file
for the options which are described below. It is highly recommended that you
make FvwmIconMan be a sticky window. And if you want to make use of the
followfocus option, and/or binding an action to Focus, then you should make
FvwmIconMan clicktofocus. Also, when using the Shape option, it's recommended
that the FvwmIconMan window not be decorated at all by fvwm.
.SH INVOCATION
FvwmIconMan can be invoked by inserting the line 'Module FvwmIconMan' in
the .fvwm2rc file. If FvwmIconMan is to be spawned during fvwm's
initialization, then this line should be placed in the StartFunction
declarations, or it can be bound to a menu, mouse button, or keystroke to
invoke it later.
If you wish to run FvwmIconMan in a transient mode, such as with the built in
window list, then pass "-Transient" as an argument. The invocation "Module
FvwmIconMan -Transient" will do nicely. In this mode, FvwmIconMan will pop up
one manager window directly under the cursor. When the mouse button is
released, it will execute the appropriate action, and then exit. Things are
somewhat complicated by the fact that you can specify that FvwmIconMan creates
multiple manager windows, behavior which is unsuitable when running
transiently. So, when running transiently, FvwmIconMan will only create one
manager window. Use the manager id 'transient' to specify options for this
manager window.
FvwmIconMan may accept an alias name as an argument.
For example, "Module FvwmIconMan FvwmIconMan-Variant2".
.SH CONFIGURATION OPTIONS REFERENCE CHART
FvwmIconMan has acquired quite a few options. I assume others
share my dislike of paging though a long man page, so here is a
terse reference chart describing the available options. They are
described in more detail in the next section.
.ft C \" Courier
.nf
Name Description Default
.ft P
NumManagers number of managers 1
Action binds command to event Mouse 0 N sendcommand Iconify
Background default background gray
ButtonGeometry size of button in pixels
Colorset default colorset
DontShow list of windows to ignore
DrawIcons use mini icons false
FocusAndSelectButton flat grey black
FocusAndSelectColorset
FocusButton style for focused buttons up grey black
FocusColorset
FollowFocus show which win has focus false
Font 8x13
Foreground default text color white
Format describes button label "%c: %i"
IconName manager icon name FvwmIconMan
IconAndSelectButton up black grey
IconAndSelectColorset
IconButton style for icon buttons up black grey
IconColorset
ManagerGeometry size of manager in buttons 0x1
MaxButtonWidth max width of a button
MaxButtonWidthByColumns
NoIconAction animate iconification NOP
PlainButton style for normal buttons up black grey
PlainColorset
ReliefThickness size of button relief 2
Resolution global/desk/page/screen page
Reverse normal, icon or none none
SelectButton style for selected buttons flat black grey
SelectColorset
Shape use shape extension false
Show list of windows to show
ShowOnlyIcons only icons visible false
ShowNoIcons icons are not displayed false
ShowTransient transient windows visible false
ShowOnlyFocused only focused visible false
Sort keep managers sorted name
SortWeight weight for sorting
Tips Tool Tips mode none
TipsDelays Tool Tips mapping delays 1000 300
TipsFont Font for Tool Tips default fvwm font
TipsColorset Tool Tips Colorset 0
TipsFormat describes Tips label the Format value
TipsBorderWidth Tool Tips border size 1
TipsPlacement Tips placement vs button updown
TipsJustification Tips Just vs button leftup
TipsOffsets Tips placement Offsets 3 2
Title manager title FvwmIconMan
TitleButton style for title button raisededge black grey
TitleColorset
UseWinList honor WinListSkip? true
.fi
.SH CONFIGURATION OPTIONS
With the exception of the nummanagers option, all of the options may be
defined on a per-manager basis. So, for example, the user may have his emacs
manager with a red foreground, and his xterm manager with a blue one. A
configuration line may therefore have one of two forms:
.IP "*FvwmIconMan: OptionName OptionValue"
To specify that the \fIOptionName\fP takes the value \fIOptionValue\fP
for all managers.
.IP "*FvwmIconMan: ManagerId OptionName OptionValue"
To specify that the option \fIOptionName\fP takes the value \fIOptionValue\fP
for manager \fIManagerId\fP. \fIManagerId\fP may either be a positive integer,
or the string "transient". An integer id refers to managers which FvwmIconMan
creates when running normally, and an id of "transient" refers to the single
manager which FvwmIconMan creates when running transiently.
The old syntax, that uses an asterisk instead of white spaces
before \fIManagerId\fP and \fIOptionName\fP, is supported too,
but it is obsolete now.
.PP
The following options may be specified:
.IP "*FvwmIconMan: NumManagers \fInum\fP"
\fInum\fP is a positive integer specifying the total number of icon managers.
Since FvwmIconMan would like to know how many managers there are before
handling any manager specific options, this should come first. The default
is 1.
.IP "*FvwmIconMan: [id] Action \fItype\fP \fIbinding\fP"
Binds an FvwmIconMan command to an event. \fIType\fP may be one of the values:
Key, Mouse, or Select. Actions are described in the following section ACTIONS.
.IP "*FvwmIconMan: [id] Background \fIbackground\fP"
Specifies the default background color.
.IP "*FvwmIconMan: [id] ButtonGeometry \fIgeometry\fP"
Specifies the initial geometry of an individual button in pixels. If the
specified height is 0, then the button height is determined from the font
size. X and Y coordinates are ignored.
.IP "*FvwmIconMan: [id] Colorset \fIcolorset\fP"
The default colorset used. Overrides background and foreground. See FvwmTheme.
.IP "*FvwmIconMan: [id] DrawIcons \fIvalue\fP"
If your version of fvwm is capable of using mini icons, then this option
determines if FvwmIconMan displays the mini icons. Otherwise, it generates
an error message. "true" means that mini icons are shown for iconified
windows, "false" that mini icons are never shown, and "always" that mini icons
are shown for all windows.
.IP "*FvwmIconMan: [id] FocusAndSelectButton \fIstyle\fP [\fIforecolor\fP \fIbackcolor\fP]"
Same as the plainbutton option, but specifies the look of buttons which are
both selected, and have the keyboard focus.
.IP "*FvwmIconMan: [id] FocusAndSelectColorset \fIcolorset\fP"
Works like focusandselectbutton but uses colorsets instead. The style setting can
still only be applied with focusandselectbutton. See FvwmTheme.
.IP "*FvwmIconMan: [id] FocusButton \fIstyle\fP [\fIforecolor\fP \fIbackcolor\fP]"
Same as the plainbutton option, but specifies the look of buttons whose
windows have the keyboard focus.
.IP "*FvwmIconMan: [id] FocusColorset \fIcolorset\fP"
Works like focusbutton but uses colorsets instead. The style setting can still
only be applied with focusbutton. See FvwmTheme.
.IP "*FvwmIconMan: [id] FollowFocus \fIboolean\fP"
If \fItrue\fP, then the button appearance reflects
which window currently has focus. Default is false.
.IP "*FvwmIconMan: [id] Font \fIfont\fP"
Specifies the font to be used for labeling the buttons. The default is 8x13.
.IP "*FvwmIconMan: [id] Foreground \fIforeground\fP"
Specifies the default foreground color.
.IP "*FvwmIconMan: [id] Format \fIformatstring\fP"
A printf like format string which describes the string to be printed in the
manager window for each managed window. Possible flags are: %t, %i, %c, and
%r for the window's title, icon title, class, or resource name, respectively.
The default is "%c: %i". \fBWarning\fP: m4 reserves the word \fIformat\fP,
so if you use m4, take appropriate action.
.IP "*FvwmIconMan: [id] IconName \fIiconstring\fP"
Specifies the window icon name for that manager window. \fIIconstring\fP
may either be a single word, or a string enclosed in quotes. The default is
"FvwmIconMan".
.IP "*FvwmIconMan: [id] IconAndSelectButton \fIstyle\fP [\fIforecolor\fP \fIbackcolor\fP]"
Same as the plainbutton option, but specifies the look of buttons whose
windows are iconified and the button is selected.
.IP "*FvwmIconMan: [id] IconButton \fIstyle\fP [\fIforecolor\fP \fIbackcolor\fP]"
Same as the plainbutton option, but specifies the look of buttons whose
windows are iconified.
.IP "*FvwmIconMan: [id] IconAndSelectColorset \fIcolorset\fP"
Works like IconAndSelectButton but uses colorsets instead. The style setting
can still only be applied with iconbutton. See FvwmTheme.
.IP "*FvwmIconMan: [id] IconColorset \fIcolorset\fP"
Works like iconbutton but uses colorsets instead. The style setting can still
only be applied with iconbutton. See FvwmTheme.
.IP "*FvwmIconMan: [id] ManagerGeometry \fIgeometry\fP"
Specifies the initial geometry of the manager, in units of buttons. If
\fIheight\fP is 0, then the manager will use \fIwidth\fP columns, and will
grow vertically once it has more than \fIwidth\fP windows. Likewise, if
\fIwidth\fP is 0, it will use \fIheight\fP rows, and grow horizontally. If
both are nonzero, then the manager window will be exactly that size, and stay
that way. As columns are created, the buttons will narrow to accommodate. If
the geometry is specified with a negative y coordinate, then the window
manager will grow upwards. Otherwise, it will grow downwards.
.IP "*FvwmIconMan: [id] MaxButtonWidth \fIwidth\fP"
Defines a maximum for the width of a button (in pixels). By default there
is no maximum. A value of 0 resets the default. The maximum is only used
with a non growing manager (the ManagerGeometry option
specifies non zero width and height).
.IP "*FvwmIconMan: [id] MaxButtonWidthByColumns \fIcol\fP"
This is another way to set the button width.
col is the number of columns of icons.
The button width is determined by dividing
the total width of FvwmIconMan
by the number of columns.
For example if the
width of FvwmIconMan manager is 1024, MaxButtonWidthByColumns is 4
then MaxButtonWidth is 256.
This is useful when you do not
know, at config time, the width of the manager, for example,
for a swallowed FvwmIconMan.
.IP "*FvwmIconMan: [id] NoIconAction \fIaction\fP"
Tells FvwmIconMan to do \fIaction\fP when a NoIcon style window is
iconified or de-iconified. Relevant coordinates are appended to \fIaction\fP so
that the icon can be traced to an FvwmIconMan button. An example action
is "*FvwwmIconMan: NoIconAction SendToModule FvwmAnimate animate". A blank or
null action turns this feature off.
.IP "*FvwmIconMan: [id] PlainButton \fIstyle\fP [\fIforecolor\fP \fIbackcolor\fP]"
Specifies how normal buttons look. \fIstyle\fP may be one of \fIflat\fP,
\fIup\fP, \fIdown\fP, \fIraisededge\fP, or \fIsunkedge\fP, and describes how
the button is drawn. The color options are both optional, and if not set, then
the default colors are used. If on a monochrome screen, then the \fIstyle\fP
option is ignored, but must still be set.
.IP "*FvwmIconMan: [id] PlainColorset \fIcolorset\fP"
Works like plainbutton but uses colorsets instead. The style setting can
still only be applied with plainbutton. See FvwmTheme.
.IP "*FvwmIconMan: [id] ReliefThickness \fInum\fP"
\fInum\fP is an integer specifying the number of pixels thick
that the relief at the edge of non-flat buttons should be. Setting
this to 0 will produce flat buttons, as if the values for
\fIFocusAndSelectButton\fP, \fIFocusButton\fP, \fIIconAndSelectButton\fP,
\fIIconButton\fP, \fIPlainButton\fP, \fISelectButton\fP, and \fITitleButton\fP
were all set to \fIflat\fP. If \fInum\fP is negative, the button will be
inverted as if you had used \fIReverse\fP for all classes.
.IP "*FvwmIconMan: [id] Resolution \fIresolution\fP"
Specifies when the manager will display an entry for a certain
window. \fIresolution\fP may take one of the following values:
global, desk, page, screen, !desk, !page, or !screen. If global,
then all windows of the appropriate type (see the show and
dontshow options below) will be shown. If desk, then only those
windows on the current desk are shown. If page, then only those
windows on the current page are shown. If screen, then only those
windows on the current Xinerama screen are shown. !desk reverses
the sense of desk, displaying only those windows not on the
current desk. Likewise, !page shows only those windows not on the
current page and !screen shows only those windows not on the
current Xinerama screen. The default is page. If Xinerama is not
active or only a single screen is used, page and screen are
equivalent.
This configuration line is respected when FvwmIconMan is running
as well, the resolution is changed dynamically.
.IP "*FvwmIconMan: [id] Reverse \fIclass\fP"
Causes certain classes of buttons to have their relief lines reversed so that
up and down styles are reversed. This has no affect on flat buttons. The class
can be icon, normal or none. The default is none.
.IP "*FvwmIconMan: [id] SelectButton \fIstyle\fP [\fIforecolor\fP \fIbackcolor\fP]"
Same as the plainbutton option, but specifies the look of buttons when the
mouse is over them.
.IP "*FvwmIconMan: [id] SelectColorset \fIcolorset\fP"
Works like selectbutton but uses colorsets instead. The style setting can
still only be applied with selectbutton. See FvwmTheme.
.IP "*FvwmIconMan: [id] Shape \fIboolean\fP"
If \fITrue\fP, then use make the window shaped. Probably only useful if you
have multiple columns or rows. If FvwmIconMan wasn't compiled to support the
Shape extension, this generates an error message. When using shaped windows,
it's recommended that a fvwm style is made for FvwmIconMan that has no borders.
Otherwise, fvwm will get confused.
.IP "*FvwmIconMan: [id] Sort \fIvalue\fP"
If \fIname\fP, then the manager list is sorted by name. If \fInamewithcase\fP,
then it is sorted by name sensitive to case. If \fIid\fP, then
the manager list is sorted by the window id, which never changes after the
window is created. If \fIweighted\fP, then the manager list is sorted by
weight (see the description of \fIsortweight\fP below). Or it can be set to
\fInone\fP, which results in no sorting. Default is \fIname\fP.
.IP "*FvwmIconMan: [id] SortWeight \fIweight\fP \fIpattern-list\fP"
Assigns the specified \fIweight\fP to windows that match \fIpattern-list\fP.
The list is made up of patterns of the form \fItype=pattern\fP, where type
is one of \fIclass\fP, \fIresource\fP, \fItitle\fP, or \fIicon\fP, and pattern
is an expression of the same format used in the fvwm style command
(minimalistic shell pattern matching). Multiple sort weights can be given.
Each window is matched against the list of sort weights, in order, and is
given the weight from the first match. Lower-weighted windows are placed
first in the manager list. For example:
.EX
*FvwmIconMan: Sort weighted
*FvwmIconMan: SortWeight 1 class=XTerm title=special*
*FvwmIconMan: SortWeight 10 class=XTerm
*FvwmIconMan: SortWeight 5
.EE
In this example, xterm windows whose titles start with "special" (weight 1)
are listed first, followed by everything but other xterms (weight 5), and the
other xterms (weight 10) are listed last. If no default weight (empty pattern
list) is given, the default weight is 0. Only relevant if the sort type is
set to \fIweighted\fP.
.IP "*FvwmIconMan: [id] Title \fItitle-string\fP"
Specifies the window title string for that manager window. \fITitlestring\fP
may either be a single word, or a string enclosed in quotes. The default is
"FvwmIconMan". This will be drawn in the title bar of the manager window, if
any, and in the title button, which is the button drawn when the manager is
empty.
.IP "*FvwmIconMan: [id] TitleButton \fIstyle\fP [\fIforecolor\fP \fIbackcolor\fP]"
Same as the plainbutton option, but specifies the look of the title button
(the button drawn when the manager is empty). The manager's title is drawn
in the title button.
.IP "*FvwmIconMan: [id] UseWinList \fIboolean\fP"
If \fItrue\fP, then honor the WinListSkip style flag. Otherwise, all windows
are subject to possible management according to the show and dontshow lists.
.PP
The two following options control which windows get handled by which
managers. A manager can get two lists, one of windows to show, and one of
windows to ignore. If only the \fIshow\fP list is given, then that manager
will show only the windows in the list. If only the \fIDontShow\fP list is
given, then the manager will show all windows except those in the list. If
both lists are given, then a window will be shown if it is not in the
\fIDontShow\fP list, and in the \fIShow\fP list. And finally, if neither list
is given, then the manager will handle all windows. Each list is made up of
patterns of the form \fItype=pattern\fP, where type is one of \fIclass\fP,
\fIresource\fP, \fItitle\fP, or \fIicon\fP, and pattern is an expression of
the same format used in the fvwm style command (minimalistic shell pattern
matching). Quotes around the pattern will be taken as part of the
expression. If a window could be handled by more than one manager, then the
manager with the lowest id gets it.
.IP "*FvwmIconMan: [id] Show \fIpattern list\fP"
If a window matches one of the patterns in the list, then it may be handled
by this manager.
.IP "*FvwmIconMan: [id] DontShow \fIpattern list\fP"
If a window matches one of the patterns in the list, then it may not be
handled by this manager.
.IP "*FvwmIconMan: [id] ShowTransient \fIboolean\fP"
Show transient windows in the list (default false).
.IP "*FvwmIconMan: [id] ShowOnlyIcons \fIboolean\fP"
Only iconified windows are shown if \fIboolean\fP is true.
.IP "*FvwmIconMan: [id] ShowNoIcons \fIboolean\fP"
Only windows that are not iconified are shown if \fIboolean\fP is true.
.IP "*FvwmIconMan: [id] ShowOnlyFocused \fIboolean\fP"
Only window with the focus is shown if \fIboolean\fP is true.
.PP
The following two options control tips.
.IP "*FvwmIconMan: [id] Tips \fIvalue\fP"
where \fIvalue\fP can be always, needed or false. Default is false,
no tips are displayed. With always, tips are enabled. With needed,
a tip is displayed only if either the button string is truncated or
the tip string is not equal to the button string.
This configuration line is respected when FvwmIconMan is running
as well.
.IP "*FvwmIconMan: [id] TipsDelays \fIdelay\fP [\fImappeddelay\fP]"
where \fIdelay\fP and \fImappeddelay\fP are time out values in milliseconds.
If no \fImappeddelay\fP is given \fIdelay\fP is assumed. Default is
1000 300. When the cursor is on a button, FvwmIconMan wait \fIdelay\fP
milliseconds before displaying the tip. In the case where a tip is
already mapped and the cursor goes to another button, FvwmIconMan
waits \fImappeddelay\fP milliseconds before displaying the new tip.
.IP "*FvwmIconMan: [id] TipsFont \fIfontname\fP"
Specifies the font to be used for tips. Default is the default fvwm
font.
.IP "*FvwmIconMan: [id] TipsColorset \fIcolorset\fP"
Specifies the colors for tips window. Default is colorset 0.
See FvwmTheme.
.IP "*FvwmIconMan: [id] TipsFormat \fIformatstring\fP"
Similar to the Format option but for the tips window. The default is
the format string from the Format option.
.IP "*FvwmIconMan: [id] TipsBorderWidth \fIpixels\fP"
Specifies the border width (in pixels) of the tips window. Default is 1.
.IP "*FvwmIconMan: [id] TipsPlacement \fIvalue\fP"
where \fIvalue\fP can be up, down, right, left, updown or
leftright. This value specifies the position of the tips window
relative to its button.
Default is updown where buttons on the top half of the screen
get tips below the button, otherwise the tips
are above the button.
.IP "*FvwmIconMan: [id] TipsJustification \fIvalue\fP"
where \fIvalue\fP can be leftup, rightdown or center.
Specifies
the justification (direction) of the tips window relative to its button after
the tips window has been placed.
Default is leftup which means that if a tip is placed above or below
its button, then the left border of the tip and of the button are
aligned.
If the tip is placed on the left or on the right of its button, leftup
aligns the top borders. rightdown and center work like leftup but in
different directions.
The alignment is adjusted by the TipsOffset option.
See next option.
.IP "*FvwmIconMan: [id] TipsOffsets \fIplacementoffset\fP \fIjustoffset\fP"
where \fIplacementoffset\fP and \fIjustoffset\fP are offsets in pixels
for the TipsPlacement and TipsJustification configuration option.
Default is 3 2.
.SH ACTIONS
Actions are commands which may be bound to an event of the type: a key press, a
mouse click, or the mouse entering a window manager button - denoted by the
action types \fIKey\fP, \fIMouse\fP, and \fISelect\fP.
Normally, actions bound to a mouse click are executed when the button is
pressed. In transient mode, the action is executed when the button is
released, since it is assumed that FvwmIconMan was bound to some mouse
event. A tip/warning: FvwmIconMan still keeps track of the mouse button and
any modifier keys in this case, so if you bind FvwmIconMan to say,
meta-button3, then it would be wise to ensure that the action you want to
execute will be executed when the meta-button3 event occurs (which would be
the button release, assuming you kept your finger on the meta key).
The syntax for actions are:
.IP "\fBKey actions\fP: Key \fIKeysym\fP \fIModifiers\fP \fIFunctionList\fP"
\fIKeysym\fP and \fIModifiers\fP are exactly the same as for the fvwm \fIKey\fP
command.
.IP "\fBMouse actions\fP: Mouse \fIButton\fP \fIModifiers\fP \fIFunctionList\fP"
\fIButton\fP and \fIModifiers\fP are exactly the same as for the fvwm
\fIMouse\fP command.
.IP "\fBSelect actions\fP: Select \fIFunctionList\fP"
.PP
A \fIFunctionList\fP is a sequence of commands separated by commas. They are
executed in left to right order, in one shared context - which currently only
contains a pointer to the "current" button. If a button is selected (typically
by the mouse pointer sitting on it) when the action is executed, then the
current button is initialized to that button. Otherwise, it points to nothing.
Most of the available commands then modify this "current" button, either by
moving it around, making it become the selected button, or sending commands
to fvwm acting on the window represented by that button. Note that while this
current button is initialized to be the selected button, the selected button
does not implicitly follow it around. This way, the user can send commands
to various windows, without changing which button is selected.
Commands take five types of arguments: \fIInteger\fP, \fIManager\fP,
\fIWindow\fP, \fIButton\fP, and \fIString\fP. A \fIString\fP is a string
specified exactly as for fvwm - either in quotes or as a single word not in
quotes. Again, you may bind a sequence of commands to an event, by listing
them separated by commas.
\fIWindow\fP and \fIButton\fP types look exactly the same in the .fvwm2rc
file, but are interpreted as either specifying a managed window, or a
FvwmIconMan button representing a window. They can either be an integer (which
is interpreted module N where N is the number of buttons - so 0 is the first
and -1 is the last), or one of the strings: \fISelect\fP, \fIFocus\fP,
\fIUp\fP, \fIDown\fP, \fIRight\fP, \fILeft\fP, \fINext\fP,
\fIPrev\fP. \fISelect\fP and \fIFocus\fP refer to the currently selected or
focused button or window. \fIUp\fP, \fIDown\fP, \fIRight\fP, and \fILeft\fP
refer to the button or window above, below, to the right of, or to the left of
the current button in the manager window, allowing navigation around the
manager window. \fINext\fP and \fIPrev\fP designates the window, button, or
manager after or before the current button, allowing navigation of the one
dimensional list of windows which is drawn in the manager window. If the
manager is sorted, \fINext\fP and \fIPrev\fP move through the windows in
the sorted order.
The \fIManager\fP type can either be an integer, \fINext\fP, or \fIPrev\fP.
The meaning is analogous to that of the \fIButton\fP type, but in terms of
the integral index of the managers, restricted to managers which are nonempty.
The following functions are currently defined:
.IP "bif \fIButton\fP \fIInteger/String\fP"
A relative branch instruction. If \fIButton\fP is \fISelect\fP or \fIFocus\fP,
then take the branch if there is a selected button or a focused button. If
\fIButton\fP is an integer, then branch if nonzero. If it is one of \fIUp\fP,
\fIDown\fP, \fIRight\fP, \fILeft\fP, \fINext\fP, \fIPrev\fP, then the branch is
taken when the current button can move in that direction. If the branch is
taken, then \fIInteger\fP commands are skipped. No backwards branches are
allowed.
.IP "bifn \fIButton\fP \fIInteger/String\fP"
The complement of bif. The branch is taken if \fIButton\fP evaluates to false,
by the criteria listed for bif.
.IP "gotobutton \fIButton\fP"
Sets current button to \fIButton\fP. If \fIButton\fP is an integer, then
the current button is set to \fIButton\fP modulo the number of buttons,
in the whichever manager contains the selected button, if any.
.IP "gotomanager \fIManager\fP"
Sets button to button 0 of \fIManager\fP. This will only go to a visible,
nonempty manager. So an integral argument is taken modulo the number of such
managers.
.IP "jmp \fIInteger/String\fP"
Executes a relative jump of \fIInteger\fP instructions. Backwards jumps are
not allowed. The jump is computed relative to the instruction following the
jmp.
.IP "label \fIString\fP"
Provides a label that previous instructions can jump to. It will not be
visible to subsequent jump instructions, and the same label can be used
multiple times in the same instruction list (though it would be perverse
to do so.)
.IP "print \fIString\fP"
Prints \fIString\fP to the console. Useful for debugging actions.
.IP "printdebug"
Prints defined actions to the console. Should only be used by developers.
To enable this command, set CONFIG and FUNCTIONS variables to '1' in the
modules/FvwmIconMan/debug.h and recompile this module.
.IP "quit"
Quits FvwmIconMan.
.IP "refresh"
Causes all manager windows to redraw themselves.
.IP "ret"
Stop executing the entire action.
.IP "searchback \fIString\fP"
Sets button to button before the current one whose printed string in the
manager window matches specified \fIString\fP, which may contain wildcards.
.IP "searchforward \fIString\fP"
Sets button to button after the current one whose printed string in the
manager window matches specified \fIString\fP, which may contain wildcards.
.IP "select"
Selects the current button, if any. If a select action has been specified,
it will then be run. Therefore, it is considered unwise to set the select
button in the select action.
.IP "sendcommand \fICommand\fP"
Sends the fvwm command \fICommand\fP to the window represented by the current
button, if any.
.IP "warp"
Warps cursor to current button, if any.
.PP
.B Examples:
.EX
gotobutton select, gotobutton Down, select
.EE
Selects the button below the currently selected button. Since the
current button is already initialized to the selected button, this may be
shortened to "gotobutton Down, select".
.EX
gotobutton Up, select
.EE
Selects the button above the currently selected button.
.EX
gotobutton 0, select
.EE
Selects the first button of the current manager. If there is no current
manager, which is the case when no button is selected, then this does nothing.
.EX
gotobutton -1, select
.EE
Selects the last button of the current manager.
.EX
gotobutton focus, select
.EE
Selects the button corresponding to the focused window.
.EX
gotobutton focus, Iconify
.EE
Sends the fvwm command Iconify to the focused window. Note that this
does not change the selected button.
.EX
bif Next 3, gotobutton 0, select, ret, gotobutton Next, select
.EE
If a button is selected, and it's the last button, go to button 0. If it's
not the last button, go to the next button. Otherwise, do nothing. Basically,
this action cycles through all buttons in the current manager.
.EX
bif select 7, bif focus 3, gotomanager 0, select, ret, gotobutton focus, \\
select, ret, gotobutton down, select
.EE
This is good for sending to FvwmIconMan with a SendToModule command. If there
is a selected button, it moves down. Otherwise, if there is a focused button,
it is selected. Otherwise, button 0 of manager 0 gets selected.
.EX
bif select Select, bif focus Focus, gotomanager 0, select, ret, label Focus, \\
gotobutton focus, select, ret, label Select, gotobutton down, select
.EE
Same as previous, but using the label instruction.
.PP
In addition to being bound to keys and mice, actions can be sent from fvwm to
FvwmIconMan via the SendToModule command. Don't quote the command when using
SendToModule. Also, due to a bug in the current version of fvwm, don't quote
FvwmIconMan either.
.SH SAMPLE CONFIGURATIONS
This first example is of a the simplest invocation of FvwmIconMan, which only
has one manager, and handles all windows:
.nf
.sp
##############################################################
# Load any modules which should be started during
# fvwm initialization
ModulePath /usr/lib/X11/fvwm:/usr/bin/X11
Module FvwmIconMan
# Make FvwmIconMan title-bar-less, sticky, and give it an icon
Style "Fvwm*" Icon toolbox.xpm,NoTitle,NoHandles,Sticky
Style "FvwmIconMan" HandleWidth 5, Handles, BorderWidth 5
##############################################################
##############################################################
#Definitions used by the modules
*FvwmIconMan: NumManagers 1
*FvwmIconMan: Resolution global
*FvwmIconMan: Background slategrey
*FvwmIconMan: Foreground white
*FvwmIconMan: Font 7x13
*FvwmIconMan: ButtonGeometry 100x0
*FvwmIconMan: ManagerGeometry 1x0-0+0
.sp
.fi
This example is the Reader's Digest version of my personal configuration. It
has two managers, one for emacs and one for everything else, minus things with
no icon title. Only windows on the current page are displayed. The use of the
\fIdrawicons\fP and \fIshape\fP options requires that fvwm and FvwmIconMan are
compiled with the correct options. Note how the geometry and show options are
specified per manager, and the others are common to all:
.nf
.sp
Style "FvwmIconMan" NoTitle, Sticky, WindowListSkip, BorderWidth 0
Style "FvwmIconMan" HandleWidth 0
Key F8 A N SendToModule FvwmIconMan bif select Select, bif focus Focus, \\
gotomanager 0, select, sendcommand WarpToWindow, ret, label Focus, \\
gotobutton focus, select, sendcommand WarpToWindow, ret, label Select, \\
gotobutton prev, select, sendcommand WarpToWindow
Key F9 A N SendToModule FvwmIconMan bif select Select, bif focus Focus, \\
gotomanager 0, select, sendcommand WarpToWindow, ret, label Focus, \\
gotobutton focus, select, sendcommand WarpToWindow, ret, label Select, \\
gotobutton next, select, sendcommand WarpToWindow
*FvwmIconMan: NumManagers 2
*FvwmIconMan: Resolution page
*FvwmIconMan: Background steelblue
*FvwmIconMan: Foreground white
*FvwmIconMan: Font 7x13
*FvwmIconMan: UseWinList true
*FvwmIconMan: DrawIcons true
*FvwmIconMan: Shape true
*FvwmIconMan: FollowFocus true
*FvwmIconMan: Sort name
*FvwmIconMan: PlainButton up white steelblue
*FvwmIconMan: SelectButton down white steelblue
*FvwmIconMan: FocusButton up white brown
*FvwmIconMan: FocusAndSelectButton down white brown
*FvwmIconMan: TitleButton raisededge white steelblue
*FvwmIconMan: NoIconAction "SendToModule FvwmAnimate animate"
*FvwmIconMan: 1 Title "Emacs windows"
*FvwmIconMan: 1 IconName "FvwmIconMan: Emacs"
*FvwmIconMan: 1 Format "%i"
*FvwmIconMan: 1 Show resource=emacs resource=gemacs
*FvwmIconMan: 1 ManagerGeometry 1x0-400+0
*FvwmIconMan: 1 ButtonGeometry 200x0
*FvwmIconMan: 2 Title "All windows"
*FvwmIconMan: 2 IconName "FvwmIconMan: all"
*FvwmIconMan: 2 Format "%c: %i"
*FvwmIconMan: 2 DontShow icon=Untitled
*FvwmIconMan: 2 ManagerGeometry 2x4-0+0
*FvwmIconMan: 2 ButtonGeometry 200x0
*FvwmIconMan: transient Geometry 194x100
*FvwmIconMan: transient DontShow icon=Untitled
*FvwmIconMan: transient Action Mouse 0 A sendcommand select select Iconify
*FvwmIconMan: Action Mouse 1 N sendcommand Iconify
*FvwmIconMan: Action Mouse 2 N sendcommand WarpToWindow
*FvwmIconMan: Action Mouse 3 N sendcommand "Module FvwmIdent FvwmIdent"
*FvwmIconMan: Action Key Left N gotobutton Left, select
*FvwmIconMan: Action Key Right N gotobutton Right, select
*FvwmIconMan: Action Key Up N gotobutton Up, select
*FvwmIconMan: Action Key Down N gotobutton Down, select
*FvwmIconMan: Action Key q N quit
.sp
.fi
.SH UNFINISHED BUSINESS
There is one bug that I know of. A honest to goodness solution to this would
be appreciated. When an icon manager is set to grow upwards or leftwards, on
some machines it may wander occasionally.
It doesn't handle windows without resource names as gracefully as it should.
.SH AUTHOR
Brady Montz (bradym@cs.arizona.edu).
.SH THANKS
.nf
Thanks to:
David Berson <berson@cs.pitt.edu>,
Gren Klanderman <greg@alphatech.com>,
David Goldberg <dsg@mitre.org>,
Pete Forman <gsez020@compo.bedford.waii.com>,
Neil Moore <amethyst@maxwell.ml.org>,
Josh M. Osborne <stripes@va.pubnix.com,
Adam Rice <wysiwyg@glympton.airtime.co.uk>,
Chris Siebenmann <cks@hawkwind.utcs.toronto.edu>,
Bjorn Victor <victor@delial.docs.uu.se>.
for contributing either code or truly keen ideas.
|