GoodStuff1(1)
NAME
GoodStuff - the FVWM button panel module
SYNOPSIS
GoodStuff is spawned by fvwm, so no command line invocation will work.
DESCRIPTION
The GoodStuff module provides a button panel which sits on the X terminal's root window. The user can press the buttons at any time, and trigger invocation of a user-specified command by the window manager. GoodStuff only works when fvwm is used as the window manager. The button panel can be of any configuration or geometry, and can have monochrome or color icons to represent the actions which would be invoked.
COPYRIGHTS
The GoodStuff program, and the concept for interfacing this module to the Window Manager, are all original work by Robert Nation Copyright 1993, Robert Nation. No guarantees or warranties or anything are provided or implied in any way whatsoever. Use this program at your own risk. Permission to use this program for any purpose is given, as long as the copyright is kept intact.
INITIALIZATION
During initialization, GoodStuff will search for a configuration file which describes the button panel geometry, color, icons, and actions. The format of this files will be described later. The configuration file will be the one which fvwm used during its initialization. If the GoodStuff executable is linked to another name, ie ln -s GoodStuff TermStuff, then another module called TermStuff can be started, with a completely different configuration than GoodStuff, simply by changing the keywords Good??? to Term???. This way multiple button-bars can be used.
INVOCATION
GoodStuff can be invoked by inserting the line 'Module GoodStuff' in the .fvwmrc file. This can be placed on a line by itself, if GoodStuff is to be spawned during fvwm's initialization, or can be bound to a menu or mouse button or keystroke to invoke it later. Fvwm will search directory specified in the ModulePath configuration option to attempt to locate GoodStuff.
CONFIGURATION OPTIONS
The following options can be placed in the .fvwmrc file
*GoodStuffGeometry geometry
Specifies the GoodStuff window location and/or size. If the size
is not specified, GoodStuff will auto-size itself in a
reasonable manner. The geometry is a standard X11 window
geometry specification.
*GoodStuffFont font
Specifies the font to be used for labeling the buttons.
*GoodStuffRows rows
Specifies the number of rows of buttons to be created. If
unspecified, 2 rows will be used.
*GoodStuffColumns columns
Specifies the number of columns of buttons to be created. If
unspecified, the number of columns will be set to the number of
buttons requested, divided by the number of rows. If both the
rows and columns are specified, but do not specify as many
buttons as are defined, then the users columns specification
will be ignored.
*GoodStuffFore color
Specifies the color for button label text and monochrome icons.
*GoodStuffBack color
Specifies the color for the buttons.
*GoodStuff[(w x h)] label icon command
Specifies a window manager built-in command, as described in the
fvwm man page, which should be executed when a button is
pressed. The label field is the text which will be written on
the button. The icon field specifies an X11 bitmap file or XPM
color icon file, containing the icon to display on the button.
GoodStuff will search through the path specified in the fvwm
IconPath or PixmapPath configuration items to find the icon
file. If the optional (w x h) is specified, then this button
will be w times the normal button width and h times the normal
button height. If label is "-" then the button label will not be
displayed.
If command is an fvwm Exec command, then the button will remain
pushed in until a window whose name or class matches the qouted
portion of the command is encountered. This is intended to
provide visual feedback to the user that the action he has
requested will be performed. If the qouted portion contains no
characters, then the button will pop out immediately. Note that
users can continue pressing the button, and re-executing the
command, even when it looks "pressed in."
A single extension to the fvwm built-in command set is provided.
A command of the form: *GoodStuff junk clock.xpm Swallow "Clock"
rclock & will cause GoodStuff to spawn an rclock process, and
capture the first window whose name or resource is "Clock", and
display it in the button-bar. This is handy for applications
like xclock, xbiff, and xload. Modules can be swallowed by
specifying SwallowModule instead of just "swallow" NOTE: if you
use xclock for this application, you will want to specify xclock
-padding 0.
SAMPLE CONFIGURATION
The following are excepts from a .fvwmrc file which describe GoodStuff initialization commands: ############################################################## # Load any modules which should be started during # fvwm initialization ModulePath /usr/lib/fvwm:/usr/bin/X11 Module GoodStuff # Make goodstuff title-bar-less, sticky, and give it an icon NoTitle GoodStuff Sticky GoodStuff Icon "GoodStuff" toolbox.xpm ############################################################## ############################################################## #Definitions used by the modules *GoodStuffFore Black *GoodStuffBack #908090 *GoodStuffGeometry -135-5 *GoodStuffRows 1 *GoodStuffFont -adobe-helvetica-medium-r-*-*-12-*-*-*-*-*-*-* *GoodStuff Resize resize.xpm Resize *GoodStuff Move arrows2.xpm Move *GoodStuff Lower Down Lower *GoodStuff Raise Up Raise *GoodStuff Kill bomb.xpm Destroy *GoodStuff Dopey rterm.xpm Exec "big_win" xterm -T big_win -geometry 80x50& *GoodStuff Snoopy rterm.xpm Exec "small_win" xterm -T small_wi & *GoodStuff Xcalc rcalc.xpm Exec "Calculator" xcalc & *GoodStuff XMag magnifying_glass2.xpm Exec "xmag" xmag & *GoodStuff Mail mail2.xpm Exec "xmh" xmh & *GoodStuff(4x1) - whatever SwallowModule "Fvwm Pager" FvwmPager 0 3 The last line is a little tricky - it spawns an FvwmPager module, and captures it to display in a quadruple width button. Since "-" is used for the button label, the Pager will be resized to be as big as possible within the button's borders. "whatever", of course, is a non- existent icon file, and will be ignored by GoodStuff.
AUTHOR
Robert Nation
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.
