The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

fvwm2 (1)
  • >> fvwm2 (1) ( Solaris man: Команды и прикладные программы пользовательского уровня )
  • fvwm2 (1) ( Русские man: Команды и прикладные программы пользовательского уровня )
  • 
    NAME
         fvwm2 - F(?) Virtual Window Manager (version 2.xx) for X11
    
    SYNOPSIS
         fvwm [ options ]
    
    DESCRIPTION
         Fvwm is a window manager for X11.  It  is  a  derivative  of
         twm,  redesigned  to  minimize memory consumption, provide a
         3-D look to window frames,  and  provide  a  simple  virtual
         desktop.   Version  2.xx uses only slightly more memory than
         1.xx, mostly due to some global options  being  able  to  be
         window specific now.
    
         Fvwm provides both a large virtual desktop and multiple dis-
         joint  desktops  which  can  be used separately or together.
         The virtual desktop allows you to pretend  that  your  video
         screen  is  really  quite  large,  and you can scroll around
         within the desktop.  The multiple  disjoint  desktops  allow
         you  to pretend that you really have several screens to work
         at, but each screen is completely unrelated to the others.
    
         Fvwm provides keyboard accelerators which allow you to  per-
         form  most  window-manager  functions,  including moving and
         resizing windows, and operating the window-manager's  menus,
         using keyboard shortcuts.
    
         Fvwm has also blurred the distinction between  configuration
         commands  and  built-in  commands  that most window-managers
         make.  Configuration commands typically set  fonts,  colors,
         menu  contents,  key  and  mouse  function  bindings,  while
         built-in commands typically do things like raise  and  lower
         windows.  Fvwm makes no such distinction, and allows, to the
         extent that is practical, anything  to  be  changed  at  any
         time.
    
         Other noteworthy differences between Fvwm and other X11 win-
         dow  managers  are  the  introduction of the SloppyFocus and
         per-window focus  methods.   SloppyFocus  is  focus-follows-
         mouse,  but focus is not removed from windows when the mouse
         leaves a window and enters the  root  window.   When  sloppy
         focus is used as the default focus style, it is nice to make
         windows in which you do not typically type into (xmag, xman,
         xgraph,  xclock,  xbiff,  etc)  click-to-focus, so that your
         terminal window doesn't lose focus unnecessarily.
    
    
    COPYRIGHTS
         Since fvwm is derived from twm code it  shares  twm's  copy-
         rights.   Since  nearly  every  line  of  twm  code has been
         changed, the twm copyright has been removed from most of the
         individual  code  files.  I do still recognize the influence
         of twm code in the overall package, so fvwm's  copyright  is
         still considered to be the same as twm's.
    
         Please consult the COPYING file that has come with your dis-
         tribution for details.
    
    
    ANATOMY OF A WINDOW
         Fvwm puts a decorative border  around  most  windows.   This
         border consists of a bar on each side and a small "L" shaped
         section on each corner.  There  is  an  additional  top  bar
         called  the  title  bar which is used to display the name of
         the window.  In addition, there are up to 10 title-bar  but-
         tons.  The top, side, and bottom bars are collectively known
         as the side-bars.  The corner pieces are called the frame.
    
         Unless the standard defaults files  are  modified,  pressing
         mouse  button  1 in the title or side-bars will begin a move
         operation on the window.  Pressing button 1  in  the  corner
         frame pieces will begin a resize operation.  Pressing button
         2 anywhere in the border brings up an extensive list of win-
         dow operations.
    
         Up to ten title-bar buttons may exist.  Their  use  is  com-
         pletely  user  definable.   The  default configuration has a
         title-bar button on each side of the title-bar.  The one  on
         the  left  is  used  to  bring  up a list of window options,
         regardless of which mouse button is used.  The  one  on  the
         right  is  used to iconify the window.  The number of title-
         bar buttons used depends on which ones  have  mouse  actions
         bound to them.  See the section on the "Mouse" configuration
         parameter below.
    
    
    
    THE VIRTUAL DESKTOP
         Fvwm provides multiple virtual desktops for users  who  wish
         to  use them.  The screen is a viewport onto a desktop which
         may be larger than the screen.   Several  distinct  desktops
         can  be accessed (concept:  one desktop for each project, or
         one desktop for each application, when view applications are
         distinct).  Since each desktop can be larger than the physi-
         cal screen, divided into m by n pages  which  are  each  the
         size  of  the physical screen, windows which are larger than
         the screen or large groups of related windows can easily  be
         viewed.
    
         The (m by n) size (i.e. number  of  pages)  of  the  virtual
         desktops  can  be changed any time, by using the DeskTopSize
         built-in command.  All virtual desktops must  be  (are)  the
         same  size.   The total number of distinct desktops need not
         be specified, but is  limited  to  approximately  4  billion
         total.   All windows on a range of desktops can be viewed in
         the Pager, a miniature view of the desktops.  The  pager  is
         an  accessory  program, called a module, which is not essen-
         tial for the window manager to operate.  Windows may also be
         listed,  along  with  their  geometries,  in  a window list,
         accessible as a pop-up menu, or as a separate window, called
         the FvwmWinList (another module).
    
         "Sticky" windows are windows  which  transcend  the  virtual
         desktop  by  "Sticking  to the screen's glass."  They always
         stay put on the screen.  This is convenient for things  like
         clocks  and xbiff's, so you only need to run one such gadget
         and it always stays with you.  Icons can  also  be  made  to
         stick to the glass, if desired.
    
         Window geometries are  specified  relative  to  the  current
         viewport.  That is:
    
              xterm -geometry +0+0
    
         will always show up in the upper-left  hand  corner  of  the
         visible portion of the screen.  It is permissible to specify
         geometries which place windows on the virtual  desktop,  but
         off  the screen.  For example, if the visible screen is 1000
         by 1000 pixels, and the desktop size is 3x3, and the current
         viewport  is  at  the upper left hand corner of the desktop,
         then invoking:
    
              xterm -geometry +1000+1000
    
         will place the window just  off  of  the  lower  right  hand
         corner  of  the screen.  It can be found by moving the mouse
         to the lower right hand corner of the screen and waiting for
         it to scroll into view.
    
         A geometry specified as something like:
    
              xterm -geometry -5-5
    
         will generally place the window's lower right hand corner  5
         pixels from the lower right corner of the visible portion of
         the screen. Not all applications support  window  geometries
         with  negative  offsets.  Some will place the window's upper
         right hand corner 5 pixels above and  to  the  left  of  the
         upper  left  hand  corner  of the screen; others may do just
         plain bizarre things.
    
    
         There are several ways to cause a window to map onto a desk-
         top  or  page  other  than  the  currently  active  one. The
         geometry technique mentioned above (specifying  x,y  coordi-
         nates  larger  than  the  physical  screen  size),  however,
         suffers from the limitation of being interpreted relative to
         the  current  viewport:  the  window  will  not consistently
         appear on a specific page,  unless  you  always  invoke  the
         application from the same page.
    
         A better way to place windows on a different  page  or  desk
         from  the  currently mapped viewport is to use the StartsOn-
         Page style specification (the successor to the older  Start-
         sOnDesk  style) in the .fvwm2 configuration file. The place-
         ment is consistent: it does not depend on your current loca-
         tion on the virtual desktop.
    
         Some applications that understand standard Xt  command  line
         arguments  and  X  resources, like xterm and xfontsel, allow
         the user to specify the start-up desk or page on the command
         line:
    
              xterm -xrm "*Desk:1"
    
         will start an xterm on desk number 1;
    
              xterm -xrm "*Page:3 2 1"
    
         will start an xterm two pages to the right and one down from
         the  upper left hand page of desk number 3. Not all applica-
         tions understand the use of these options, however.
    
         You could achieve the same results with the following  lines
         in your
    
              XTerm*Desk: 1
    
         or
    
              XTerm*Page: 3 2 1
    
    
    
    INITIALIZATION
         During initialization, fvwm will search for a  configuration
         file  which  describes  key  and  button bindings, and a few
         other things.  The format of these files will  be  described
         later.  First, fvwm will search for a file named .fvwm2rc in
         the user's home directory, then in ${sysconfdir}  (typically
         /usr/local/etc).    Failing   that,   it   will   look   for
         system.fvwm2rc in ${sysconfdir}  for  system-wide  defaults.
         If that file is not found, fvwm will be basically useless.
    
         Fvwm will set two environment variables which will be inher-
         ited  by  its  children.  These are $DISPLAY which describes
         the display on which  fvwm  is  running.   $DISPLAY  may  be
         unix:0.0  or  :0.0,  which doesn't work too well when passed
         through rsh to another machine, so $HOSTDISPLAY will also be
         set and will use a network-ready description of the display.
         $HOSTDISPLAY will always use the TCP/IP  transport  protocol
         (even for a local connection) so $DISPLAY should be used for
         local connections, as it may use Unix-domain sockets,  which
         are faster.
    
         Fvwm has three special functions for initialization:  Start-
         Function,  which is executed on startups and restarts; Init-
         Function and RestartFunction, which are executed during Ini-
         tialization  and  Restarts  (respectively) just after Start-
         Function.  These may be customized in a user's rc  file  via
         the   AddToFunc  facility  (described  later)  to  start  up
         modules, xterms, or whatever you'd like to have  started  by
         fvwm.
    
         Fvwm also has a special exit  function:  ExitFunction,  exe-
         cuted when exiting or restarting before actually quitting or
         anything else.  It could be used to explicitly kill modules,
         etc.
    
    
    COMPILATION OPTIONS
         Fvwm has a number of compile-time options to  reduce  memory
         usage  by limiting the use of certain features.  If you have
         trouble using a certain command or feature, check to see  if
         support  for  it  was  included  at  compile time.  Optional
         features are described in the config.h file.
    
    
    ICONS
         The basic Fvwm configuration uses monochrome  bitmap  icons,
         similar  to  twm.   If  XPM extensions are compiled in, then
         color icons similar to ctwm, MS-Windows,  or  the  Macintosh
         icons  can  be used.  In order to use these options you will
         need the XPM package, as described in the INSTALL.fvwm file.
    
         If both the SHAPE and XPM options are compiled in  you  will
         get shaped color icons, which are very spiffy.
    
    
    MODULES
         A module is a separate program which runs as a separate Unix
         process  but  transmits  commands to fvwm to execute.  Users
         can write their own modules to do any weird or bizarre mani-
         pulations  without  bloating  or  affecting the integrity of
         fvwm itself.
    
         Modules MUST be spawned by fvwm so that it can  set  up  two
         pipes  for  fvwm  and  the  module to communicate with.  The
         pipes will already be open for the module when it starts and
         the  file  descriptors for the pipes are provided as command
         line arguments.
    
         Modules can be spawned during fvwm at any time during the  X
         session  by use of the Module built-in command.  Modules can
         exist for the duration of the X session, or  can  perform  a
         single  task  and  exit.  If the module is still active when
         fvwm is told to quit, then fvwm will close the communication
         pipes  and  wait to receive a SIGCHLD from the module, indi-
         cating that it has detected the pipe closure and has exited.
         If  modules  fail  to detect the pipe closure fvwm will exit
         after approximately 30 seconds anyway.  The number of simul-
         taneously  executing  modules  is  limited  by the operating
         system's maximum number of simultaneously open  files,  usu-
         ally between 60 and 256.
    
         Modules simply transmit text commands to the  fvwm  built-in
         command  engine.  Text commands are formatted just as in the
         case of a mouse binding in the .fvwm2rc setup file.  Certain
         auxiliary  information is also transmitted, as in the sample
         module FvwmButtons.  The FvwmButtons module is documented in
         its own man page.
    
    
    ICCCM COMPLIANCE
         Fvwm attempts to be ICCCM 1.1 compliant.  In addition, ICCCM
         states  that  it  should  be  possible  for  applications to
         receive ANY keystroke, which is not consistent with the key-
         board  shortcut  approach used in fvwm and most other window
         managers. In particular you cannot have  the  same  keyboard
         shortcuts  working with your fvwm2 and another fvwm2 running
         within Xnest (a nested X server). The  same  problem  exists
         with mouse bindings.
    
         The ICCCM states that windows possessing the property
    
              WM_HINTS(WM_HINTS):
                  Client accepts input or input focus: False
    
         should not be given the keyboard input focus by  the  window
         manager.   These  windows  can take the input focus by them-
         selves, however.  A number of  applications  set  this  pro-
         perty,  and  yet  expect the window-manager to give them the
         keyboard focus anyway,  so  fvwm  provides  a  window-style,
         "Lenience",  which  will  allow  fvwm to overlook this ICCCM
         rule.
    
    
    
    M4 PREPROCESSING
         M4 pre-processing is handled by a module  in  fvwm-2.0.   To
         get  more  details,  try  man FvwmM4.  In short, if you want
         fvwm to parse your files with  m4,  then  replace  the  word
         "Read" with "FvwmM4" in your .fvwm2rc file (if it appears at
         all), and start fvwm with the command
    
              fvwm -cmd "FvwmM4 .fvwm2rc"
    
    
    
    CPP PREPROCESSING
         Cpp is the C-language pre-processor.   fvwm-2.0  offers  cpp
         processing which mirrors the m4 pre-processing.  To find out
         about it, re-read the M4 section  above,  but  replace  "m4"
         with "cpp".
    
    
    AUTO-RAISE
         Windows can be automatically raised when it receives  focus,
         or  some  number of milliseconds after it receives focus, by
         using the auto-raise module, FvwmAuto.
    
    
    OPTIONS
         These are the command line options that  are  recognized  by
         fvwm:
    
         -blackout
              The screen is blacked out during window recaptures  and
              startup. This option is provided for backwards compati-
              bility only.
    
         -cmd config_command
              Causes fvwm to  use  config_command  instead  of  "Read
              .fvwm2rc" as its initialization command.  (Note that up
              to 10 -f and -cmd parameters can be given, and they are
              executed in the order specified.)
    
         -d displayname
              Manage the display called "displayname" instead of  the
              name obtained from the environment variable $DISPLAY.
    
         -debug
              Puts X transactions in synchronous mode, which dramati-
              cally  slows  things  down,  but guarantees that fvwm's
              internal error messages are correct.  Also causes  fvwm
              to output debug messages while running.
    
         -f config_file
              Causes fvwm to Read config_file instead  of  ".fvwm2rc"
              as its initialization file.  This is equivalent to -cmd
              "Read config_file".
    
         -h   A short usage description is printed.
    
         -s   On a multi-screen display, run fvwm only on the  screen
              named  in the $DISPLAY environment variable or provided
              through the -d option. Normally, fvwm will  attempt  to
              start up on all screens of a multi-screen display.
    
         -version
              Print the version of fvwm to stderr.
    
    
    CONFIGURATION FILES
         The configuration file is used to describe mouse and  button
         bindings,  colors,  the  virtual  display  size, and related
         items.  The initialization configuration file  is  typically
         called ".fvwm2rc".  By using the "Read" built-in, it is easy
         to read in new configuration files as you go.
    
         Lines beginning with '#' will be  ignored  by  fvwm.   Lines
         starting  with '*' are expected to contain module configura-
         tion commands (rather than configuration commands  for  fvwm
         itself).
    
         Fvwm makes no distinction between configuration commands and
         built-in  commands,  so  anything  mentioned in the built-in
         commands section  can be placed on a line by itself for fvwm
         to  execute as it reads the configuration file, or it can be
         placed as an executable command in a  menu  or  bound  to  a
         mouse  button  or a keyboard key.  It is left as an exercise
         for the user to decide which function make  sense  for  ini-
         tialization and which ones make sense for run-time.
    
    
    BUILT IN FUNCTIONS
         Fvwm supports a set of built-in functions which can be bound
         to  keyboard  or  mouse  buttons.  If fvwm expects to find a
         built-in function in a command, but fails, it will check  to
         see  if  the  specified  command  should have been "Function
         (rest of command)" or  "Module  (rest  of  command)".   This
         allows  complex  functions  or  modules  to  be invoked in a
         manner which is  fairly  transparent  to  the  configuration
         file.
    
         Example: the .fvwm2rc file contains the line "HelpMe".  Fvwm
         will  look  for a built-in command called "HelpMe", and will
         fail. Next it will look for a user-defined complex  function
         called  "HelpMe".   If no such user defined function exists,
         Fvwm will try to execute a module called "HelpMe".
    
         In previous versions of fvwm, quoting was critical and irra-
         tional  in the .fvwmrc file.  As of fvwm-2, most of this has
         been cleared up.  Quotes are required only  when  needed  to
         make  fvwm  consider  two or more words to be a single argu-
         ment.  Unnecessary quoting is allowed.  If you want a  quote
         character  in  your  text,  you  must escape it by using the
         backslash character.  For example, if you have a pop-up menu
         called   Window-Ops,  then  you  don't  need  quotes:  Popup
         Window-Ops, but if you replace the dash with a  space,  then
         you need quotes: Popup "Window Ops".
    
    
    
         AddButtonStyle button [ state ] [ style ] [-- [!]flag ...]
              Adds a button style to button.  button can be a  button
              number, or one of "All," "Left," or "Right."  state can
              be "ActiveUp," "ActiveDown" or "Inactive."  If state is
              omitted,  then  the  style is added to every state.  If
              the button style and flags are enclosed in parentheses,
              then multiple state definitions can be placed on a sin-
              gle line.  Flags for additional button styles cannot be
              changed after definition.
    
              Buttons are drawn in the order of definition, beginning
              with  the  most  recent  ButtonStyle, followed by those
              added with AddButtonStyle.  To clear the  button  style
              stack,  change  style  flags,  or  for  descriptions of
              available styles and flags, see  the  ButtonStyle  com-
              mand.  Examples:
    
                   ButtonStyle 1 Pixmap led.xpm -- Top Left
                   ButtonStyle 1 ActiveDown HGradient 8 grey \
                     black
                   ButtonStyle All --  UseTitleStyle
                   AddButtonStyle 1 ActiveUp (Pixmap a.xpm)  \
                     ActiveDown (Pixmap b.xpm -- Top)
                   AddButtonStyle 1 Vector 4 50x30@1 70x70@0 \
                     30x70@0 50x30@1
    
              Initially for this example all button states are set to
              a  pixmap.   The  second  line  replaces the ActiveDown
              state with a gradient (it overrides the pixmap assigned
              to it in the line before, which assigned the same style
              to every state).  Then, the UseTitleStyle flag  is  set
              for  all  buttons, which causes fvwm to draw any styles
              set  with  TitleStyle  before  drawing   the   buttons.
              Finally,  AddButtonStyle  is  used  to place additional
              pixmaps for both ActiveUp and ActiveDown states  and  a
              Vector button style is drawn on top of all state.
    
    
    
         AddTitleStyle [ state ] [ style ] [ -- [!]flag ... ]
              Adds a title style to the title bar.  state  should  be
              one  of  "ActiveUp,"  "ActiveDown,"  or "Inactive."  If
              state is omitted, then the  style  is  added  to  every
              state.    If  the  style  and  flags  are  enclosed  in
              parentheses, then multiple  state  definitions  can  be
              placed on a single line.  This command is quite similar
              to the AddButtonStyle command (see above).
    
              Title bars are drawn in the order of definition, begin-
              ning with the most recent TitleStyle, followed by those
              added with AddTitleStyle.  To  clear  the  title  style
              stack,  change  style flags, or for the descriptions of
              available styles and flags, see the TitleStyle and But-
              tonStyle commands.
    
    
    
         AddToDecor decor
              Add or divert commands to the  decor  named  decor.   A
              decor  is  a  name  given  to the set of commands which
              affect button styles, title-bar styles, border  styles,
              hilight  colors,  and  window fonts.  If decor does not
              exist it is created; otherwise the  existing  decor  is
              modified.
    
              Created decors start out exactly like the default  fvwm
              decor without any style definitions.  A given decor may
              be applied to a set of windows with the UseDecor option
              of the Style command.  Modifying an existing decor will
              affect windows which are currently assigned to it.
    
              AddToDecor is similar in usage  to  the  AddToMenu  and
              AddToFunc commands, except that menus and functions are
              replaced by  ButtonStyle,  AddButtonStyle,  TitleStyle,
              AddTitleStyle, BorderStyle, HilightColor and WindowFont
              commands.  Decors created with AddToDecor can be  mani-
              pulated  with  ChangeDecor,  DestroyDecor, UpdateDecor,
              and the UseDecor Style option.
    
              The following example creates a decor and  style,  both
              named  "flatness."   Despite having the same name, they
              are distinct entities:
    
                   AddToDecor flatness
                    + ButtonStyle All ActiveUp (-- flat) \
                      Inactive (-- flat)
                    + TitleStyle -- flat
                    + BorderStyle -- HiddenHandles NoInset
                    + HilightColor white navy
                   Style "flatness" UseDecor flatness, \
                     Color white/grey40,HandleWidth 4
    
                   Style "xterm" UseStyle flatness
    
              An existing  window's  decor  may  be  reassigned  with
              ChangeDecor,   or   a   Style  command  followed  by  a
              Recapture.  The decorations of  all  windows  or  of  a
              specific  decor can be updated with UpdateDecor (useful
              after decorations are modified; changing Style  options
              requires  a  Recapture  instead).   A decor can be des-
              troyed with DestroyDecor.
    
    
    
         AddToFunc [ name [ trigger action] ]
              Begins or add to  a  function  definition.   Here's  an
              example:
    
                   AddToFunc Move-or-Raise "I" Raise
                    + "M" Move
                    + "D" Lower
    
              The  function  name  is  Move-or-Raise,  and  could  be
              invoked from a menu or a mouse binding or key binding:
    
                   Mouse 1 TS A Move-or-Raise
    
              The quoted portion of the function tells what  kind  of
              action  will trigger the command which follows it.  "I"
              stands for Immediate, and is executed as  soon  as  the
              function  is  invoked.  "M" stands for Motion, i.e.  if
              the user starts  moving  the  mouse.   "C"  stands  for
              Click, i.e., if the user presses and releases the mouse
              in a short period  of  time  (ClickTime  milliseconds).
              "D" stands for double-click.  The action "I" will cause
              an action to be performed on the button-press,  if  the
              function  is invoked with prior knowledge of which win-
              dow to act on.
    
              The special symbols $d, $w and $0 through $9 are avail-
              able in the ComplexFunctions or Macros, or whatever you
              want to call them.  Within a macro, $w is  expanded  to
              the  window-id (expressed in hex, i.e. 0x10023c) of the
              window for  which  the  macro  was  called  and  $d  is
              expanded  to the current desk number. $0 through $9 are
              the arguments to the macro, so if you call
    
                   Key F10 R A Function MailFunction \
                     xmh "-font fixed"
    
              and MailFunction is
    
    
                   AddToFunc MailFunction
                    + "I" Next [$0] Iconify -1
                    + "I" Next [$0] focus
                    + "I" None [$0] Exec exec $0 $1
    
              Then the last line of the function becomes
    
                    + "I" None [xmh] Exec exec xmh -font fixed
    
              The expansion is performed as the function is executed,
              so you can use the same function with all sorts of dif-
              ferent arguments.  I could use
    
                   Key F11 R A Function MailFunction \
                     zmail "-bg pink"
    
              in the same .fvwm2rc, if I wanted.  An example of using
              $w is:
    
                   AddToFunc PrintFunction
                    + "I" Raise
                    + "I" Exec xdpr -id $w
    
              Note that $$ is expanded to $.
    
    
    
         AddToMenu menu-name [ menu-label action ]
              Begins or adds to a menu definition.  Typically a  menu
              definition looks like this:
    
                   AddToMenu Utilities "Utilities" Title
                    + "Xterm"         Exec  exec xterm -e tcsh
                    + "Rxvt"          Exec  exec rxvt
                    + "Remote Logins" Popup Remote-Logins
                    + "Top"           Exec  exec rxvt -T Top -n \
                                      Top -e top
                    + "Calculator"    Exec  exec xcalc
                    + "Xman"          Exec  exec xman
                    + "Xmag"          Exec  exec xmag
                    + "emacs"         Exec  exec xemacs
                    + "Mail"          MailFunction \
                                      xmh "-font fixed"
                    + ""              Nop
                    + "Modules"       Popup Module-Popup
                    + ""              Nop
                    + "Exit Fvwm"     Popup Quit-Verify
    
              The menu could be invoked via
    
                   Mouse 1 R A Menu Utilities Nop
    
              or
    
                   Mouse 1 R A Popup Utilities
    
              There is no end-of-menu symbol.  Menus do not  have  to
              be defined in a contiguous region of the .fvwm2rc file.
              The quoted portion in the above examples is  the  menu-
              label, which will appear in the menu when the user pops
              it up.  The remaining portion  is  a  built-in  command
              which  should be executed if the user selects that menu
              item.  An empty menu-label ("") and  the  Nop  function
              can be used to insert a separator into the menu.
    
              Titles can be used within the  menu.  If  you  add  the
              option "top" behind the keyword "Title", the title will
              be added to the top of the menu.  If there was a  title
              already, it is overwritten.
    
    
                   AddToMenu Utilities "Tools" Title top
    
    
              All text up to the first  TAB  in  the  menu  label  is
              aligned to the left side of the menu, all text right of
              the first TAB is aligned to the right side.  All  other
              TABs are replaced by spaces.
    
              If the menu-label contains an ampersand ('&'), the next
              character  is taken as a hotkey for the menu item. Hot-
              keys are underlined in the label. To get a literal '&',
              insert '&&'.
    
              If the menu-label contains a sub-string  which  is  set
              off  by  stars,  then  the  text  between  the stars is
              expected to be the name of an xpm-icon  or  bitmap-file
              to  insert  in  the menu.  To get a literal '*', insert
              '**'.For example
    
                    + "Calculator*xcalc.xpm*" Exec exec xcalc
    
              inserts a menu item labeled "calculator" with a picture
              of a calculator above it.  The following:
    
                    + "*xcalc.xpm*"           Exec exec xcalc
    
              Omits the "Calculator" label, but leaves the picture.
    
              If the menu-label contains a sub-string  which  is  set
              off by percent signs, then the text between the percent
              signs is expected to be the  name  of  an  xpm-icon  or
              bitmap-file  to  insert  to the left of the menu label.
              To get a literal '%', insert '%%'. For example
    
                    + "Calculator%xcalc.xpm%" Exec exec xcalc
    
              inserts a menu item labeled "calculator" with a picture
    
              of a calculator to the left.  The following:
    
                    + "%xcalc.xpm%"           Exec exec xcalc
    
              Omits the "Calculator" label, but leaves  the  picture.
              The  pictures  used  with  this feature should be small
              (perhaps 16x16).
    
              If the menu-name (not the label) contains a  sub-string
              which  is  set  off  by  at  signs ("@"), then the text
              between them is expected to be the name of  an  xpm  or
              bitmap  file to draw along the left side of the menu (a
              "side pixmap"). You  will  probably  want  to  use  the
              SidePic  option  of  the MenuStyle command instead.  To
              get a literal '@', insert '@@'.  For example
    
                   AddToMenu "StartMenu@linux-menu.xpm@"
    
              creates a menu  with  a  picture  in  its  bottom  left
              corner.
    
              If the menu-name contains also a sub-string set  of  by
              '^'s,  then the text between '^'s is expected to be the
              name a of X11 color and the column containing the  side
              picture  will be colorized with that color. You can set
              this color for a menu style using the SideColor  option
              of the MenuStyle command.  To get a literal '^', insert
    
                   AddToMenu "StartMenu@linux-menu.xpm@^blue^"
    
              creates a menu with a picture in its bottom left corner
              and colorizes with blue the region of the menu contain-
              ing the picture.
    
              In all the above cases, the name of the resulting  menu
              is  name  specified, stripped of the substrings between
              the various delimiters.
    
    
    
         AnimatedMove x y [ Warp ]
    
              Move a window in an animated way. Similar to Move  com-
              mand,  below.   Options  are  the same, except they are
              required, since it doesn't make sense to  have  a  user
              move  the  window  interactively and animatedly. If the
              optional argument Warp  is  specified  the  pointer  is
              warped with the window.
    
    
    
         Beep As might be expected, this makes the terminal beep.
         BorderStyle [ state ] [ style ] [ -- [!]flag ... ]
              Defines a border  style  for  windows.   state  can  be
              either  "Active"  or  "Inactive."  If state is omitted,
              then the style is set for both states.   If  the  style
              and  flags  are  enclosed in parentheses, then multiple
              state definitions can be specified per line.
    
              style is a subset of the  available  ButtonStyles,  and
              can  only  be  TiledPixmap (uniform pixmaps which match
              the bevel colors work best this way).  If  an  "!"   is
              prefixed  to  any  flag,  flag behavior is negated.  If
              style is not  specified,  then  one  can  change  flags
              without resetting the style.
    
              The "HiddenHandles" flag hides the corner handle divid-
              ing  lines  on windows with handles (this option has no
              effect for NoHandle windows).  By  default,  HiddenHan-
              dles is disabled.
    
              The  "NoInset"  flag  supplements  HiddenHandles.    If
              given,  the  inner bevel around the window frame is not
              drawn.  If HiddenHandles is not  specified,  this  flag
              has no effect.
    
              To decorate the active and inactive window borders with
              a textured pixmap, one might specify:
    
                   BorderStyle Active TiledPixmap marble.xpm
                   BorderStyle Inactive TiledPixmap granite.xpm
                   BorderStyle Active -- HiddenHandles NoInset
    
              To clear the style for both states:
    
                   BorderStyle Simple
    
              To clear for a single state:
    
                   BorderStyle Active Simple
    
              To unset a flag for a given state:
    
                   BorderStyle Inactive -- !NoInset
    
              Title-bar buttons can inherit the border style with the
              UseBorderStyle flag (see ButtonStyle).
    
    
    
         ButtonStyle button [ state ] [ style ] [ -- [!]flag ... ]
              Sets the button style for a title-bar  button.   button
              is  the title-bar button number between 0 and 9, or one
              of  "All,"  "Left,"  "Right,"   or   "Reset."    Button
              numbering  is  described  in  the  Mouse  section  (see
              below).   If  the  style  and  flags  are  enclosed  in
              parentheses,  then  multiple  state  definitions can be
              specified per line.
    
              state refers to which button state should be set.  But-
              ton  states  are  defined  as  follows:  "ActiveUp" and
              "ActiveDown" refer to the unpressed and pressed  states
              for  buttons  on  active  windows; while the "Inactive"
              state denotes buttons on inactive windows.
    
              If state is ActiveUp,  ActiveDown,  or  Inactive,  that
              particular  button  state is set.  If state is omitted,
              every state is set.  Specifying a  style  destroys  the
              current style (use AddButtonStyle to avoid this).
    
              If style is omitted, then state-dependent flags can  be
              set for the primary button style without destroying the
              current style.  Examples  (each  line  should  be  con-
              sidered independent):
    
                   ButtonStyle Left -- flat
                   ButtonStyle All ActiveUp (-- flat) \
                     Inactive (-- flat)
    
              The first line sets every state of the left buttons  to
              flat, while the second sets only the ActiveUp and Inac-
              tive states of every button to  flat  (only  flags  are
              changed;   the   buttons'  individual  styles  are  not
              changed).
    
              If you want to reset all buttons to their defaults:
    
                   ButtonStyle Reset
    
              To reset the ActiveUp button state of button 1  to  the
              default:
    
                   ButtonStyle 1 ActiveUp Default
    
              To reset all button states of button 1 to  the  default
              of button number 2:
    
                   ButtonStyle 1 Default 2
    
    
              For any given button, multiple state definitions can be
              given  on  one line by enclosing the style and flags in
              parentheses.  If only one definition per line is  given
              the parentheses can be omitted.
    
              flags  affect  the  specified  state.   If  an  "!"  is
              prefixed  to  any  flag,  its behavior is negated.  The
              available state-dependent  flags  for  all  styles  are
              described  here  (the next ButtonStyle entry deals with
              state-independent flags).
    
              "Raised" causes a raised relief pattern to be drawn.
    
              "Sunk" causes a sunken relief pattern to be drawn.
    
              "Flat" inhibits the relief pattern from being drawn.
    
              "UseTitleStyle" causes the given button state to render
              the  current  title style before rendering the button's
              own styles.  The  Raised,  Flat,  and  Sunk  TitleStyle
              flags are ignored since they are redundant in this con-
              text.
    
              "UseBorderStyle"  causes  the  button  to  inherit  the
              decorated BorderStyle options.
    
              Raised, Sunk, and Flat are mutually exclusive, and  can
              be   specified   for   the  initial  ButtonStyle  only.
              UseTitleStyle  and  UseBorderStyle  are  also  mutually
              exclusive  (both  can  be off however).  The default is
              Raised with both UseBorderStyle and UseTitleStyle  left
              unset.
    
              There is an important note for  the  ActiveDown  state.
              When  a  button  is  pressed,  the  relief is inverted.
              Because of this, to obtain a  sunken  ActiveDown  state
              you  must  specify  the  opposite of the desired relief
              (i.e. to obtain a  pressed-in  look  which  is  raised,
              specify  Sunk  for  ActiveDown).  This behavior is con-
              sistent, but may seem confusing at first.
    
              Button styles are classified as  non-destructive,  par-
              tially   destructive,   or   fully  destructive.   Non-
              destructive styles do not affect the image.   Partially
              destructive styles can obscure some or all parts of the
              underlying  image  (i.e.  Pixmap).   Fully  destructive
              styles  obscure the entire underlying image (i.e. Solid
              or one of the  gradient  styles).   Thus,  if  stacking
              styles  with AddButtonStyle (or AddTitleStyle for title
              bars),  use  care  in  sequencing  styles  to  minimize
              redraw.
    
              The available styles and  their  arguments  now  follow
              (depending  on  compilation options, some button styles
              may be unavailable).
    
              The "Simple" style does nothing.  There  are  no  argu-
              ments,   and  this  style  is  an  example  of  a  non-
              destructive button style.
    
              The "Default" style conditionally accepts one argument:
              a  number  which specifies the default button number to
              load.  If the style command  given  is  ButtonStyle  or
              AddButtonStyle,  the  argument  is  optional (if given,
              will override the current button).  If a command  other
              than  ButtonStyle or AddButtonStyle is used, the number
              must be specified.
    
              The "Solid" style fills the button with a solid  color.
              The  relief  border  color  is not affected.  The color
              should be specified as a single argument.   This  style
              is fully destructive.
    
              The "Vector" style draws a line pattern.  Since this is
              a  standard  button  style,  the  keyword  "Vector"  is
              optional.  The specification is a little cumbersome:
    
                   ButtonStyle 2 Vector 4 50x30@1 70x70@0 \
                     30x70@0 50x30@1
    
              then the button 2 decoration will use a 4-point pattern
              consisting of a line from (x=50,y=30) to (70,70) in the
              shadow color (@0), and then to (30,70)  in  the  shadow
              color,  and  finally  to (50,30) in the highlight color
              (@1).  Is that too confusing? See the  sample  .fvwm2rc
              for  a  few examples.  This style is partially destruc-
              tive.
    
              The "VGradient" and "HGradient" styles denote  gradient
              styles.   The  H  and V prefixes denote both horizontal
              and vertical directions.
    
              This style has two forms:
    
                The first form specifies a  linear  gradient.   Argu-
                ments:  total number of colors to allocate (between 2
                and 128), the initial color, and the final color.
    
                The  second  form  specifies  a  nonlinear  gradient.
                Arguments:   total   number  of  colors  to  allocate
                (between 2 and 128), then  the  number  of  segments.
                For each segment, specify the starting color, percen-
                tage to increment, then ending  color.   Each  subse-
                quent  segment begins with the color of the last seg-
                ment.  All of the percentages must add up to 100.
    
    
    
              Example:
    
                   TitleStyle VGradient 16 3 Red 20 Blue 30 \
                     Black 50 Grey
    
              The gradient styles are fully destructive.
    
              The "Pixmap" style displays a pixmap.  A pixmap  should
              be  specified as an argument.  For example, the follow-
              ing would give  button  2  the  same  pixmap  for  both
              states, and button 4 different pixmaps for the up, down
              and inactive states.
    
                   ButtonStyle 2 Pixmap my_pixmap.xpm
                   ButtonStyle 4 ActiveUp (Pixmap up.xpm) \
                     ActiveDown (Pixmap down.xpm)
                   ButtonStyle 4 Inactive Pixmap inactive.xpm
    
              The pixmap specification can be given as an absolute or
              relative pathname (see PixmapPath).  If the pixmap can-
              not be found,  the  button  style  reverts  to  Simple.
              Flags specific to the Pixmap style are "Left," "Right,"
              "Top," and "Bottom."  These can be used to justify  the
              pixmap (default is centered for both directions).  Pix-
              map transparency is used for the  color  "None."   This
              style is partially destructive.
    
              The "MiniIcon" style draws the window's miniature  icon
              in  the  button,  which  is specified with the MiniIcon
              option of the Style command. This button style  accepts
              no arguments.  Example:
    
                   Style "*"     MiniIcon mini-bx2.xpm
                   Style "xterm" MiniIcon mini-term.xpm
                   Style "Emacs" MiniIcon mini-doc.xpm
    
                   ButtonStyle 1 MiniIcon
    
    
              The "TiledPixmap" style accepts a pixmap to be tiled as
              the  button  background.  One pixmap is specified as an
              argument.  Pixmap transparency is not used.  This style
              is fully destructive.
    
    
    
         ButtonStyle button - [!]flag ...
              Sets state-independent flags for the specified  button.
              State-independent  flags  affect button behavior.  Each
              flag is separated by a space.  If an "!" is prefixed to
              the  flag  then the flag behavior is negated.  The spe-
              cial flag "Clear" clears any existing flags.
              The following flags are usually used to tell fvwm which
              buttons should be affected by MWM function hints.  This
              is not done automatically since you might have  buttons
              bound to complex functions, for instance.
    
              "MWMDecorMenu" should be assigned to title bar  buttons
              which  display  a  menu.  The default assignment is the
              leftmost button.  When a window with  the  MWMFunctions
              Style  option requests not to show this button, it will
              be hidden.
    
              "MWMDecorMin" should be assigned to title  bar  buttons
              which  minimize  or  iconify  the  window.  The default
              assignment is the second button over from the rightmost
              button.   When  a  window  with  the MWMFunctions Style
              option requests not to show this  button,  it  will  be
              hidden.
    
              "MWMDecorMax" should be assigned to title  bar  buttons
              which  maximize  the window.  The default assignment is
              the rightmost button.  When a window with the  MWMFunc-
              tions Style option requests not to show this button, it
              will be hidden.
    
    
    
         ChangeDecor decor
              Changes the decor of  a  window  to  decor.   decor  is
              "Default,"  or  the name of a decor defined with AddTo-
              Decor.  If decor is invalid, nothing occurs.  If called
              from  somewhere  in  a  window or its border, then that
              window is affected.  If called from the root window the
              user  will  be  allowed  to  select  the target window.
              ChangeDecor only affects attributes which  can  be  set
              using the AddToDecor command.
    
                   ChangeDecor "CustomDecor1"
    
    
    
         ChangeMenuStyle menustyle menu ...
              Changes the menu style of "menu"  to  "menustyle",  you
              may  specified  more than one menu in each ChangeMenuS-
              tyle.
    
                   ChangeMenuStyle  pixmap1 Screensavers ScreenLock
    
    
    
         ClickTime [ delay ]
              Specifies the maximum delay (in milliseconds) between a
              button  press  and  a  button  release for the Function
              built-in to consider the action  a  mouse  click.   The
              default  delay is 150 milliseconds.  Omitting the delay
              value resets the ClickTime to the default.
    
    
    
         Close
              If the window accepts the delete window protocol a mes-
              sage  is  sent  to  the  window asking it to gracefully
              remove itself.  If the window does not  understand  the
              delete window protocol then the window is destroyed.
    
    
    
         ColorLimit limit
              Specifies a limit  on the colors used in  pixmaps  used
              by  fvwm.   Zero  (the    default)   sets no     limit.
              Fvwm uses  pixmaps  for  icons, mini-icons, and  pixmap
              borders  and titles.  This command limits pixmap colors
              to a set  of  colors  that   starts  out  with   common
              colors.   The  current   list  contains about 60 colors
              and  starts with white, black,  grey,    green,   blue,
              red,   cyan,   yellow,   and    magenta.   The  command
              "ColorLimit 9" would limit pixmaps to these 9 colors.
    
              It makes the most sense to  put  this  command  at  the
              front of the definitions that contain mini-icons.
    
              Solid frame and title  colors  (including  shadows  and
              gradients) are not controlled by this command.
    
    
    
         ColormapFocus FollowsMouse|FollowsFocus
              By default, fvwm installs the colormap  of  the  window
              that  the  cursor is in.  If you use ColormapFocus Fol-
              lowsFocus, then the installed colormap will be the  one
              for the window that currently has the keyboard focus.
    
    
    
         Current (conditions) command
              Performs command on the current window if it  satisfies
              all    conditions.     Conditions   include   "Iconic",
              "!Iconic", "Visible", "!Visible", "Sticky",  "!Sticky",
              "Maximized",  "!Maximized",  "Transient", "!Transient",
              "Raised", "!Raised", "CurrentDesk", "CurrentPage",  and
              "CurrentPageAnyDesk".   In  addition, the condition may
              include a window name to match to.  The window name may
              include  the  wildcards * and ?.  The window name, icon
              name, class,  and  resource  will  be  considered  when
              attempting  to find a match.  The window name can begin
              with ! which will prevent command if any of the  window
              name, icon name, class or resource match.
    
              Note that earlier versions of fvwm2 required the condi-
              tions to be enclosed in brackets instead of parentheses
              (this is still supported for backwards compatibility).
    
    
    
         CursorMove horizontal vertical
              Moves the mouse pointer by horizontal pages  in  the  X
              direction  and  vertical  pages  in  the  Y  direction.
              Either or both entries may be negative.  Both  horizon-
              tal  and  vertical  values  are expressed in percent of
              pages, so "CursorMove 100 100" means to move  down  and
              right  by  one  full page.  "CursorMove 50 25" means to
              move right half a page and down a quarter  of  a  page.
              Alternatively,  the distance can be specified in pixels
              by appending a 'p' to the  horizontal  and/or  vertical
              specification.   For  example  "CursorMove  -10p  -10p"
              means move ten pixels up and ten pixels left.  The Cur-
              sorMove  function  should  not  be  called  from pop-up
              menus.
    
    
         CursorStyle context cursornum
              Defines a new cursor for the  specified  context.   The
              various contexts are:
    
                   POSITION (XC_top_left_corner)
                      used when initially placing windows
    
                   TITLE (XC_top_left_arrow)
                      used in a window title-bar
    
                   DEFAULT (XC_top_left_arrow)
                      used in windows that don't set their cursor
    
                   SYS (XC_hand2)
                      used in one of the title-bar buttons
    
                   MOVE (XC_fleur)
                      used when moving or resizing windows
    
                   WAIT (XC_watch)
                      used during an EXEC builtin command
    
                   MENU (XC_sb_left_arrow)
                      used in menus
    
                   SELECT (XC_dot)
                      used  for  various  builtin  commands  such  as
                      iconify
    
                   DESTROY (XC_pirate)
                      used for DESTROY, CLOSE, and DELETE built-ins
    
                   TOP (XC_top_side)
                      used in the top side-bar of a window
    
                   RIGHT (XC_right_side)
                      used in the right side-bar of a window
    
                   BOTTOM (XC_bottom_side)
                      used in the bottom side-bar of a window
    
                   LEFT (XC_left_side)
                      used in the left side-bar of a window
    
                   TOP_LEFT (XC_top_left_corner)
                      used in the top left corner of a window
    
                   TOP_RIGHT (XC_top_right_corner)
                      used in the top right corner of a window
    
                   BOTTOM_LEFT (XC_bottom_left_corner)
                      used in the bottom left corner of a window
    
                   BOTTOM_RIGHT (XC_bottom_right_corner)
                      used in the bottom right corner of a window
    
              And the cursornum is the numeric value of the cursor as
              defined in the include file X11/cursorfont.h.  An exam-
              ple:
    
                   # make the kill cursor be XC_gumby:
                   CursorStyle DESTROY 56
    
              The defaults are shown in parenthesis above.
    
    
    
         DefaultColors [  foreground background ]
              DefaultColors sets the default forground and background
              colors  used  in miscellaneous windows created by fvwm,
              for example in the geometry feedback windows  during  a
              move  or resize operation.  If you don't want to change
              one color or the other, use - as  its  color  name.  To
              revert  to  the  builtin default colors omit both color
              names. Note that the default colors  are  not  used  in
              menus, window titles or icon titles.
    
    
    
         DefaultFont [ fontname ]
              DefaultFont sets the default  font  to  font  fontname.
              The  default  font  is  used by fvwm2 whenever no other
              font has been specified. To reset the default  font  to
              the  built  in  default, omit the argument. The default
              font is used for menus, window titles, icon  titles  as
              well  as the geometry feedback windows during a move or
              resize operation. To override the  default  font  in  a
              specific  context,  use  the  WindowFont,  IconFont  or
              MenuStyle commands.
    
    
    
         Delete
              Sends a message to  a  window  asking  that  it  remove
              itself, frequently causing the application to exit.
    
    
    
         Desk arg1 [ arg2 ] [ min max ]
              Switches  the  current  viewport  to  another   desktop
              (workspace, room).
    
              The command takes 1, 2, 3, or  4  arguments.  A  single
              argument  is interpreted as a relative desk number. Two
              arguments are understood as a relative and an  absolute
              desk  number.  Three  arguments specify a relative desk
              and the minimum and maximum  of  the  allowable  range.
              Four  arguments specify the relative, absolute, minimum
              and maximum values. (Desktop numbers can be negative.)
    
              If arg1 is non zero then the next desktop  number  will
              be the current desktop number plus arg1.
    
              If arg1 is zero then the new  desktop  number  will  be
              arg2.  (If arg2 is not present, then the command has no
              effect.)
    
              If min and max are given, the new desktop  number  will
              be  no  smaller than min and no bigger than max. Values
              out of this range are truncated (if you gave  an  abso-
              lute  desk  number)  or  wrapped  around (if you gave a
              relative desk number).
    
              The syntax is the same as for MoveToDesk, which moves a
              window to a different desktop.
    
              The number of active  desktops  is  determined  dynami-
              cally.   Only  desktops  which  contain  windows or are
              currently being displayed are active.  Desktop  numbers
              must  be  between  2147483647  and -2147483648 (is that
              enough?).
    
         DeskTopSize HorizontalxVertical
              Defines the virtual desktop size in units of the physi-
              cal screen size.
    
    
    
         Destroy
              Destroys an application window,  which  usually  causes
              the application to crash and burn.
    
    
    
         DestroyDecor decor
              Deletes the decor defined with AddToDecor, so that sub-
              sequent  references to it are no longer valid.  Windows
              using this decor revert to the default fvwm decor.  The
              decor named "Default" cannot be destroyed.
    
                   DestroyDecor "CustomDecor1"
    
    
    
         DestroyFunc
              Deletes a function, so that subsequent references to it
              are  no  longer  valid.  You can use this to change the
              contents of a function during  an  fvwm  session.   The
              function can be rebuilt using AddToFunc.
    
                   DestroyFunc "PrintFunction"
    
    
    
         DestroyMenu
              Deletes a menu, so that subsequent references to it are
              no  longer  valid.  You can use this to change the con-
              tents of a menu during an fvwm session.  The  menu  can
              be rebuilt using AddToMenu.
    
                   DestroyMenu "Utilities"
    
    
    
         DestroyMenuStyle menustyle
              Deletes the menu style named  "menustyle"  and  changes
              all  menus  using  this style to the default style, you
              cannot destroy the default menu.
    
                   DestroyMenuStyle pixamp1
    
    
         DestroyModuleConfig
              Deletes module configuration entries, so that new  con-
              figuration  lines  may be entered instead.  You can use
              this to change the the way a module runs during an fvwm
              session  without restarting.  Wildcards can be used for
              portions of the name as well.
    
                   DestroyModuleConfig FvwmFormFore
                   DestroyModuleConfig FvwmButtons*
    
    
    
         Direction direction (conditions) command
              Performs command (typically Focus) on a window  in  the
              given direction which satisfies all conditions.  Condi-
              tions are the same as for Current. The direction may be
              one   of  North,  Northeast,  East,  Southeast,  South,
              Southwest, West and Northwest. Which  window  Direction
              selects  depends on angle and distance between the cen-
              terpoints of the windows. Closer windows are considered
              a better match than those farther away.
    
    
    
         Echo string
              Prints a message to  stderr.   Potentially  useful  for
              debugging things in your .fvwm2rc.
    
                   Echo Beginning style defs...
    
    
    
         EdgeResistance scrolling moving
              Tells how hard it  should  be  to  change  the  desktop
              viewport  by  moving  the  mouse  over  the edge of the
              screen and how hard it should be to move a window  over
              the edge of the screen.
    
              The first parameter tells how milliseconds the  pointer
              must spend on the screen edge before fvwm will move the
              viewport.   This  is  intended  for  people   who   use
              "EdgeScroll  100  100" but find themselves accidentally
              flipping pages when they don't want to.
    
              The second parameter tells how  many  pixels  over  the
              edge  of the screen a window's edge must move before it
              actually moves partially off the screen. By default the
              viewport  is  moved a full page in the requested direc-
              tion, but if you used EdgeScroll  and  set  any  values
              other than zero they will be used instead.
              Note that, with "EdgeScroll 0 0", it is still  possible
              to  move  or  resize  windows  across  the  edge of the
              current screen.   By  making  the  first  parameter  to
              EdgeResistance 10000 this type of motion is impossible.
              With EdgeResistance less than 10000 but greater than  0
              moving over pages becomes difficult but not impossible.
              See also, EdgeThickness.
    
    
         EdgeScroll horizontal vertical
              Specifies the percentage of a page to scroll  when  the
              cursor hits the edge of a page.  A trailing "p" changes
              the interpretation to mean "pixels".  If you don't want
              any paging or scrolling when you hit the edge of a page
              include "EdgeScroll 0 0" in your .fvwm2rc file, or pos-
              sibly  better,  set the EdgeThickness to zero.  See the
              EdgeThickness command. If you  want  whole  pages,  use
              "EdgeScroll  100  100".   Both  horizontal and vertical
              should be positive numbers.
    
              If the horizontal and vertical percentages  are  multi-
              plied  by  1000  then scrolling will wrap around at the
              edge of the desktop.  If "EdgeScroll 100000 100000"  is
              used  fvwm  will scroll by whole pages, wrapping around
              at the edge of the desktop.
    
    
         EdgeThickness 0|1|2
              This is the width or height  of  the  invisible  window
              that  fvwm2 creates on the edges of the screen that are
              used for the edgescrolling feature.
    
              A value of  zero completely disables  mouse edge scrol-
              ling, even while dragging a window.
    
              1 gives the  smallest pan frames,  which seem to   work
              best  except on some servers.
    
              2 is the default.
    
              Pan frames of 1 or 2 pixels can sometimes be confusing,
              for  example, if you drag a window over the edge of the
              screen, so that it stradles aa pan frame, clicks on the
              window,  near  the  edge  of  the screen are treated as
              clicks on the root window.
    
    
    
         Emulate fvwm|mwm|win
              This command affects how miscellaneous things are  done
              by  fvwm.   For  example where the move/resize feedback
              window appears depends on this command.  To  have  more
              MWM-  or  WIN-like  behavior  you can call Emulate with
              "MWM" or "WIN" as its argument.
    
    
    
         Exec command
              Executes command.  You  should  not  use  an  ampersand
              ``&''  at the end of the command.  You probably want to
              use an additional ``exec'' at the beginning of command.
              Without  that,  the shell that fvwm invokes to run your
              command will stay until the command exits.  In  effect,
              you'll  have  twice  as  many  processes running as you
              need.  Note that some shells are smart enough to  avoid
              this,  but  it never hurts to include the ``exec'' any-
              way.
    
              The following example binds function key F1 in the root
              window,  with  no modifiers, to the exec function.  The
              program rxvt will be  started  with  an  assortment  of
              options.
    
                   Key F1 R N Exec exec rxvt -fg yellow -bg blue \
                     -e /bin/tcsh
    
    
              Note that this function doesn't  wait  for  command  to
              complete, so things like:
    
                   Exec "echo AddToMenu ... > /tmp/file"
                   Read /tmp/file
    
              won't work reliably.
    
    
         ExecUseShell [ shell ]
              Makes the Exec command use the specified shell, or  the
              value of the $SHELL environment variable if no shell is
              specified,  instead  of  the   default   Bourne   shell
              (/bin/sh).
    
                   ExecUseShell
                   ExecUseShell /usr/local/bin/tcsh
    
    
    
         FlipFocus
              Executes a Focus command as if the user  had  used  the
              pointer  to select the window.  This command alters the
              order of the windowlist in the same way as clicking  in
              a  window  to  focus, i.e. the target window is removed
              from the windowlist  and  placed  at  the  start.  This
              command  is recommended for use with the Direction com-
              mand and in the function invoked from WindowList.
    
    
    
         Focus
              Moves the viewport or window  as  needed  to  make  the
              selected  window  visible.   Sets the keyboard focus to
              the selected window.  Raises the window  if  needed  to
              make  it  visible.   Does not warp the pointer into the
              selected window (see WarpToWindow function).  Does  not
              de-iconify.   This  command does not alter the order of
              the windowlist, it rotates  the  windowlist  around  so
              that the target window is at the start.
    
    
    
         Function FunctionName
              Used to bind a previously defined function to a key  or
              mouse button.
    
              The following example binds mouse button 1 to  a  func-
              tion  called "Move-or-Raise", whose definition was pro-
              vided as an example earlier in this  man  page.   After
              performing  this  binding fvwm will execute to move-or-
              raise function whenever button 1 is pressed in a window
              title-bar.
    
                   Mouse 1 T A Function Move-or-Raise
    
              The keyword "Function" may be omitted if "FunctionName"
              does not coincide with an fvwm built-in function name
    
    
    
         GlobalOpts [ options ]
              This is a TEMPORARY command used  to  set  some  global
              options  which will later be handled as Style parms (or
              options to Style parms).  It currently handles the fol-
              lowing:
              SmartPlacementIsReallySmart/SmartPlacementIsNormal,
              ClickToFocusDoesntPassClick/ClickToFocusPassesClick,
              ClickToFocusDoesntRaise/ClickToFocusRaises,
              MouseFocusClickDoesntRaise/MouseFocusClickRaises,
              CaptureHonorsStartsOnPage/CaptureIgnoresStartsOnPage,
              RecaptureHonorsStartsOnPage/RecaptureIgnoresStartsOnPage,
              ActivePlacementHonorsStartsOnPage/ActivePlacementIgnoresStartsOnPage,
              NoStipledTitles/StipledTitles
    
    
    
              Example:
    
                   GlobalOpts ClickToFocusDoesntPassClick, \
                     ClickToFocusDoesntRaise
    
    
              RecaptureHonorsStartsOnPage  causes  a  window  to   be
              placed  according  to,  or  revert to, the StartsOnPage
              desk and page specification on  Restart  or  Recapture.
              RecaptureIgnoresStartsOnPage causes fvwm to respect the
              current window position on Restart  or  Recapture.  The
              default is RecaptureIgnoresStartsOnPage.
    
              CaptureHonorsStartsOnPage causes  the  initial  capture
              (of an already existing window) at startup to place the
              window according to  the  StartsOnPage  desk  and  page
              specification.  CaptureIgnoresStartsOnPage  causes fvwm
              to ignore these settings  (including  StartsOnDesk)  on
              initial  capture. The default is CaptureHonorsStartsOn-
              Page.
    
              ActivePlacementIgnoresStartsOnPage suppresses StartsOn-
              Page  or  StartsOnDesk placement in the event that both
              ActivePlacement and SkipMapping are in  effect  when  a
              window is created. This prevents you from interactively
              placing a window and then  wondering  where  it  disap-
              peared to, because it got placed on a different desk or
              page. ActivePlacementHonorsStartsOnPage allows this  to
              happen  anyway. The option has no effect if SkipMapping
              is not in effect,  because  fvwm  will  switch  to  the
              proper  desk/page to perform interactive placement. The
              default  is  ActivePlacementHonorsStartsOnPage,   which
              matches the way StartsOnDesk handled the situation.
    
    
         GotoPage x y
              Moves the desktop viewport to page  (x,y).   The  upper
              left  page  is (0,0), the upper right is (M,0), where M
              is one less than the current number of horizontal pages
              specified  in  the DeskTopSize command.  The lower left
              page is (0,N), and the lower right page is (M,N), where
              N  is  the  desktop's vertical size as specified in the
              DeskTopSize command.  The GotoPage function should  not
              be used in a pop-up menu.
    
    
    
         HilightColor textcolor backgroundcolor
              Specifies  the  text  and  background  colors  for  the
              decorations  on the window which currently has the key-
              board focus.
    
         IconFont [ fontname ]
              Makes fvwm use font fontname for icon labels. To  reset
              this font to the default font (see DefaultFont) you may
              omit fontname.
    
    
    
         Iconify [ value ]
              Iconifies a window if it is not  already  iconified  or
              de-iconifies  it  if  it  is already iconified.  If the
              optional argument value is positive only  iconification
              will  be allowed.  If the optional argument is negative
              only de-iconification will be allowed.
    
    
    
         IconPath path
              Specifies a colon separated list of full path names  of
              directories  where  bitmap  (monochrome)  icons  can be
              found.  Each path should start with a slash.   Environ-
              ment variables can be used here as well (i.e.  $HOME or
              ${HOME}).
    
              Note: if the FvwmM4 is used to  parse  your  rc  files,
              then  m4  may  want  to mangle the word "include" which
              will frequently show up in the IconPath  or  PixmapPath
              command.   To fix this add undefine(`include') prior to
              the IconPath command, or better  use  the  '-m4-prefix'
              option  to  force all m4 directives to have a prefix of
              "m4_" (see the FvwmM4 man page).
    
    
    
         ImagePath path
              Specifies a colon  separated  list  of  directories  in
              which  to  search  for images (both monochrome and pix-
              map).
    
              NOTE: ImagePath makes obsolete IconPath and  PixmapPath
              commands in the next fvwm versions. In this version all
              of the three commands are allowed.
    
              The ImagePath may contain environment variables such as
              $HOME  (or  ${HOME}).   Further,  a  '+' in the path is
              expanded to the previous value of  the  path,  allowing
              easy appending or prepending to the path.
    
              For example:
    
                   ImagePath $HOME/icons:+:/usr/include/X11/bitmaps
    
    
         Key keyname Context Modifiers Function
              Binds a keyboard key to a specified fvwm built-in func-
              tion,  or  removes  the  binding  if  Function  is '-'.
              Definition is the same as for a  mouse  binding  except
              that  the  mouse  button  number is replaced with a key
              name.   The  keyname  is  one  of  the   entries   from
              /usr/include/X11/keysymdef.h,   with  the  leading  XK_
              omitted.  The Context and Modifiers fields are  defined
              as  in the Mouse binding. However, when you press a key
              the context window is the window that has the  keyboard
              focus.  That  is not necessarily the same as the window
              the pointer is over (with SloppyFocus or ClickToFocus).
    
              The following example binds the built in window list to
              pop  up when Alt-Ctrl-Shift-F11 is hit, no matter where
              the mouse pointer is:
    
                   Key F11 A SCM WindowList
    
    
              Binding a key to a title-bar button will not cause that
              button to appear unless a mouse binding also exists.
    
    
    
         KillModule name
              Causes the module which was invoked with name  name  to
              be killed.  name may include wild-cards.
    
    
    
         Lower
              Allows the user to lower a window.
    
    
    
         Maximize [  horizontal vertical ]
              Without its optional arguments Maximize causes the win-
              dow  to  alternately  switch from a full-screen size to
              its normal size.
    
              With the optional arguments  horizontal  and  vertical,
              which are expressed as percentage of a full screen, the
              user can control the new size of the window.   If  hor-
              izontal is greater than 0 then the horizontal dimension
              of     the     window     will      be      set      to
              horizontal*screen_width/100.   The vertical resizing is
              similar.  For example, the following will add a  title-
              bar button to switch a window to the full vertical size
    
    
    
              of the screen:
    
                   Mouse 0 4 A Maximize 0 100
    
              The following causes windows to  be  stretched  to  the
              full width:
    
                   Mouse 0 4 A Maximize 100 0
    
              This makes a window that is half  the  screen  size  in
              each direction:
    
                   Mouse 0 4 A Maximize 50 50
    
              Values larger than 100 can be used with caution.
    
              If the letter "p" is appended to each coordinate  (hor-
              izontal  and/or  vertical), then the scroll amount will
              be measured in pixels.
    
    
    
         Menu menu-name [ position ] [ double-click-action ]
              Causes a previously defined menu to be popped up  in  a
              "sticky" manner.  That is, if the user invokes the menu
              with a click action instead of a drag action, the  menu
              will  stay up.  The command double-click-action will be
              invoked if the user  double-clicks  (or  hits  the  key
              rapidly  twice  if  the  menu  is  bound to a key) when
              bringing the menu up.
    
              Several other  commands  affect  menu  operation.   See
              MenuStyle  and  SetAnimation.  When in a menu, keyboard
              shortcuts work as expected.  Cursor keystrokes are also
              allowed.  Specifically, Cursor-Down, Ctrl-N, and Ctrl-J
              all move to the  next  item;   Cursor-Up,  Ctrl-P,  and
              Ctrl-K  all  move  to  the  prior item; Cursor-Left and
              Ctrl-B return to  the  prior  menu;   Cursor-Right  and
              Ctrl-F  popup  the  next menu; Ctrl-Cursor-Up and Ctrl-
              Cursor-Down move up and down five items,  respectively;
              Shift-Cursor-Up and Shift-Cursor-Down move to the first
              and  last  items,  respectively;  Enter  executes   the
              current  item;  Escape  exits  the  current sequence of
              menus.
    
              The pointer will be warped to where  it  was  when  the
              menu  was invoked if it was both invoked and terminated
              with a keystroke.
    
              The position arguments allow to place  the  menu  some-
              where  on the screen, for example centered on the visi-
              ble screen or above a title bar.   Basically  it  works
              like  this:  you  specify  a  context-rectangle  and an
              offset to this rectangle by which the upper left corner
              of  the menu is moved from the upper left corner of the
              rectangle.  The position arguments consist  of  several
              parts:
    
                   [ [context-rectangle] x y ] [ special-options ]
    
              The context-rectangle can be one of:
    
                   Root
                      the root window.
                   Mouse
                      a 1x1 rectangle at the mouse position.
                   Window
                      the window with the focus.
                   Interior
                      the inside of the focused window.
                   Title
                      the title of the focused window or icon.
                   Button<n>
                      button #n of the focused window.
                   Icon
                      the focused icon.
                   Menu
                      the current menu.
                   Item
                      the current menu item.
                   Context
                      the current window, menu or icon.
                   This
                      whatever widget  the  pointer  is  on  (e.g.  a
                      corner of a window or the root window).
                   Rectangle <geometry>
                      the  rectangle  defined  by  <geometry>  in   X
                      geometry format.  Width and height default to 1
                      if omitted.
    
              If the context-rectangle  is  omitted  "Mouse"  is  the
              default.   Note  that not all of these make sense under
              all circumstances (e.g. "Icon" if the pointer is  on  a
              menu).
    
              The offset values x and y specify how far the  menu  is
              moved  from  it's  default  position.  By  default, the
              numeric value given is interpreted as a  percentage  of
              the  context  rectangle's  width  (height),  but with a
              trailing "m" the menu's width (height) is used instead.
              Furthermore  a  trailing "p" changes the interpretation
              to mean "pixels".
    
              Instead of a single value you can use a list of values.
              All   additional   numbers  after  the  first  one  are
              separated from threir predecessor but  their  sign.  Do
              not use any other separators.
    
              If x or y are prefixed with 'o<number>' where  <number>
              is an integer, the menu and the rectangle will be moved
              to overlap at the specified position before  any  other
              offsets are applied. The menu and the rectangle will be
              placed so that the pixel at  <number>  percent  of  the
              rectangle's  width/height  is  right  over the pixel at
              <number> percent of the menu's width/height.   So  'o0'
              means  that  the  top/left  borders of the menu and the
              rectangle overlap, with 'o100'  it's  the  bottom/right
              borders  and  if  you  use 'o50' they are centered upon
              each other (try it and you will see it is much  simpler
              than this description). The default is 'o0'. The prefix
    
              A prefix of 'c' is equivalent of 'o50'.  Examples:
    
    
                   # window list in the middle of the screen
                   WindowList Root c c
    
                   # menu to the left of a window
                   Menu name window -100m c+0
    
                   # popup menu 8 pixels above the mouse pointer
                   Popup name mouse c -100m-8p
    
                   # somewhere on the screen
                   Menu name rectangle 512x384+1+1 +0 +0
    
                   # centered vertially around a menu item
                   AddToMenu foobar-menu
                    + "first item" Nop
                    + "special item" Popup "another menu" item \
                                     +100 c
                    + "last item" Nop
    
                   # above the first menu item
                   AddToMenu foobar-menu
                    + "first item" Popup "another menu" item +0 -100m
    
              Note that you can put a submenu  far  off  the  current
              menu  so  you could not reach it with the mouse without
              leaving the menu. If the  pointer  leaves  the  current
              menu  in  the general direction of the submenu the menu
              will stay up.
    
              The special-options:
    
                   The "animated" and "mwm" or "win" meny styles  may
                   move  a menu somewhere else on the screen.  If you
                   do not want this you can add Fixed as  an  option.
                   This might happen for example if you want the menu
                   always in the top right corner of the screen.
    
                   Where do you want a submenu  to  appear  when  you
                   click  on it's menu item?  The default is to place
                   the title under the cursor, but  if  you  want  it
                   where  the  position arguments say, use the Selec-
                   tInPlace option.  If you want the pointer  on  the
                   title of the menu, use SelectWarp too.
    
                   The pointer is warped to the title  of  a  submenu
                   whenever  the pointer would be on an item when the
                   submenu is popped up ("fvwm" menu style) or  never
                   warped  to  thetitle  at  all ("mwm" or "win" menu
                   styles). You can force (forbid)  warping  whenever
                   the  submenu is opened with the WarpTitle (NoWarp)
                   option.
    
                   Note that the special-options do work with a  nor-
                   mal menu that has no other position arguments.
    
    
         MenuStyle stylename options
              Sets a new menu style or changes a  previously  defined
              style.  The stylename is the style name; if it contains
              spaces or tabs it has to be quoted.  The  name  "*"  is
              reserved  for the default menu style.  The default menu
              style is used for every menu-like object (e.g. the win-
              dow  created by the WindowList command) that had not be
              assigned a style using the  ChangeMenuStyle.  See  also
              DestroyMenuStyle.   When using monochrome color options
              are ignored.
    
              options is a comma separated list  containing  some  of
              the   keywords  FVWM/MWM/WIN,  Foreground,  Background,
              Greyed,                     HilightBack/HilightBackOff,
              ActiveFore/ActiveForeOff,
              Hilight3DThick/Hilight3DThin/Hilight3DOff,
              Animation/AnimationOff,   Font,  MenuFace,  PopupDelay,
              PopupOffset,                    TitleWarp/TitleWarpOff,
              TitleUnderlines0/TitleUnderlines1/TitleUnderlines2,
              SeparatorsLong/SeparatorsShort,
              TrianglesSolid/TrianglesRelief,
              PopupImmediately/PopupDelayed,         DoubleClickTime,
              SidePic, SideColor.
    
              In the above list some options  are  listed  as  option
              pairs  or  triples  with  a / in between. These options
              exclude each other.
    
              FVWM, MWM, WIN reset all options to the style with  the
              same  name in former versions of fvwm2. The default for
              new menu styles is FVWM style. These  options  override
              all   others  except  Foreground,  Background,  Greyed,
              HilightBack, HilightFore and PopupDelay, so they should
              be  used  only as the first option specified for a menu
              style or to reset the style to defined  bahavior.   The
              same  effect  can  be  created by setting all the other
              options one by one.
    
              MWM and WIN style menus popup sub-menus  automatically.
              WIN  menus  indicate  the current menu item by changing
              the background to  dark.  FVWM  sub-menus  overlap  the
              parent  menu, MWM and WIN style menus never overlap the
              parent menu.
    
              FVWM   style   is   equivalent    to    HilightBackOff,
              Hilight3DThin,   ActiveForeOff,   AnimationOff,   Font,
              MenuFace,  PopupOffset  0  67,  TitleWarp,  TitleUnder-
              lines1, SeparatorsShort, TriangleRelief, PopupDelayed.
    
              MWM   style   is    equivalent    to    HilightBackOff,
              Hilight3DThick,   ActiveForeOff,   AnimationOff,  Font,
              MenuFace, PopupOffset -3 100, TitleWarpOff, TitleUnder-
              lines2,  SeparatorsLong,  TriangleRelief,  PopupImmedi-
              ately.
    
              WIN style is equivalent to  HilightBack,  Hilight3DOff,
              ActiveForeOff,   AnimationOff,  Font,  MenuFace,  Popu-
              pOffset -5 100, TitleWarpOff, TitleUnderlines1, Separa-
              torsShort, TriangleSolid, PopupImmediately.
    
              Foreground and Background may have a color name  as  an
              argument.  This  color  is  used  for  menu text or the
              menu's background.  You can  omit  the  color  name  to
              reset these colors to the built in default.
    
              Greyed may have a color name as an argument. This color
              is  the  one  used  to  draw  a menu-selection which is
              prohibited (or not recommended) by the mwm-hints  which
              an  application has specified.  If the color is omitted
              the color of "greyed" menu  entries  is  based  on  the
              background color of the menu.
    
              HilightBack and HilightBackOff  switch  hilighting  the
              background  of  the  selected  menu  item on and off. A
              specific background color may be used by providing  the
              color  name  as  an argument to HilightBack. If you use
              this option without an argument the color is  based  on
              the menu's background color.
    
              ActiveFore  and  ActiveForeOff  switch  hilighting  the
              foreground  of  the  selected  menu  item on and off. A
              specific foreground color may be used by providing  the
              color  name  as an argument to ActiveFore. Omitting the
              color name has the same effet as using ActiveForeOff.
    
              Hilight3DThick, Hilight3DThin and  Hilight3DOff  deter-
              mine  if  the selected menu item is hilighted with a 3D
              relief.   Thick  reliefs  are  two  pixels  wide,  thin
              reliefs are one pixel wide.
    
              Animation and AnimationOff turn menu  animation  on  or
              off.  When animation is on, sub-menus that don't fit on
              the screen cause the parent menu to be shifted  to  the
              left so the sub-menu can be seen.
    
              Font takes a font name as an argument.  If  a  font  by
              this  name  exists  it is used for the text of all menu
              items. If it does not exist or  if  the  name  is  left
              blank the built in default is used.
    
              MenuFace enforces a fancy background  upon  the  menus.
              You  can  use the same options for MenuFace as for But-
              tonStyle plus DGradient, (top-left to  down-right)  and
              BGradient (down-left to top-right). See ButtonStyle for
              more info. If you use MenuFace  without  arguments  the
              style is reverted back to normal.
    
              Some examples of MenuFaces are:
    
    
                   MenuFace DGradient 128 2 lightgrey 50 blue 50 white
                   MenuFace TiledPixmap texture10.xpm
                   MenuFace HGradient 128 2 Red 40 Maroon 60 White
                   MenuFace Solid Maroon
    
    
              If you encounter  performance  problems  with  gradient
              backgrounds you can try one or all of the following:
    
              Turn Hilighting of the active menu item other than for-
              ground color off:
    
    
                   MenuStyle <stylename> Hilight3DOff, HilightBackOff
                   MenuStyle ActiveFore <preferred color>
    
    
              Make sure submenus do not overlap the parent menu. This
              can  prevent  menus  being redrawn every time a submenu
              pops up or down.
    
    
                   MenuStyle <stylename> PopupOffset 1 100
    
    
              Run you X server with backing storage. If your  Xserver
              is started with the -bs option, turn it off. If not try
              the -wm option.
    
    
                   startx -- -wm
    
    
              You may have to adapt this example to your system (e.g.
              if you use xinit to start X).
    
              PopupDelay requires one numeric argument. This value is
              the  delay  in milliseconds before a sub-menu is popped
              up when the pointer moves over a menu item that  has  a
              sub-menu. If the value is zero no automatical pop up is
              done. If the argument is omitted the built  in  default
              is used. Note that the popup delay has no effect if the
              PopupImmediately option is used since sub-menus pop  up
              immediately  then. The PopupDelay option should only be
              applied to the default style ('*') since it is a global
              setting and affects all menus.
    
              PopupImmediately makes menu items with sub menus pop up
              it  up  as  soon  as  the  pointer enters the item. The
              PopupDelay is ignored then.  If  PopupDelayed  is  used
              fvwm2  looks  at  the PopupDelay option if or when this
              automatic popup happens.
    
              PopupOffset requires two integer arguments. Both values
              affect  where  sub-menus  are  placed  relative  to the
              parent menu. If both values are zero, the left edge  of
              the sub-menu overlaps the left edge of the parent menu.
              If the first value is non-zero the sub-menu is  shifted
              that many pixels to the right (or left if negative). If
              the second value is non-zero the menu is moved by  that
              many percent of the parent menu's width to the right or
              left.
    
              TitleWarp and TitleWarpOff affect if the pointer  warps
              to the menu title when a sub-menu is opened or not. Not
              that regardless of this setting the pointer will not be
              warped if the menu does not pop up under the pointer.
    
              TitleUnderlines0, TitleUnderlines1 and TitleUnderlines2
              specify how many lines are drawn below a menu title.
    
              SeparatorsLong and SeparatorsShort set  the  length  of
              menu separators. Long separators run from the left edge
              all the way to the right edge. Short separators leave a
              few pixels to the edges of the menu.
    
              TrianglesSolid and TrianglesRelief affect how the small
              triangles  for  sub-menus is drawn. Solid triangles are
              filled with a color while relief triangles are hollow.
    
              DoubleClickTime requires  one  numeric  argument.  This
              value  is  the  time  in milliseconds between two mouse
              clicks in a menu to be considered as  a  double  click.
              The  default  is  450 milliseconds.  If the argument is
              omitted the doucle click time is reset to this default.
              The  DoubleClickTime  option  should only be applied to
              the default style ('*') since it is  a  global  setting
              and affects all menus.
    
              SidePic takes the name of an xpm or bitmap file  as  an
              argument.   The picture is drawn along the left side of
              the menu. The SidePic option can  be  overridden  by  a
              menu  specific side pixmap (see AddToMenu). If the file
              name is omitted an existing side pixmap is remove  from
              the menu style.
    
              SideColor takes the name of an X11 color  as  an  argu-
              ment.  This  color  is used to colorize the column con-
              taining the side picture  (see  above).  The  SideColor
              option  can be overridden by a menu specific side color
              (see AddToMenu). If the color name is omitted the  side
              color option is switched off.
    
              Examples:
    
    
                   MenuStyle * mwm
                   MenuStyle * Foreground Black, Background gray40
                   MenuStyle * Greyed gray70, ActiveFore White
                   MenuStyle * HilightBackOff, Hilight3DOff
                   MenuStyle * Font lucidasanstypewriter-14
                   MenuStyle * MenuFace DGradient 64 darkgray MidnightBlue
    
                   MenuStyle gred mwm
                   MenuStyle gred Foreground Yellow, Background Maroon
                   MenuStyle gred Greyed Red, ActiveFore Red
                   MenuStyle gred HilightBackOff, Hilight3DOff
                   MenuStyle gred Font lucidasanstypewriter-12
                   MenuStyle gred MenuFace DGradient 64 Red Black
    
    
              Note that all style options could be placed on a single
              line for each style name.
    
    
    
         MenuStyle forecolor backcolor shadecolor font style [ anim ]
              This is the old syntax of the MenuStyle command. It  is
              obsolete  and  may be removed in the future. Please use
              the new syntax as described above.
    
              Sets the menu style.  When using monochrome the  colors
              are ignored.  The shade-color is the one used to draw a
              menu-selection which is prohibited (or not recommended)
              by  the  mwm-hints  which an application has specified.
              The style option is either "fvwm" "mwm" or "win", which
              changes  the  appearance and operation of the menus and
              where the feedback window appears  during  resizes  and
              moves.
    
              "mwm" and "win" style menus popup  sub-menus  automati-
              cally.   "win"  menus indicate the current menu item by
              changing the background  to  black.   "fvwm"  sub-menus
              overlap  the  parent  menu, "mwm" and "win" style menus
              never overlap the parent menu.  "mwm" resize  and  move
              feedback  windows  are  in  the  center  of the screen,
              instead of the upper left corner.
    
              The "anim" option is either "anim" or blank.  When this
              option  is  "anim",  sub-menus  that  don't  fit on the
              screen cause the parent menu to be shifted to the  left
              so the sub-menu can be seen.
    
              See also SetAnimation command.
    
    
         Module ModuleName
              Specifies a module which should be spawned during  ini-
              tialization.  At the current time the available modules
              (included with fvwm) are FvwmAnimate  (fancy  animation
              of  (de)iconification)  FvwmAudio  (makes  sounds to go
              with window manager actions), FvwmAuto (an  auto  raise
              module),  FvwmBacker (to change the background when you
              change desktops), FvwmBanner (to display a spiffy XPM),
              FvwmButtons   (brings  up  a  customizable  tool  bar),
              FvwmCpp  (to  preprocess  your  .fvwm2rc   with   cpp),
              FvwmEvent (trigger various actions by events), FvwmForm
              (to bring up dialogs), FvwmIconBox (like the mwm  Icon-
              Box),   FvwmIconMan   (like   the  twm  icon  manager),
              FvwmIdent (to get window info), FvwmM4  (to  preprocess
              your  .fvwm2rc  with  m4), FvwmPager (a mini version of
              the desktop), FvwmSave  (saves  the  desktop  state  in
              .xinitrc  style), FvwmSaveDesk (saves the desktop state
              in fvwm commands), FvwmScroll (puts scrollbars  on  any
              window), FvwmTalk (to interactively run fvwm commands),
              and FvwmWinList (a window list), FvwmAnimate  (produces
              animation effects when a window is iconified or deicon-
              ifed).  These modules have their own man pages.   There
              are other modules out on there as well.
    
              Modules can be short lived transient programs or,  like
              FvwmButtons,  can remain for the duration of the X ses-
              sion.  Modules will be terminated by the window manager
              prior  to  restarts  and  quits,  if possible.  See the
              introductory section on modules.  The keyword  "module"
              may  be  omitted  if  ModuleName  is  distinct from all
              built-in and function names.
    
    
    
         ModulePath
              Specifies a colon separated list of paths for  fvwm  to
              search  when  looking for a module to load.  Individual
              directories do not need trailing slashes.   Environment
              variables  can  be  used  here  as well (i.e.  $HOME or
              ${HOME}).  The builtin module path is available via the
              environment variable $FVWM_MODULEDIR.
    
    
    
         Mouse Button Context Modifiers Function
              Defines a mouse binding,  or  removes  the  binding  if
              Function  is  zero  then  any  button  will perform the
              specified function.  Context describes where the  bind-
              ing applies.  Valid contexts are R for the root window,
              W for an application window, T for a window title  bar,
              S for a window side, top, or bottom bar, F for a window
              frame (the corners), I for an Icon window, or 0 through
              9  for  title-bar  buttons, or any combination of these
              letters.  A is for any  context  except  for  title-bar
              buttons.   For  instance,  a  context of FST will apply
              when the mouse is anywhere in a window's border  except
              the title-bar buttons.
    
              Modifiers is any combination of N for no  modifiers,  C
              for  control,  S  for  shift,  M for Meta, or A for any
              modifier.  For example, a modifier  of  SM  will  apply
              when both the Meta and Shift keys are down.  X11 modif-
              iers mod1 through mod5 are represented as the digits  1
              through 5.
    
              Function is one of fvwm's built-in functions.
    
              The title bar buttons are numbered  with  odd  numbered
              buttons  on  the  left  side  of the title bar and even
              numbers on the  right.   Smaller-numbered  buttons  are
              displayed  toward  the  outside  of  the  window  while
              larger-numbered buttons appear toward the middle of the
              window  (0  is  short for 10).  In summary, the buttons
    
              are numbered:
    
                   1 3 5 7 9    0 8 6 4 2
    
              The highest odd numbered button  which  has  an  action
              bound  to  it determines the number of buttons drawn on
              the left side of  the  title  bar.   The  highest  even
              number  determines  the  number  or  right side buttons
              which are drawn.  Actions can be bound to either  mouse
              buttons or keyboard keys.
    
    
    
         Move [ x y [ Warp ] ]
              Allows the user to move a window.  If called from some-
              where  in a window or its border, then that window will
              be moved.  If called from the root window then the user
              will  be  allowed  to  select the target window. If the
              optional argument Warp  is  specified  the  pointer  is
              warped with the window.
    
              The operation can be aborted with Escape or by pressing
              any  mouse  button  (except button 1 which confirms the
              move).
    
              If the optional arguments x and y  are  provided,  then
              the  window  will  be  moved  immediately  without user
              interaction.  Each argument can specify an absolute  or
              relative  position  from either the left (top) or right
              (bottom) of the screen.  By default, the numeric  value
              given  is  interpreted  as  a  percentage of the screen
              width  (height),  but  a  trailing  "p"   changes   the
              interpretation to mean "pixels".
    
              Simple Examples:
    
                   # Interactive move
                   Mouse 1 T A Move
                   # Move window so top left is at (10%,10%)
                   Mouse 2 T A Move 10 10
                   # Move top left to (10pixels,10pixels)
                   Mouse 3 T A Move 10p 10p
    
    
              More complex examples (these can be bound as actions to
              keystrokes, etc.; only the command is shown, though):
    
                   # Move window so bottom right is at bottom
                   # right of screen
                   Move -0 -0
    
                   # Move window 5% to the right, and to the
                   # middle vertically
                   Move w+5 50
    
                   # Move window up 10 pixels, and so left edge
                   # is at x=40 pixels
                   Move 40p w-10p
    
    
              See also the "AnimatedMove" command, above.
    
    
    
         MoveToDesk arg1 [ arg2 ] [ min max ]
              Moves  the   selected   window   to   another   desktop
              (workspace, room).
    
              The arguments are the same as  for  the  Desk  command.
              MoveToDesk  is  a  replacement  for the old WindowsDesk
              command, which can no longer be used.
    
    
    
         MoveToPage [ x y ]
              Moves the selected window to another  page  (x,y).  The
              upper  left  page  is  (0,0), the upper right is (M,0),
              where M is one less than the current number of horizon-
              tal  pages  specified  in the DeskTopSize command.  The
              lower left page is (0,N), and the lower right  page  is
              (M,N), where N is the desktop's vertical size as speci-
              fied in the DeskTopSize command. If x  and  y  are  not
              given,  the window is moved to the current page (a win-
              dow that  has  the  focus  but  is  off-screen  can  be
              retrieved with this).
    
    
    
         Next (conditions) command
              Performs command (typically Focus) on the  next  window
              which  satisfies  all  conditions.   Conditions are the
              same as for Current with the addition  of  CirculateHit
              which  overrides  the CirculateSkip style attribute and
              CirculateHitIcon which overrides the  CirculateSkipIcon
              style attribute for iconified windows.
    
    
    
         None (conditions) command
              Performs command if no window which satisfies all  con-
              ditions exists.  Conditions are the same as for Next.
    
    
    
         Nop  Does nothing.  This is used to insert a blank  line  or
              separator in a menu.  If the menu item specification is
              Nop " ", then a blank line is inserted.   If  it  looks
              like  Nop  "",  then a separator line is inserted.  Can
              also be used as the double-click action for Menu.
    
    
    
         OpaqueMoveSize percentage
              Tells fvwm the maximum size window  with  which  opaque
              window movement should be used.  The percentage is per-
              cent of the total screen area.  With "OpaqueMoveSize 0"
              all   windows  will  be  moved  using  the  traditional
              rubber-band outline.   With  "OpaqueMoveSize  100"  all
              windows  will be move as solid windows.  The default is
              "OpaqueMoveSize 5", which allows small  windows  to  be
              moved  in  an opaque manner but large windows are moved
              as rubber-bands.
    
    
    
         PipeRead cmd option
              Causes fvwm to read commands output  from  the  program
              named cmd.  Useful for building up dynamic menu entries
              based on a directories contents, for example.
    
    
    
         PixmapPath path
              Specifies a colon separated list of full path names  of
              directories  where  pixmap  (color) icons can be found.
              Each path should start with a slash.  Environment vari-
              ables  can  be  used  here  as  well  (i.e.   $HOME  or
              ${HOME}).
    
    
    
         Popup PopupName [ position ] [ default-action ]
              This built-in has two purposes: to bind a menu to a key
              or  mouse  button,  and to bind a sub-menu into a menu.
              The formats for the two purposes differ slightly.   The
              position  arguments are the same as for Menu.  The com-
              mand default-action will be invoked if the user  clicks
              a button to invoke the menu and releases it immediately
              again (or hits the key rapidly twice  if  the  menu  is
              bound to a key).
    
              To bind a previously defined pop-up menu to  a  key  or
              mouse button:
    
                The following example binds mouse buttons 2 and 3  to
                a  pop-up  called "Window Ops".  The menu will pop up
                if the buttons 2 or  3  are  pressed  in  the  window
                frame,  side-bar,  or  title-bar,  with  no modifiers
                (none of shift, control, or meta).
    
                     Mouse 2 FST N Popup "Window Ops"
                     Mouse 3 FST N Popup "Window Ops"
    
                Pop-ups can be bound to keys through the use  of  the
                Key  built in.  Pop-ups can be operated without using
                the mouse by binding to keys and operating via the up
                arrow, down arrow, and enter keys.
    
             To bind a previously  defined  pop-up  menu  to  another
             menu, for use as a sub-menu:
    
               The following  example  defines  a  sub  menu,  "Quit-
               Verify"  and  binds it into a main menu, called "Root-
               Menu":
    
                    AddToMenu Quit-Verify
                     + "Really Quit Fvwm?" Title
                     + "Yes, Really Quit"  Quit
                     + "Restart Fvwm2"     Restart fvwm2
                     + "Restart Fvwm 1.xx" Restart fvwm
                     + ""                  Nop
                     + "No, Don't Quit"    Nop
    
                    AddToMenu RootMenu "Root Menu" Title
                     + "Open XTerm Window" Popup NewWindowMenu
                     + "Login as Root"     Exec exec xterm \
                                                     -fg green -T Root \
                                                     -n Root -e su -
                     + "Login as Anyone"   Popup AnyoneMenu
                     + "Remote Hosts"      Popup HostMenu
                     + ""                  Nop
                     + "X utilities"       Popup Xutils
                     + ""                  Nop
                     + "Fvwm Modules"      Popup Module-Popup
                     + "Fvwm Window Ops"   Popup Window-Ops
                     + ""                  Nop
                     + "Previous Focus"    Prev [*] Focus
                     + "Next Focus"        Next [*] Focus
                     + ""                  Nop
                     + "Refresh screen"    Refresh
                     + "Recapture screen"  Recapture
                     + ""                  Nop
                     + "Reset X defaults"  Exec xrdb -load \
                                           $HOME/.Xdefaults
                     + ""                  Nop
                     + ""                  Nop
                     + "Quit"              Popup Quit-Verify
    
            Popup differs from Menu in that pop-ups do not stay up if
            the user simply clicks.  These are Twm style popup-menus,
            which are a little hard  on  the  wrist.   Menu  provides
            Motif or Microsoft-Windows style menus which will stay up
            on a click action.  See menu for an  explanation  of  the
            interactive behaviour of menus.
    
    
    
         Prev (conditions) command
              Performs command (typically Focus) on the previous win-
              dow which satisfies all conditions.  Conditions are the
              same as for Next.
    
    
    
         Quit Exits fvwm, generally causing X to exit too.
    
    
    
         QuitScreen
              Causes fvwm to stop managing the screen  on  which  the
              command was issued.
    
    
    
         Raise
              Allows the user to raise a window.
    
    
    
         RaiseLower
              Alternately raises and lowers a window.
    
    
    
         Read filename [ option ]
              Causes fvwm  to  read  commands  from  the  file  named
              filename.   If  the  option  following  the filename is
              "Quiet", no message is produced  if  the  file  is  not
              found.
    
    
    
         Recapture
              Causes fvwm to recapture  all  of  its  windows.   This
              ensures  that the latest style parameters will be used.
              The recapture operation is visually disturbing.
    
    
    
         Refresh
              Causes all windows on the screen to redraw themselves.
    
    
    
         RefreshWindow
              Causes current (or chosen) window to redraw itself.
    
    
    
         Resize [ x y ]
              Allows the user to resize a  window.   If  called  from
              somewhere  in  a window or its border, then that window
              will be resized.  If called from the root  window  then
              the user will be allowed to select the target window.
    
              The operation can be aborted with Escape or by pressing
              any  mouse  button  (except button 1 which confirms the
              resize).
    
              If the optional arguments x and y  are  provided,  then
              the window will be resized so that its dimensions are x
              by y).  The units of x  and  y  are  percent-of-screen,
              unless  a letter "p" is appended to each coordinate, in
              which case the location is specified in pixels.
    
    
    
         Restart  WindowManagerName
              Causes fvwm to restart itself if  WindowManagerName  is
              "fvwm2", or to switch to an alternate window manager if
              WindowManagerName is other than "fvwm2".  If the window
              manager  is  not  in your default search path, then you
              should use the full path name for WindowManagerName.
    
              This command should not have a  trailing  ampersand  or
              any  command  line arguments and should not make use of
              any environmental variables.  Of  the  following  exam-
              ples,  the  first two are sure losers, but the third is
              OK:
    
                   Key F1 R N Restart fvwm &
                   Key F1 R N Restart $(HOME)/bin/fvwm
                   Key F1 R N Restart /home/nation/bin/fvwm
    
    
    
         Scroll horizonal vertical
              Scrolls the virtual desktop's  viewport  by  horizontal
              pages  in  the x-direction and vertical pages in the y-
              direction.  Either or both  entries  may  be  negative.
              Both  horizontal  and  vertical values are expressed in
              percent of pages, so "Scroll 100 100" means  to  scroll
              down  and  left by one full page.  "Scroll 50 25" means
              to scroll left half a page and  down  a  quarter  of  a
              page.   The  scroll  function should not be called from
              pop-up menus. Normally, scrolling stops at the edge  of
              the desktop.
    
              If the horizontal and vertical percentages  are  multi-
              plied  by  1000  then scrolling will wrap around at the
              edge of the desktop.  If "Scroll 100000 0" is  executed
              over  and  over fvwm will move to the next desktop page
              on each execution and will wrap around at the  edge  of
              the desktop, so that every page is hit in turn.
    
              If the letter "p" is appended to each coordinate  (hor-
              izontal  and/or  vertical), then the scroll amount will
              be measured in pixels.
    
    
         SendToModule modulename string
              Sends an arbitrary string (no quotes required)  to  all
              modules  matching  modulename,  which may contain wild-
              cards.  This only makes sense if the module is  set  up
              to  understand  and  deal  with these strings though...
              Can be used for  module  to  module  communication,  or
              implementation of more complex commands in modules.
    
    
         SetAnimation milliseconds-delay [ fractions-to-move-list ]
              Sets the time between frames and the list of fractional
              offsets  to  customize the animated moves of the Anima-
              tedMove command and the animation of menus (if the menu
              style  is  set to animated).  If the fractions-to-move-
              list is  omitted,  only  the  time  between  frames  is
              altered.   The fractions-to-move-list specifies how far
              the window should be offset at each successive frame as
              a fraction of the difference between the starting loca-
              tion and the ending location.  e.g.:
    
                   SetAnimation 10 -.01 0 .01 .03 .08 .18 .3 \
                     .45 .6 .75 .85 .90 .94 .97 .99 1.0
    
    
              Sets the delay between frames to  10ms,  and  sets  the
              positions  of  the  16  frames of the animation motion.
              Notice that negative values are allowed, and in partic-
              ular  can  be  used to make the motion appear more car-
              toonish, by briefly moving  slightly  in  the  opposite
              direction  of  the main motion.  The above settings are
              the default.
    
    
         SetEnv varname stringvalue
              Set an environment variable to a new value, similar  to
              shell's export or setenv command.  The variable and its
              value are inherited by processes  started  directly  by
              fvwm2.   This  can  be especially useful in conjunction
              with the FvwmM4 module; e.g.   "SetEnv  height  HEIGHT"
              will  make  the  FvwmM4-set variable "HEIGHT" usable by
              processes started by fvwm2 as the environment  variable
              "$height".   If  stringvalue  includes  whitespace, you
              should enclose it in quotes.
    
    
    
         SnapAttraction proximity [ behavior ]
              If during an interactive  move  the  window  (or  icon)
              comes within proximity pixels of another the window (or
              icon) will be moved to make  the  borders  adjoin.  The
              default  of  -1  means that no snapping will happen.  A
              setting of 0 does indeed snap when the distance is zero
              pixels.   This is relevant when the SnapGrid command is
              used.
    
              The behavior argument is optional and may be set to one
              of the four following values:
    
              With All both icons and windows snap to  other  windows
              and other icons.
    
              SameType lets snap windows only to  other  windows  and
              icons only to other icons.
    
              With Windows windows snap only to other windows.  Icons
              do not snap.
    
              Similarly with Icons icons snap to only other icons and
              windows do not snap.
    
              The default  SnapAttraction  setting  for  behavior  is
              "All".
    
    
         SnapGrid x-grid-size y-grid-size
              During an interactive move a window (or icon)  will  be
              positioned  such  that  its  location (top left corner)
              will be coincindent with the nearest grid  point.   The
              default x-grid-size and y-grid-size setting are both 1,
              which is effectively no grid all.  An interactive  move
              with  both  SnapGrid  and SnapAttraction in effect will
              result in the window being moved to be adjacent to  the
              nearest  window  border  (if  within snap proximity) or
              grid position.  In other words, the  window  will  move
              the shortest distance possible to satisfy both SnapGrid
              and SnapAttraction.  Note that the X and Y  coordinates
              are  not  coupled.   For  example, a window may snap to
              another window on the X axis while snapping to  a  grid
              point on the Y axis.
    
    
         Stick
              Makes a window sticky if it is not already  sticky,  or
              non-sticky if it is already sticky.
    
    
         Style windowname options
              This command is intended to replace the old  fvwm  1.xx
              global   commands   NoBorder,   NoTitle,  StartsOnDesk,
              Sticky,  StaysOnTop,  Icon,  WindowListSkip,   Circula-
              teSkip,  SuppressIcons, BoundaryWidth, NoBoundaryWidth,
              StdForeColor, and StdBackColor with a  single  flexible
              and  comprehensive  window(s)  specific  command.  This
              command is used to set attributes of a window to values
              other  than  the  default  or to set the window manager
              default styles.
    
              windowname can be a window's name, class,  or  resource
              string.  It can contain the wildcards * and/or ?, which
              are matched in the usual Unix  filename  manner.   They
              are searched in the reverse order stated, so that Style
              commands based on the name override  or  augment  those
              based  on  the  class,  which override or augment those
              based on the resource string.
    
              Note - windows that have no name (WM_NAME) are given  a
              name of "Untitled", and windows that don't have a class
              (WM_CLASS, res_class) are given Class =  "NoClass"  and
              those  that  don't have a resource (WM_CLASS, res_name)
              are given Resource = "NoResource".
    
              options is a comma separated list  containing  some  or
              all   of   the   keywords   BorderWidth,   HandleWidth,
              NoIcon/Icon,  MiniIcon,  IconBox,  IconGrid,  IconFill,
              NoTitle/Title,                       NoHandles/Handles,
              WindowListSkip/WindowListHit,
              CirculateSkip/CirculateHit,        StaysOnTop/StaysPut,
              Sticky/Slippery,    StartIconic/StartNormal,     Color,
              ForeColor,                                   BackColor,
              StartsOnDesk/StartsOnPage/StartsAnyWhere,
              IconTitle/NoIconTitle,          MWMButtons/FvwmButtons,
              MWMBorder/FvwmBorder,             MWMDecor/NoDecorHint,
              MWMFunctions/NoFuncHint,       HintOverride/NoOverride,
              NoButton/Button,                     OLDecor/NoOLDecor,
              StickyIcon/SlipperyIcon,  SmartPlacement/DumbPlacement,
              RandomPlacement/ActivePlacement,
              DecorateTransient/NakedTransient,
              SkipMapping/ShowMapping,      UseDecor,       UseStyle,
              NoPPosition/UsePPosition,          Lenience/NoLenience,
              ClickToFocus/SloppyFocus/MouseFocus|FocusFollowsMouse.
    
              In the above list some options  are  listed  as  style-
              option/opposite-style-option.     The   opposite-style-
              option for entries that have them  describes  the  fvwm
              default  behavior and can be used if you want to change
              the fvwm default behavior.
    
              DecorateTransient causes transient windows,  which  are
              normally  left  undecorated, to be given the usual fvwm
              decorations (title bar, buttons, etc.). Note that  some
              pop-up  windows,  such  as  the  xterm  menus,  are not
              managed by the window manager and still do not  receive
              decorations.  NakedTransient (the default) causes tran-
              sient windows not to be given the standard decorations.
    
              Icon takes an (optional) unquoted string argument which
              is the icon bitmap or pixmap to use.
    
              IconBox takes four numeric arguments or an X11 geometry
              string:
    
                   IconBox l t r b
    
              or
    
                   IconBox geometry
    
    
              Where l is the left coordinate, t  is  the  top,  r  is
              right  and  b  is bottom. Negative coordinates indicate
              distance from  the  right  or  bottom  of  the  screen.
              Perhaps easier to use is an X11 Geometry string:
    
                   IconBox -80x200-1-1
    
              Which would place an 80 by 240  pixel  iconbox  in  the
              lower  right hand corner of the screen.  The iconbox is
              a region of the screen where fvwm attempts to put icons
              for any matching window, as long as they do not overlap
              other icons.  Multiple icon boxes  can  be  defined  as
              overflow areas.  When the first icon box is filled, the
              second one is filled.  All the icon boxes for one style
              must be defined in one command.  For example:
    
                   Style "*" IconBox -80x200-1-1, \
                             IconBox 1000x70-1-1
    
    
    
              IconGrid takes 2 numeric arguments greater than zero.
    
                   IconGrid x y
    
              Icons are placed in an icon box by  stepping  thru  the
              icon  box  using  the x and y values for the icon grid,
              looking for a free space.  The default grid is 3  by  3
              pixels which gives a tightly packed appearance.  To get
              a more regular appearance use a grid larger  than  your
              largest  icon.   Currently  there  is no way to clip an
              icon to a maximum size.  An  IconGrid  definition  must
              follow the IconBox definition that it applies to:
    
                   Style "*" IconBox -80x240-1-1, IconGrid 90 90
    
    
              IconFill takes 2 arguments.
    
                   IconFill Bottom Right
    
              Icons are placed in an icon box by  stepping  thru  the
              icon box using these arguments to control the direction
              the box is filled in.  By default the direction is left
              to  right, then top to bottom.  This would be expressed
              as:
    
                   IconFill left bottom
    
              To fill an icon box in columns instead of rows, specify
              the  vertical  direction  (top  or  bottom) first.  The
              directions can be abbreviated or spelled  out  as  fol-
              lows:  "t",  "top",  "b",  "bot", "bottom", "l", "lft",
              "left", "r", "rgt", "right".   An  IconFill  definition
              must follow the IconBox definition that it applies to:
    
                   Style "*" IconBox -80x240-1-1, IconFill b r
    
    
              MiniIcon specifies a pixmap to  use  as  the  miniature
              icon  for the window.  This miniature icon can be drawn
              in a title-bar button (see  ButtonStyle),  and  can  be
              used by various fvwm modules (FvwmWinList, FvwmIconMan,
              and FvwmTaskBar). It takes the name of a pixmap  as  an
              argument.
    
              StartsOnDesk takes a  numeric  argument  which  is  the
              desktop  number on which the window should be initially
              placed.   Note  that  standard  Xt  programs  can  also
              specify this via a resource (e.g. "-xrm '*Desk: 1'").
    
              StartsOnPage takes 1, 2, or 3 numeric arguments. If one
              or  three  arguments  are  givem,  the  first (or only)
              argument is the desktop number.  If three arguments are
              given,  the 2nd and 3rd arguments identify the x,y page
              position on the virtual window. If  two  arguments  are
              given,  they specify the page position, and indicate no
              desk preference. If only one argument is given,  Start-
              sOnPage  functions exactly like StartsOnDesk. For those
              standard Xt programs which understand this  usage,  the
              starting desk/page can also be specified via a resource
              (e.g., "-xrm 'Fvwm.Page: 1 0 2'").
    
              StartsOnPage in conjunction with SkipMapping is a  use-
              ful  technique  when  you  want to start an app on some
              other page and  continue  with  what  you  were  doing,
              rather than waiting for it to appear.
    
              StaysOnTop makes the window always try to stay  on  top
              of  the  other windows.  This might be handy for clocks
              or mailboxes that you would always like to be  visible.
              If  the window is explicitly lowered it will not try to
              force its way back to the top until  it  is  explicitly
              raised.  StaysPut (the default) allows the window to be
              obscured and stay that way.
    
              BorderWidth takes a numeric argument which is the width
              of  the  border to place the window if it does not have
              resize-handles.
    
              HandleWidth takes a numeric argument which is the width
              of  the  border  to  place  the  window if it does have
              resize-handles.
    
              Button and NoButton take a numeric  argument  which  is
              the  number  of  the  title-bar  button  which is to be
              included/omitted.
    
              StickyIcon makes the window sticky when its  iconified.
              It will deiconify on top the active desktop.
    
              MWMButtons makes the Maximize  button  look  pressed-in
              when  the  window is maximized.  See the MWMButton flag
              in ButtonStyle for more information.
    
              MWMBorder makes the 3-D bevel more closely match mwm's.
    
              MWMDecor makes fvwm attempt to  recognize  and  respect
              the mwm decoration hints that applications occasionally
              use.
    
              MWMFunctions  makes  fvwm  attempt  to  recognize   and
              respect the mwm prohibited operations hints that appli-
              cations  occasionally  use.   HintOverride  makes  fvwm
              shade  out  operations  that mwm would prohibit, but it
              lets you perform the operation anyway.
    
              OLDecor makes fvwm attempt to recognize and respect the
              olwm  and  olvwm  hints  that many older XView and OLIT
              applications use.
    
              Color takes two arguments.  The first  is  the  window-
              label   text   color  and  the  second  is  the  window
              decoration's normal background color.  The  two  colors
              are  separated  with  a  slash.   If the use of a slash
              causes  problems  then  the  separate   ForeColor   and
              BackColor options can be used.
    
              UseDecor accepts one argument:  the  name  of  a  decor
              created with AddToDecor.  If UseDecor is not specified,
              the "Default" decor is used.  Windows do  not  actually
              contain decors, but are always assigned to one.  If the
              decor is later modified with  AddToDecor,  the  changes
              will  be  visible for all windows which are assigned to
              it.  The decor for a  window  can  be  reassigned  with
              ChangeDecor.
    
              UseStyle takes one arg, which is the  name  of  another
              style.   That  way  you can have unrelated window names
              easily inherit similar traits  without  retyping.   For
              example: 'Style "rxvt" UseStyle "XTerm"'.
    
              SkipMapping tells fvwm not to switch to  the  desk  the
              window is on when it gets mapped initially (useful with
              StartsOnDesk or StartsOnPage).
    
              Lenience instructs fvwm to ignore the convention in the
              ICCCM  which  states  that  if  an application sets the
              input field of the wm_hints structure to False, then it
              never  wants  the  window  manager to give it the input
              focus.  The only application that I know of which needs
              this  is  sxpm,  and that is a silly bug with a trivial
              fix and has no overall effect on  the  program  anyway.
              Rumor  is  that  some  older applications have problems
              too.
    
              ClickToFocus instructs fvwm to give the  focus  to  the
              window  when  it is clicked in.  The default MouseFocus
              (or its alias FocusFollowsMouse) tells fvwm to give the
              window the focus as soon as the pointer enters the win-
              dow, and take it away when the pointer leaves the  win-
              dow.  SloppyFocus  is  similar, but doesn't give up the
              focus if the pointer leaves the window to pass over the
              root  window or a ClickToFocus window (unless you click
              on it, that is), which makes it possible  to  move  the
              mouse out of the way without losing focus.
    
              NoPPosition instructs  fvwm  to  ignore  the  PPosition
              field when adding new windows.  Adherence to the PPosi-
              tion field is required for some  applications,  but  if
              you don't have one of those its a real headache.
    
              RandomPlacement causes  windows  which  would  normally
              require  user  placement  to be automatically placed in
              ever-so-slightly random locations.  For the best of all
              possible  worlds  use  both  RandomPlacement and Smart-
              Placement.
    
              SmartPlacement  causes  windows  which  would  normally
              require  user placement to be automatically placed in a
              smart location - a location in which they do not  over-
              lap  any other windows on the screen.  If no such posi-
              tion can be found user placement  or  random  placement
              (if specified) will be used as a fall-back method.  For
              the best of all possible worlds use  both  RandomPlace-
              ment and SmartPlacement.
    
              An example:
    
                   # Change default fvwm behavior to no title-
                   # bars on windows! Also define a default icon.
                   Style "*"           NoTitle,                 \
                                       Icon unknown1.xpm,       \
                                       BorderWidth 4,           \
                                       HandleWidth 5
    
                   # now, window specific changes:
                   Style "Fvwm*"       NoHandles, Sticky,       \
                                       WindowListSkip,          \
                                       BorderWidth 0
                   Style "Fvwm Pager"  StaysOnTop, BorderWidth 0
                   Style "*lock"       NoHandles, Sticky,       \
                                       StaysOnTop, WindowListSkip
                   Style "xbiff"       Sticky, WindowListSkip
                   Style "FvwmButtons" NoHandles, Sticky,       \
                                       WindowListSkip
                   Style "sxpm"        NoHandles
                   Style "makerkit"
    
                   # Put title-bars back on xterms only!
                   Style "xterm"     Title, Color black/grey
    
                   Style "rxvt"        Icon term.xpm
                   Style "xterm"       Icon rterm.xpm
                   Style "xcalc"       Icon xcalc.xpm
                   Style "xbiff"       Icon mail1.xpm
                   Style "xmh"         Icon mail1.xpm,         \
                                       StartsOnDesk 2
                   Style "xman"        Icon xman.xpm
                   Style "matlab"      Icon math4.xpm,         \
                                       StartsOnDesk 3
                   Style "xmag"        Icon magnifying_glass2.xpm
                   Style "xgraph"      Icon graphs.xpm
                   Style "FvwmButtons" Icon toolbox.xpm
                   Style "Maker"       StartsOnDesk 1
                   Style "signal"      StartsOnDesk 3
    
                   # Fire up Netscape on the second desk, in the
                   # middle of my 3x3 virtual desktop, and don't
                   # bother me with it...
                   Style "Netscape*" SkipMapping,              \
                                     StartsOnPage 1 1 1
    
              Note that all properties for a  window  will  be  OR'ed
              together.   In  the  above example "FvwmPager" gets the
              property StaysOnTop via an exact window name match  but
              also  gets  NoHandles,  Sticky, and WindowListSkip by a
              match to "Fvwm*".  It will get NoTitle by virtue  of  a
              match  to "*".  If conflicting styles are specified for
              a window, then the last style specified will be used.
    
              If the NoIcon attribute is set then the specified  win-
              dow  will  simply  disappear when it is iconified.  The
              window can be recovered through  the  window-list.   If
              Icon  is set without an argument then the NoIcon attri-
              bute is cleared but no icon is specified.   An  example
              which allows only the FvwmPager module icon to exist:
    
                   Style "*" NoIcon
                   Style "Fvwm Pager" Icon
    
    
    
         Title
              Does nothing.  This is used to insert a title line in a
              popup or menu.
    
    
    
         TitleStyle [ justification ] [ height num ]
              Sets attributes for the title bar.  Justifications  can
              be  "Centered",  "RightJustified,"  or "LeftJustified."
              height sets the title bar's height to an amount in pix-
              els.  Defaults are Centered and WindowFont height.  The
              height parameter must be set after a WindowFont command
              since  WindowFont  resets the height to the default for
    
    
    
              the specified font.  Example:
    
                   TitleStyle LeftJustified Height 24
    
    
    
         TitleStyle [ state ] [ style ] [ -- [!]flag ... ]
              Sets the style for the title bar.  state can be one  of
              "ActiveUp,"  "ActiveDown,"  or "Inactive."  If state is
              omitted, then the style is added to  every  state.   If
              parentheses are placed around the style and flags, then
              multiple state  definitions  can  be  given  per  line.
              style can be omitted so that flags can be set while not
              destroying the current style.
    
              If an "!" is prefixed to  any  flag,  its  behavior  is
              negated.   Valid flags for each state include "Raised,"
              "Flat," and "Sunk" (these are mutually exclusive).  The
              default is Raised.  See the note in ButtonStyle regard-
              ing the ActiveDown state.  Examples:
    
                   TitleStyle ActiveUp HGradient 16 navy black
                   TitleStyle ActiveDown (Solid red -- flat) \
                     Inactive (TiledPixmap wood.xpm)
                   TitleStyle ActiveUp (-- Flat) ActiveDown  \
                     (-- Raised) Inactive (-- Flat)
    
              This sets the ActiveUp state to a horizontal  gradient,
              the  ActiveDown  state  to  solid red, and the Inactive
              state to a tiled wood pixmap.  Finally, ActiveUp is set
              to  look  flat,  while  ActiveDown  set to be sunk (the
              Raised flag for  the  ActiveDown  state  causes  it  to
              appear  Sunk  due to relief inversion), and Inactive is
              set to flat as well.  An example which sets  flags  for
              all states:
    
                   TitleStyle -- flat
    
              For a flattened look:
    
                   TitleStyle -- flat
                   ButtonStyle All ActiveUp (-- flat) Inactive \
                     (-- flat)
    
    
    
         UpdateDecor [ decor ]
              Updates window decorations.  decor is an optional argu-
              ment  which  specifies  the decor to update.  If given,
              only windows which  are  assigned  to  that  particular
              decor  will  be  updated.   This command is useful, for
              instance, after a ButtonStyle,  TitleStyle  or  Border-
              Style  (possibly  used in conjunction with AddToDecor).
              Specifying an invalid  decor  results  in  all  windows
              being  updated.   This  command is less disturbing than
              Recapture, but does not affect window style options  as
              Recapture does.
    
    
    
         Wait name
              This built-in is intended to be used in fvwm  functions
              only.  It causes execution of a function to pause until
              a new window name  name  appears.  Fvwm  remains  fully
              functional  during a wait.  This is particularly useful
              in the InitFunction if you are trying to start  windows
              on specific desktops:
    
                   AddToFunc InitFunction
                    + "I" exec xterm -geometry 80x64+0+0
                    + "I" Wait xterm
                    + "I" Desk 0 2
                    + "I" Exec exec xmh -font fixed -geometry \
                          507x750+0+0
                    + "I" Wait xmh
                    + "I" Desk 0 0
    
              The above function starts an xterm on the current desk,
              waits for it to map itself, then switches to desk 2 and
              starts an xmh.  After the xmh  window  appears  control
              moves to desk 0.
    
    
    
         WarpToWindow x y
              Warps the cursor to the associated window.  The parame-
              ters  x  and y default to percentage of window down and
              in from the upper left hand corner (or number of pixels
              down and in if 'p' is appended to the numbers).
    
    
    
         WindowFont [ fontname ]
              Makes fvwm use font fontname  instead  of  "fixed"  for
              window  title-bars.  To  reset this font to the default
              font (see DefaultFont) you may omit fontname.
    
    
    
         WindowId id func
              The WindowId function is similar to the Next  and  Prev
              funcs,  except  that  it looks for a specific window id
              and runs the specified func on it.
    
                   WindowId 0x34567890 Raise
                   WindowId 0x34567890 WarpToWindow 50 50
    
              Mostly this is useful for functions used with the  Win-
              dowList builtin.
    
    
    
         WindowList [ position ] [ options ] [ double-click-action ]
              Generates a pop-up menu (and pops it up) in  which  the
              title  and geometry of each of the windows currently on
              the desk top are shown.  The geometry of iconified win-
              dows  is  shown in parenthesis.  Selecting an item from
              the window list pop-up menu will by default  cause  the
              interpreted  function WindowListFunc to be run with the
              window id of that window passed in as $0.   By  default
              the WindowListFunc looks like this:
    
                   AddToFunc WindowListFunc
                    + "I" WindowId $0 Iconify -1
                    + "I" WindowId $0 FlipFocus
                    + "I" WindowId $0 Raise
                    + "I" WindowId $0 WarpToWindow 5p 5p
    
              You can Destroy the builtin WindowListFunc  and  create
              your own if these defaults do not suit you.
    
              The position arguments are the same as  for  Menu.  The
              command double-click-action will be invoked if the user
              double-clicks (or hits the key  rapidly  twice  if  the
              menu  is bound to a key) when bringing the window list.
              The double-click-action must be quoted if  it  consists
              of more than one word.
    
              The double-click-action is useful to define  a  default
              window  if  you have bound the window list to a key (or
              button) like this:
    
                   Key Tab A M WindowList "Prev FlipFocus"
    
              Hitting Alt-Tab once it brings up the window  list,  if
              you  hit  it  twice  the  focus  is flipped between the
              current and the last focused window.
    
              The options passed to WindowList can  be  "NoGeometry",
              "Function <funcname>", "Desk <desknum>", "CurrentDesk",
              "NoIcons", "Icons", "OnlyIcons", "NoNormal",  "Normal",
              "OnlyNormal",   "NoSticky",   "Sticky",   "OnlySticky",
              "NoOnTop",    "OnTop",    "OnlyOnTop",    "NoDeskSort",
              "UseIconName", "Alphabetic", "NotAlphabetic".
              (Note - normal means not iconic, sticky, or ontop)
    
              If you pass in a function via "Function <funcname>", $0
              is the window id:
    
                   AddToFunc IFunc "I" WindowId $0 Iconify
                   WindowList Function IFunc, NoSticky, \
                     CurrentDesk, NoIcons
    
    
              If you wanted to use the WindowList as an icon manager,
              you could invoke the following:
    
                   WindowList OnlyIcons, Sticky, OnTop, Geometry
    
              (Note - the "Only" options  essentially  wipe  out  all
              other ones...)
    
    
    
         WindowsDesk arg1 [ arg2 ]
              Moves  the   selected   window   to   another   desktop
              (workspace, room).
    
              This command has been removed and must be  replaced  by
              MoveToDesk, the arguments for which are the same as for
              the Desk command.  Note: You cannot simply  change  the
              name  of  the  command:  the syntax has changed. If you
              used "WindowsDesk n" to move a window to  desk  n,  you
              will have to change it to "MoveToDesk 0 n".
    
    
    
         WindowShade [ opt ]
              Toggles the window shade feature  for  titled  windows.
              Windows  in  the shaded state only display a title bar.
              If opt is not given, the window shade state is toggled.
              If  opt is 1, the window is forced to the shaded state.
              If opt is 2, then the window  is  forced  to  the  non-
              shaded  state.   Maximized  windows and windows without
              titles cannot be shaded.
    
    
    
         XORvalue number
              Changes the value with which bits are XOR'ed when doing
              rubber-band  window  moving  or resizing.  Setting this
              value is a trial-and-error process.
    
    
    
         +    Used to continue adding to the  last  specified  decor,
              function  or  menu.  See the discussion for AddToDecor,
              AddToFunc, and AddToMenu.
    
    
    
    KEYBOARD SHORTCUTS
         All (I think) window manager  operations  can  be  performed
         from the keyboard so mouseless operation should be possible.
         In addition to scrolling around the virtual desktop by bind-
         ing  the Scroll built-in to appropriate keys, pop-ups, move,
         resize, and most other built-ins can be bound to keys.  Once
         a built-in function is started the pointer is moved by using
         the up, down, left, and right arrows, and the action is ter-
         minated by pressing return.  Holding down the shift key will
         cause the pointer movement to go in larger steps and holding
         down the control key will cause the cursor movement to go in
         smaller steps.  Standard emacs and vi cursor  movement  con-
         trols  (^n,  ^p,  ^f,  ^b,  and  ^j, ^k, ^h, ^l) can be used
         instead of the arrow keys.
    
    
    
    SUPPLIED CONFIGURATION
         A sample configuration file, .fvwm2rc, is supplied with  the
         fvwm  distribution.  It is well commented and can be used as
         a source of examples for fvwm configuration.
    
    
    
    USE ON MULTI-SCREEN DISPLAYS
         If the -s command line argument  is  not  given,  fvwm  will
         automatically  start  up  on  every  screen on the specified
         display.  After fvwm starts each screen is treated  indepen-
         dently.  Restarts of fvwm need to be performed separately on
         each screen.  The use of EdgeScroll 0 0 is  strongly  recom-
         mended for multi-screen displays.
    
         You may need to quit on each screen to quit from the X  ses-
         sion completely.
    
    
    
    ENVIRONMENT
         DISPLAY
              Fvwm starts on this display unless the -display  option
              is given.
    
         FVWM_MODULEDIR
              Set by fvwm to the directory  containing  the  standard
              fvwm modules.
    
    BUGS
         As of fvwm 2.2 there were exactly 46.144 unidentified  bugs.
         Identified  bugs have mostly been fixed, though.  Since then
         12.25 bugs have been fixed.   Assuming  that  there  are  at
         least  10  unidentified  bugs for every identified one, that
         leaves us with 46.144 - 12.25 + 10 * 12.25 = 156.395 uniden-
         tified bugs.  If we follow this to its logical conclusion we
         will have an infinite number of unidentified bugs before the
         number  of  bugs  can  start to diminish, at which point the
         program will be bug-free.  Since this is a computer  program
         infinity  =  3.4028e+38  if  you  don't  insist  on  double-
         precision.  At the current rate of bug discovery  we  should
         expect  to  achieve this point in 4.27e+27 years.  I guess I
         better plan on passing this thing on to my children....
    
         Known bugs can be found in the BUGS file  in  the  distribu-
         tion,  in  the fvwm bug tracking system (accessible from the
         fvwm home page) and in the TO-DO list.
    
         Bug reports can be sent to the FVWM  workers'  mailing  list
         (see the FAQ).
    
    
    AUTHOR
         Robert Nation with help from many people, based on twm code,
         which  was  written  by  Tom LaStrange.  After Robert Nation
         came Charles Hines, followed by Brady Montz. Currently  fvwm
         is  maintained  by  a  number  of people on the fvwm-workers
         mailing list (Dan Espen, Steve Robbins,  Paul  Smith,  Jason
         Tibbitts, Dominik Vogt, Bob Woodside and others).
    
    
    
    


    Поиск по тексту MAN-ов: 




    Спонсоры:
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2021 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру