FvwmWinList(1)
NAME
FvwmWinList - the fvwm window list module
SYNOPSIS
FvwmWinList [name] FvwmWinList is spawned by fvwm, so no command line invocation will work.
DESCRIPTION
The FvwmWinList module provides a window list made up of buttons, each corresponding to a window that fvwm is managing. Clicking on the buttons with any of the three mouse buttons will either do a default action or can be user configured. Like the other modules, FvwmWinList only works when fvwm is used as the window manager.
COPYRIGHTS
The FvwmWinList module is the original work of Mike Finger. Copyright 1994, Mike Finger. The author makes no guarantees or warranties of any kind about the use of this module. Use this modules at your own risk. You may freely use this module or any portion of it for any purpose as long as the copyright is kept intact.
INITIALIZATION
During initialization, FvwmWinList gets config info from fvwm's module configuration database (see fvwm(1), section MODULE COMMANDS). Available options are discussed in a later section.
INVOCATION
FvwmWinList can be invoked by fvwm during initialization by inserting the line 'Module FvwmWinList' in the .fvwm2rc file. FvwmWinList can also be bound to a keystroke, mouse button, or menu option to be invoked later, in this case using 'Transient' as an argument will cause FvwmWinList to resemble the built in window list.
CONFIGURATION OPTIONS
*FvwmWinList: Geometry {+-}<X>{+-}<Y>
Specifies the location and gravity of the FvwmWinList window.
At the current time, size is not supported and FvwmWinList will
resize itself as buttons are added. If the NoAnchor option is
not specified then the windows gravity corner will be anchored,
and the window will grow in the opposite direction. (i.e. If
the geometry is specified -5-5, that is SoutEastGravity. This
will cause the window to draw up and to the left as windows are
added)
*FvwmWinList: Font font
Specifies the font to be used for labeling the buttons.
*FvwmWinList: Colorset n
Specifies the colorset to use for the buttons. See FvwmTheme.
Defaults to 0.
*FvwmWinList: Fore color
Specifies the color to use for the button names. Cancels
*FvwmWinList: Colorset.
*FvwmWinList: Back color
Specifies the color for the buttons. Cancels *FvwmWinList:
Colorset.
*FvwmWinList: FocusColorset n
Specifies the colorset to use for the button for the window that
has the input focus. Defaults to 1.
*FvwmWinList: FocusFore color
Specifies the color to use for the button names for the window
that has the input focus. If omitted, the color from
*FvwmWinList: Fore is used. Cancels *FvwmWinList: FocusColorset.
*FvwmWinList: FocusBack color
Specifies the color to use for the button for the window that
has the input focus. If omitted, the color from *FvwmWinList:
Back is used. Cancels *FvwmWinList: FocusColorset.
*FvwmWinList: IconColorset n
Specifies the colorset to use for buttons for windows that are
iconified. Defaults to 0.
*FvwmWinList: IconFore color
Specifies the color to use for the button names for windows that
are iconified. If omitted, the color from *FvwmWinList: Fore is
used. Cancels *FvwmWinList: IconColorset.
*FvwmWinList: IconBack color
Specifies the color to use for the button for windows that are
iconified. If omitted, the color from *FvwmWinList: Back is
used. Cancels *FvwmWinList: IconColorset.
*FvwmWinList: DontDepressFocus
By default FvwmWinList will show the button for the window that
has the input focus as pressed in. This option disables that
feature.
*FvwmWinList: ButtonFrameWidth width
Specify the width of the 3D borders around the buttons in
FvwmWinList.
*FvwmWinList: FollowWindowList
Specifies that FvwmWinList will keep its list in the same order
as fvwm. This is the order displayed by the "WindowList
NoDeskSort" fvwm command. This is not the default as it is more
visually disturbing when the focus changes.
*FvwmWinList: UseSkipList
Tells FvwmWinList to not show the windows that are listed on a
WindowListSkip line in the configuration file.
*FvwmWinList: ShowCurrentDesk
Specifies that only windows on the current desk are displayed.
*FvwmWinList: NoAnchor
By default, FvwmWinList will anchor the gravity corner so the
window will grow in the opposite direction. This undoes that
option, i.e. the window will always grow down. Do not use this
option if a negative geometry was specified.
*FvwmWinList: UseIconNames
Tells FvwmWinList to use the icon name of the window instead of
the full window name. This is useful to keep the width of the
window small.
*FvwmWinList: LeftJustify
By default, FvwmWinList will center the icon text in the icon.
This option causes it to be justified flush with the left edge
of the icon. This option is turned on when MiniIcons are used.
*FvwmWinList: MinWidth width
*FvwmWinList: MaxWidth width
Specify the minimum and maximum widths that the buttons will
shrink or grow to. The buttons will normally size to fit the
longest name, but certain applications produce icon titles that
can easily fill the screen. Setting these parameters constrains
the size of the buttons to be between the two values. Setting
them identically will fix the size of the buttons. Setting Max
< Min will have unpredictable results.
*FvwmWinList: TruncateLeft
If names get truncated because of the setting of FvwmWinList:
MaxWidth, they will normally get truncated on the right, so only
the start of the names are visible. Setting this resource will
cause them to get truncated on the left, so that the end of
names are visible. This is useful when the window title contains
a directory and file name, for example.
*FvwmWinList: Action action response
Tells FvwmWinList to do response when action is done. The
currently supported actions are: Click1, Click2, Click3 and so
on. By default the module supports 3 mouse buttons, but it can
be compiled to support more. The currently supported responses
are any fvwm built-in commands, including modules and functions.
Warning: The use of the former syntax that allowed to use comma
separated lists of commands is strongly discouraged due to
synchronization problems with fvwm. Please use complex fvwm
functions instead (defined with the 'AddToFunc' command of
fvwm).
*FvwmWinList: NoIconAction action
Tells FvwmWinList to do action is when a NoIcon style window is
iconified or de-iconified. Relevant coordinates are appended to
action so that the icon can be traced to an FvwmWinList button.
An example action is "*FvwmWinList: NoIconAction SendToModule
FvwmAnimate animate". A blank or null action turns this feature
off.
SAMPLE CONFIGURATION
The following are excepts from a .fvwm2rc file which describe FvwmWinList initialization commands: ######## # Pop up the window list in transient mode on button 3 press & hold Mouse 3 R A Module FvwmWinList Transient AddToFunc DeiconifyAndRaise + I Iconify off + I Raise ########################## Window-Lister ############################### *FvwmWinList: Back DarkOliveGreen *FvwmWinList: Fore PaleGoldenRod *FvwmWinList: Font -*-new century schoolbook-bold-r-*-*-*-120-*-*-*-*-*-* *FvwmWinList: Action Click1 Function DeiconifyAndRaise *FvwmWinList: Action Click2 Iconify *FvwmWinList: Action Click3 Module FvwmIdent *FvwmWinList: UseSkipList *FvwmWinList: UseIconNames *FvwmWinList: Geometry -50-85 *FvwmWinList: MinWidth 70 *FvwmWinList: MaxWidth 120 # I prefer the text centered #*FvwmWinList: LeftJustify # I like it anchored #*FvwmWinList: NoAnchor # A flat list in most recently focused order #*FvwmWinList: FollowWindowList #*FvwmWinList: BorderReliefWidth 0 # pretend to be a taskbar *FvwmWinList: NoIconAction SendToModule FvwmAnimate animate
AUTHOR
Mike Finger (mfinger@mermaid.micro.umn.edu)
(Mike_Finger@atk.com)
(doodman on IRC, check the #linux channel)
Various Patches by
John Heidemann <johnh@ficus.CS.UCLA.EDU> and
Jason L Tibbitts <tibbs@tcamc.uh.edu>.
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
