FvwmAuto(1)

NAME
FvwmAuto - the FVWM auto-raise module

SYNOPSIS
FvwmAuto is spawned by fvwm, so no command line invocation will work. The correct syntax is:
    Module FvwmAuto Timeout [-passid] [EnterCommand [LeaveCommand]]

    AddToMenu Modules
    + "Auto Raise (300 ms)"  Module FvwmAuto 300
    + "Auto Raise/Lower"     Module FvwmAuto 300 "Silent Raise" "Silent Lower"
The Timeout argument is required. It specifies how long a window must retain the keyboard input focus before the command is executed. The delay is measured in milliseconds, and any integer 0 or greater is acceptable. If the literal option -passid is given, the window id of the window just entered or left is appended to the command that is sent to fvwm. This can be used with the WindowId command of fvwm. EnterCommand and LeaveCommand are optional. EnterCommand is executed Timeout milliseconds after a window gets the input focus, LeaveCommand is executed Timeout milliseconds after the window has lost focus. Note that you always should use the 'Silent' keyword before the command itself. FvwmAuto prepends "Silent " to the command string on its own if yor forget this. Without this prefix fvwm would ask you for a window to act on if the window has died before the command sent by FvwmAuto has been processed by fvwm. This can for example happen with popup menus. "Silent Raise" is the default for EnterCommand, but any fvwm function is allowed. I would not use "Close" or "Destroy" with a low timeout, though. The LeaveCommand can be handy for a tidy desktop. Experiment with:
    Module FvwmAuto 0 Nop "Silent Lower"
    Module FvwmAuto 0 Nop "Silent Iconify"
More complex example (three FvwmAuto's are running):
    DestroyFunc RestoreIconified
    AddToFunc   RestoreIconified
    + I Current (Iconic) Iconify false
    DestroyFunc RegisterFocus
    AddToFunc   RegisterFocus
    + I Exec echo "`date +%T` $n focussed" >>/tmp/focus-stats.txt
    DestroyFunc RegisterUnfocus
    AddToFunc   RegisterUnfocus
    + I Exec echo "`date +%T` $n unfocussed" >>/tmp/focus-stats.txt
    KillModule FvwmAuto
    Module FvwmAuto 250 Raise Nop
    Module FvwmAuto 800 RestoreIconified Nop
    Module FvwmAuto   0 RegisterFocus RegisterUnfocus

NOTES
There is a special Raise/Lower support in FvwmAuto. It was added to improve Raise/Lower callbacks, since most of FvwmAuto usages is auto-raising or auto-lowering. This imrovement includes locking on M_RAISE_WINDOW and M_LOWER_WINDOW packets and not raising/lowering explicitely raised windows. The special Raise/Lower support is enabled only when either EnterCommand or LeaveCommand contain substring "Raise" or "Lower". You can use this fact to enable/disable any special support by renaming these commands, if FvwmAuto does not automatically do want you expect it to do. Using FvwmAuto in conjunction with EdgeCommand can be even more powerful. There is a short example in the fvwm man page.

AUTHOR
FvwmAuto just appeared one day, nobody knows how.
FvwmAuto was simply rewritten 09/96, nobody knows by whom.