Manpage of FvwmWharf
The GoodStuff program, and the concept for interfacing this module to the Window Manager, are all original work by 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.
If the FvwmWharf executable is linked to another name, ie ln -s FvwmWharf Pier, then another module called Pier can be started, with a completely different configuration than FvwmWharf, simply by changing the keywords FvwmWharf... to Pier.... This way multiple button-bars can be used.
0 - No texture - use FvwmWharfBgColor to set the desired color 1 - Gradient from upper-left to lower right 2 - Horizontal one way gradient from top to bottom 3 - Horizontal cylindrical gradient from top/bottom to center 4 - Vertical one way gradient from left to right 5 - Vertical cylindrical gradient from left/right to center 128 - User specified pixmapThe default is the builtin FvwmWharf texture pixmap.
NOTE: Icons must have one transparent pixel or the definition of a transparent color in order to be valid.
If command is an Fvwm Exec command, then the button will appear pushed in until the mouse button is released.
A single extension to the Fvwm built-in command set is provided. A command of the form:
*FvwmWharf junk clock.xpm Swallow "Clock" asclock -shape -12will cause FvwmWharf to spawn an asclock 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, xload, asclock, and asmail.
Modules can be swallowed by specifying the word Module:
*FvwmWharf pager nil Swallow "Desktop" Module FvwmPager 0 0NOTE: if you use xclock for this application, you will want to specify xclock -padding 0.
Swallow option tries to force an application to be 48 by 48 pixels. A special option MaxSwallow can be used to leave an application at its own size (but less then 64x64). MaxSwallow is invoked the same way Swallow is. If you want an application to fill all the button place, you should start it with a proper geometry flag, like "xload -g 64x64" or, if you want to leave a 3d-look: "xload -g 60x60".
Note, not all applications are good for swallowing, some can't be resized at all, some can't be resized exactly to 48x48 or 64x64, you are responsible for choosing suitable applications to be swallowed.
To create folder "slide-outs" in FvwmWharf the following format must be used:
*FvwmWharf files Folders.xpm Folder *FvwmWharf xftp 3DRings.xpm Exec xftp *FvwmWharf xdir FolderDeposit.xpm Exec xdir *FvwmWharf moxfm FilingCabinet.xpm Exec moxfm *FvwmWharf ~FoldersThe first line of this set tells FvwmWharf that this button definition will be a folder. All of the button definitions between the Folder and the line with the definition of *FvwmWharf ~Folders will appear on the "files" folder when it is exposed. To expose the "files" folder simply click on the FvwmWharf button with the Folders.xpm icon showing. A button bar will appear perpendicular to your FvwmWharf bar and toward the center of the screen. On this smaller bar will be the three icons that were configured between the Folder and ~Folder parts of the FvwmWharf configuration. As many folder buttons may be configured as is room on your screen. The only items that may not be configured within folders are Swallowed applications and more folders.
*FvwmWharf nil nil DropExec "program" program %s *FvwmWharf program iconname Exec "program" program
The button will call program when pushed. If a file is dragged onto into it, program will be called with %s being replaced by the dropped filename.
Beat Christen (bchriste@iiic.ethz.ch) Frank Fejes (frank@ssax.com) Alfredo Kengi Kojima (kojima@inf.ufrgs.br) Dan Weeks (dan@mango.sfasu.edu) Bo Yang (eric@coeus.ucsd.edu)