FvwmAuto(1)                                           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 [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  millisec-
       onds, and any integer 0 or greater is acceptable.

       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  sup-
       port is enabled only when either EnterCommand or LeaveCom-
       mand contain substring "Raise" or  "Lower".  You  can  use
       this  fact to enable/disable any special support by renam-
       ing these commands, if FvwmAuto does not automatically  do
       want you expect it to do.


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



                           3 July 2001                FvwmAuto(1)