  WindowMaker 0.14.0 Configuration Information
  Scott James Remnant scottjr@netsplit.demon.co.uk
  1st March 1998

  Detailed information of the WWiinnddoowwMMaakkeerr configuration files and the
  GNUstep directory.
  ______________________________________________________________________

  Table of Contents:

  1.      Introduction

  1.1.    Installing the default Configuration files

  1.2.    Invoking WindowMaker

  2.      Directory Structure

  3.      The Defaults directory

  3.1.    Property List File Format

  3.1.1.  Examples

  3.2.    Value Types

  3.2.1.  Texture

  3.2.2.  Color

  3.2.3.  Bool

  3.2.4.  Int

  3.2.5.  ModMask

  3.2.6.  FocusMode

  3.2.7.  PathList

  3.2.8.  Placement

  3.2.9.  GeomDisp

  3.2.10. Just

  3.2.11. Font

  3.2.12. Keybind

  3.2.13. Path

  3.3.    The WindowMaker file

  3.3.1.  NoDithering

  3.3.2.  ColormapSize

  3.3.3.  IconSize

  3.3.4.  ModifierKey

  3.3.5.  LeftHanded

  3.3.6.  FocusMode

  3.3.7.  PixmapPath

  3.3.8.  ColormapMode

  3.3.9.  AutoFocus

  3.3.10. RaiseDelay

  3.3.11. CirculateRaise

  3.3.12. FiendMaxIcons

  3.3.13. NextMenuBehaviour

  3.3.14. ScrollableMenus

  3.3.15. AlignSubmenus

  3.3.16. OnTopTransients

  3.3.17. WindowPlacement

  3.3.18. IgnoreFocusClick

  3.3.19. UseSaveUnders

  3.3.20. OpaqueMove

  3.3.21. NoAnimations

  3.3.22. NoAutoWrap

  3.3.23. NoWindowUnderDock

  3.3.24. ConstrainWindowSize

  3.3.25. HorizontalResizeThreshold

  3.3.26. ResizeDisplay

  3.3.27. MoveDisplay

  3.3.28. WidgetColor

  3.3.29. WorkspaceBack

  3.3.30. IconBack

  3.3.31. TitleJustify

  3.3.32. WindowTitleFont

  3.3.33. MenuTitleFont

  3.3.34. MenuTextFont

  3.3.35. IconTitleFont

  3.3.36. FiendTitleFont

  3.3.37. DisplayFont

  3.3.38. HighlightColor

  3.3.39. HighlightTextColor

  3.3.40. FiendTextColor

  3.3.41. CFiendTextColor

  3.3.42. AFiendColor

  3.3.43. IFiendColor

  3.3.44. FTitleColor

  3.3.45. PTitleColor

  3.3.46. UTitleColor

  3.3.47. FTitleBack

  3.3.48. PTitleBack

  3.3.49. UTitleBack

  3.3.50. MenuTitleColor

  3.3.51. MenuTextColor

  3.3.52. MenuDisabledColor

  3.3.53. MenuTitleBack

  3.3.54. MenuTextBack

  3.3.55. RootMenuKey

  3.3.56. WindowListKey

  3.3.57. WindowMenuKey

  3.3.58. MiniaturizeKey

  3.3.59. HideKey

  3.3.60. CloseKey

  3.3.61. MaximizeKey

  3.3.62. VMaximizeKey

  3.3.63. SelectKey

  3.3.64. RaiseKey

  3.3.65. LowerKey

  3.3.66. RaiseLowerKey

  3.3.67. ShadeKey

  3.3.68. FocusNextKey

  3.3.69. FocusPrevKey

  3.3.70. NextWorkspaceKey

  3.3.71. PrevWorkspaceKey

  3.3.72. NextWorkspaceLayerKey

  3.3.73. PrevWorkspaceLayerKey

  3.3.74. Workspace1Key

  3.3.75. Workspace2Key

  3.3.76. Workspace3Key

  3.3.77. Workspace4Key

  3.3.78. Workspace5Key

  3.3.79. Workspace6Key

  3.3.80. Workspace7Key

  3.3.81. Workspace8Key

  3.3.82. Workspace9Key

  3.3.83. Workspace10Key

  3.4.    The WMWindowAttributes file

  3.4.1.  NoTitlebar

  3.4.2.  NoResizeBar

  3.4.3.  NoMiniaturizable

  3.4.4.  NoClosable

  3.4.5.  NoHideOthers

  3.4.6.  NoMouseBindings

  3.4.7.  NoKeyBindings

  3.4.8.  NoAppIcon

  3.4.9.  KeepOnTop

  3.4.10. Omnipresent

  3.4.11. SkipWindowList

  3.4.12. DontMoveOff

  3.4.13. Unfocusable

  3.4.14. AlwaysUserIcon

  3.4.15. StartWorkspace

  3.4.16. Icon

  3.4.17. IconData

  3.4.18. IconLabel

  3.5.    The WMRootMenu file

  3.6.    The WMState file

  4.      The Library/WindowMaker directory
  ______________________________________________________________________
  11..  IInnttrroodduuccttiioonn

  This is a fairly lame (but getting better :) attempt at documenting
  all the WWiinnddoowwMMaakkeerr configuration files and pretty well the entire
  GNUstep directory.

  11..11..  IInnssttaalllliinngg tthhee ddeeffaauulltt CCoonnffiigguurraattiioonn ffiilleess

  If you haven't used WWiinnddoowwMMaakkeerr before (but its installed on the
  system) then you will need to run a program to get the configuration
  files in your directory.

  Login and type:

       % wmaker.inst

  this will create the necessary files and directories

  11..22..  IInnvvookkiinngg WWiinnddoowwMMaakkeerr

  Normally after you run wmaker.inst your .xinitrc file will have been
  modified to cause WWiinnddoowwMMaakkeerr to load when you start X or login to an
  XDM. However WWiinnddoowwMMaakkeerr also has a couple of command line options you
  may wish to take advantage of.

     --nnooccpppp
        This prevents WWiinnddoowwMMaakkeerr from using the external program cpp to
        preprocess the configuration files. Turning this off will
        prevent use of #define, #if etc in your configuration files.

     --nnooddoocckk
        This turns off the dock only (not the fiend) so you will have no
        dock visible when running WWiinnddoowwMMaakkeerr

     --nnooffiieenndd
        This turns off the fiend only (not the dock) so you will have no
        fiend visible when running WWiinnddoowwMMaakkeerr

  22..  DDiirreeccttoorryy SSttrruuccttuurree

  The WWiinnddoowwMMaakkeerr configuration files are contained in a directory
  called GNUstep in your home directory. If you can't find this
  directory then you will need to run the wmaker.inst program. See
  section for more.

  Under the GNUstep directory you will find two further directories,
  Defaults and Library

     GGNNUUsstteepp//DDeeffaauullttss
        This directory contains the configuration files that tell
        WWiinnddoowwMMaakkeerr how to behave and how to treat things like Windows,
        Menus and the Dock etc

     GGNNUUsstteepp//LLiibbrraarryy
        The Library directory is where other GGNNUUsstteepp programs will store
        configuration information. By default it has a single directory
        under it called WindowMaker
     GGNNUUsstteepp//LLiibbrraarryy//WWiinnddoowwMMaakkeerr
        This directory contains the more variable aspects of the
        WWiinnddoowwMMaakkeerr configuration such as the menus, a file of common
        macros, a script to be run on startup, scripts containing saved
        workspaces and more. This is also the ideal place to put themes
        and custom pixmaps etc.

  33..  TThhee DDeeffaauullttss ddiirreeccttoorryy

  The files in this directory are read by WWiinnddoowwMMaakkeerr on startup and
  some of them whenever changed. Most of them share the same format
  which is described in detail below.

  33..11..  PPrrooppeerrttyy LLiisstt FFiillee FFoorrmmaatt

  All of the files in the Defaults directory except for WMRootMenu share
  the same file format which AAllffrreedd KKoojjiimmaa calls a PPrrooppeerrttyy lliisstt.  There
  are four basic constructs to this file format which I have described
  below.

     ddiiccttiioonnaarryy
        A dictionary begins with a '{' and ends with a '}' and may
        contain any number of keys.

     aarrrraayy
        An array begins with a '(' and ends with a ')' and may contain
        any number of strings, arrays or dictionaries.

     kkeeyy
        A key is a string followed by an '=' followed by either a
        string, an array or a dictionary and ended by a ';'. Exactly
        what follows the reference to all current keys and their values
        is given for each file.

     ssttrriinngg
        A string is a sequence of characters enclosed in quotes '"'. If
        the sequence does not include non-alphanumeric characters such
        as ' ', ',' or '*' may have the quotes ommitted.

  All of the files must contain at least one dictionary. The values of
  several keys will often have the same format. For example all texture
  descriptions have the same format array. These _t_y_p_e_s are described in
  detail below.

  33..11..11..  EExxaammpplleess

  Some Examples of the file format are given below. These are pretty
  fictional and shouldn't be used as a reference to any particular file,
  just the format.

  ______________________________________________________________________
  {
      "*" = {
          Icon = "defaultAppicon.xpm";
      };
      "xterm.XTerm" = {
          Icon = "xterm.xpm";
      };
      xconsole = {
          Omnipresent = YES;
          NoTitlebar = YES;
          KeepOnTop = NO;
      };
  }
  ______________________________________________________________________

  The property list above is a dictionary with 3 dictionaries inside.
  The first key is '*', the second is 'xterm.XTerm' and the third is
  'xconsole'. Each of the 3 "sub-dictionaries" contains keys as well.

       ______________________________________________________________________
       {
           FTitleBack = ( hgradient, gray, "#112233" );
       }
       ______________________________________________________________________

  The property list above is a dictionary with a single key inside which
  is called 'FTitleBack'. The value of this key is an array with three
  strings inside. This array corresponds to a type called a Texture. So
  instead of describing the array in the file reference it would simply
  be called a 'Texture'.

  33..22..  VVaalluuee TTyyppeess

  As previously mentioned many of the keys in the files have the same
  format and the same meaning. These types are detailed below.

  33..22..11..  TTeexxttuurree

  A texture specifies what something should look like. It can be a
  color, a gradient or even a pixmap. It is usually used for things like
  Icon Backgrounds and the Root Window.

  Format is an array, the first element of which specifies what type of
  texture is required, the rest describing it more thoroughly.

  The options are:

     ssoolliidd
        FFoorrmmaatt:: ( solid, <color> )

        DDeessccrriippttiioonn:: A simple solid color. What could be nicer?

     hhggrraaddiieenntt
        FFoorrmmaatt:: ( hgradient, <color>, <color> )

        DDeessccrriippttiioonn:: A horizontal gradient going from left to right,
        from the first color to the second color.

     vvggrraaddiieenntt
        FFoorrmmaatt:: ( vgradient, <color>, <color> )

        DDeessccrriippttiioonn:: A vertical gradient going from top to bottom, from
        the first color to the second color.

     ddggrraaddiieenntt
        FFoorrmmaatt:: ( dgradient, <color>, <color> )

        DDeessccrriippttiioonn:: A diagonal gradient going from the top-left corner
        to the bottom-right corner, from the first color to the second
        color.

     mmhhggrraaddiieenntt
        FFoorrmmaatt:: ( mhgradient, <color>, <color>... )

        DDeessccrriippttiioonn:: A horizontal gradient going from left to right. The
        first color is a color to use when a gradient can't be drawn
        (like miniwindows), the rest are used in the gradient sequence.

     mmvvggrraaddiieenntt
        FFoorrmmaatt:: ( mvgradient, <color>, <color>... )

        DDeessccrriippttiioonn:: A vertical gradient going from top to bottom. The
        first color is a color to use when a gradient can't be drawn
        (like miniwindows), the rest are used in the gradient sequence.

     mmddggrraaddiieenntt
        FFoorrmmaatt:: ( mdgradient, <color>, <color>... )

        DDeessccrriippttiioonn:: A diagonal gradient going from the top-left corner
        to the bottom-right corner The first color is a color to use
        when a gradient can't be drawn (like miniwindows), the rest are
        used in the gradient sequence.

     ttppiixxmmaapp
        FFoorrmmaatt:: ( tpixmap, <path>, <color> )

        DDeessccrriippttiioonn:: Not implemented yet... Will probably tile a pixmap
        I guess

     ssppiixxmmaapp
        FFoorrmmaatt:: ( spixmap, <path>, <color> )

        DDeessccrriippttiioonn:: Scale a pixmap to the required size. The path
        option is the filename of the pixmap to scale (relative to the
        PixmapPath option in the WindowMaker file or an absolute path.
        The color is currently not used but must be specified - it is
        probably going to mean the 'transparent' color of that pixmap.

     ccoommppoossee
        FFoorrmmaatt:: ( compose, <texture>, <texture>, <opacity> )

        DDeessccrriippttiioonn:: Not implemented yet... I'm rather hopeing this will
        allow mixing of textures (like a Pixmap with a gradient) or some
        such idea.

  For more information on the path and color types see their appropriate
  sections.
  EExxaammpplleess:

       ______________________________________________________________________
       IconBack = ( solid, Blue );
       IconBack = ( dgradient, gray, "#616161" );
       ______________________________________________________________________

  33..22..22..  CCoolloorr

  Either a standard X11 color (see /usr/X11R6/lib/X11/rgb.txt) or an
  HTML-style color like #FFAA77 (first 2 = red, second 2 = green, third
  2 = blue).

  EExxaammpplleess:

       ______________________________________________________________________
       FTitleColor = White;
       FTitleColor = "#616161";
       ______________________________________________________________________

  33..22..33..  BBooooll

  Normal logical variable, anything one of 'Y'/'T'/'1'/'YES'/'TRUE' for
  the option being on, and 'N'/'F'/'0'/'NO'/'FALSE' for the option being
  off.

  EExxaammpplleess:

       ______________________________________________________________________
       OpaqueMove = YES;
       OpaqueMove = NO;
       ______________________________________________________________________

  33..22..44..  IInntt

  A whole number. Maximum valid range of -32,768 to 32,767, range for an
  option may vary.

  EExxaammpplleess:

       ______________________________________________________________________
       IconSize = 2;
       ______________________________________________________________________

  33..22..55..  MMooddMMaasskk

  A modifier key for doing a task. You may find reading xkeycaps(1)
  useful.  I would explain this better but my computer doesn't seem to
  have that manpage.

  EExxaammpplleess:

       ______________________________________________________________________
       ModifierKey = "Mod1";
       ______________________________________________________________________

  33..22..66..  FFooccuussMMooddee

  These options specify how windows should be focused or how mouse
  movements or clicks should affect focuses.

  The options are:

     MMaannuuaall oorr CClliicckkttooFFooccuuss
        You have to click on the window to focus it

     AAuuttoo oorr FFooccuussFFoolllloowwssMMoouussee
        The window currently being pointed to has focus. If you point at
        the Workspace then no window has focus.

     SSeemmiiAAuuttoo oorr SSllooppppyy
        As above but when the Workspace is pointed to the window doesn't
        loose focus

  EExxaammpplleess:

       ______________________________________________________________________
       FocusMode = Manual;
       FocusMode = Sloppy;
       ______________________________________________________________________

  33..22..77..  PPaatthhLLiisstt

  An array of paths. What the paths are relative to depends precisely on
  the key. Absolute paths are usually allowed.

  EExxaammpplleess:

       ______________________________________________________________________
       PixmapPath = ( "~/pixmaps", "~/.GNUstep/Library/WindowMaker/Pixmaps" );
       ______________________________________________________________________

  33..22..88..  PPllaacceemmeenntt

  Specifies how new windows should be placed.

  The options are:

     AAuuttoo oorr SSmmaarrtt
        Puts the new window in the best free space

     CCaassccaaddee
        Normal cascading effect

     MMaannuuaall
        When the window is created you are given an outline, you have to
        choose where you want the window and then click to place it.

     RRaannddoomm
        Puts it a random place

  EExxaammpplleess:

       ______________________________________________________________________
       WindowPlacement = Cascade;
       WindowPlacement = Smart;
       ______________________________________________________________________

  33..22..99..  GGeeoommDDiisspp

  Specifies how the (annoying) geometry display box appears

  The options are:

     CCeenntteerr
        Geometry display box appears in the screen center

     CCoorrnneerr
        Geometry display box appears in the top left

     FFllooaattiinngg
        Geometry display box keeps with the window

     LLiinnee
        No geometry display box but some cool lines around the egde (not
        for Move though)

  EExxaammpplleess:

       ______________________________________________________________________
       ResizeDisplay = Line;
       ResizeDisplay = Floating;
       ______________________________________________________________________

  33..22..1100..  JJuusstt

  Specifies how text should be justified.

  The options are:

     LLeefftt
        Left Alignment of text

     RRiigghhtt
        Rigth alignment of text

     CCeenntteerr
        Centered text

  EExxaammpplleess:

       ______________________________________________________________________
       TitleJustify = Right;
       TitleJustify = Center;
       ______________________________________________________________________

  33..22..1111..  FFoonntt

  Standard X font specification enclosed in quotes. To work out one of
  these use the handy xxffoonnttsseell utility.

  EExxaammpplleess:

       ______________________________________________________________________
       WindowTitleFont = "-*-helvetica-bold-r-normal-*-12-*-*-*-*-*-*-*";
       IconTitleFont = "-*-helvetica-medium-r-normal-*-8-*-*-*-*-*-*-*";
       ______________________________________________________________________

  33..22..1122..  KKeeyybbiinndd

  A key binding - in the style of how you would describe keys. Use
  'Meta' instead of 'Alt' or whatever meta key you specified in the
  ModifierKey option. To combine keys use the '+' character. 'None' may
  be used if you don't want a key binding.

  EExxaammpplleess:

       ______________________________________________________________________
       RootMenuKey = "F12";
       CloseKey = "Meta+F4";
       RaiseKey = "Meta+Up";
       HideKey = "Control+Shift+H";
       ShadeKey = None;
       ______________________________________________________________________

  33..22..1133..  PPaatthh

  A path to something. May be relative to a location (depends on the
  value) and may usally be an absolute path too.
  EExxaammpplleess:

       ______________________________________________________________________
       Icon = "~/GNUstep/Library/WindowMaker/iconback.xpm";
       ______________________________________________________________________

  33..33..  TThhee WWiinnddoowwMMaakkeerr ffiillee

  This file contains options that tell WindowMaker how to display itself
  and how to act.

  All of the options are read on startup and most are read when the file
  is changed. Those options which are not re-read are called _s_t_a_t_i_c
  options and those that are are called _d_y_n_a_m_i_c options.

  Each option is described below.

  33..33..11..  NNooDDiitthheerriinngg

     IInnffoorrmmaattiioonn
        TTyyppee:: Static

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If true then gradients and pixmaps etc are not dithered in low
        color mode

  33..33..22..  CCoolloorrmmaappSSiizzee

     IInnffoorrmmaattiioonn
        TTyyppee:: Static

        FFoorrmmaatt:: Int (>= 1)

        DDeeffaauulltt:: 4

     DDeessccrriippttiioonn
        Size of dithering colormap in colors per channel

  33..33..33..  IIccoonnSSiizzee

     IInnffoorrmmaattiioonn
        TTyyppee:: Static

        FFoorrmmaatt:: Int (>= 4)

        DDeeffaauulltt:: 64
     DDeessccrriippttiioonn
        Size of icons (both width and height I guess)

  33..33..44..  MMooddiiffiieerrKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Static

        FFoorrmmaatt:: ModMask

        DDeeffaauulltt:: Mod1

     DDeessccrriippttiioonn
        The key to use as the "Meta" key

  33..33..55..  LLeeffttHHaannddeedd

     IInnffoorrmmaattiioonn
        TTyyppee:: Static

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If true then the left and right mouse buttons are swapped around

  33..33..66..  FFooccuussMMooddee

     IInnffoorrmmaattiioonn
        TTyyppee:: Static

        FFoorrmmaatt:: FocusMode

        DDeeffaauulltt:: manual

     DDeessccrriippttiioonn
        The Mode to use to Focus Windows

  33..33..77..  PPiixxmmaappPPaatthh

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: PathList

        DDeeffaauulltt:: contents of #define DEF_PIXMAP_PATHS

     DDeessccrriippttiioonn
        Whenever WindowMaker is given a relative path to find a pixmap
        in, it searches each of these paths in order for that pixmap.

  33..33..88..  CCoolloorrmmaappMMooddee

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: FocusMode

        DDeeffaauulltt:: auto

     DDeessccrriippttiioonn
        On lower color displays not all colors may be available to
        applications as they want them. Normally the most colors are
        given to the application that has the focus. This option
        specifies what technique to use to decide which application has
        the most colors.

  33..33..99..  AAuuttooFFooccuuss

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: YES

     DDeessccrriippttiioonn
        If TRUE then a window is automatically given focus when it is
        mapped.

  33..33..1100..  RRaaiisseeDDeellaayy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Int (>=0)

        DDeeffaauulltt:: 0

     DDeessccrriippttiioonn
        The delay in milliseconds before a newly focused window is
        raised. 0 disables this feature

  33..33..1111..  CCiirrccuullaatteeRRaaiissee

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then windows are raised as you cycle through them (ie
        with Alt+Tab)

  33..33..1122..  FFiieennddMMaaxxIIccoonnss

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Int

        DDeeffaauulltt:: 25

     DDeessccrriippttiioonn
        The maximum number of icons that the fiend can hold at any one
        time. Probably per workspace.

  33..33..1133..  NNeexxttMMeennuuBBeehhaavviioouurr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: YES

     DDeessccrriippttiioonn
        When TRUE menus are opened in the NeXT way; ie the menu appears
        with the center of its titlebar where the mouse pointer is. This
        can mean the menu goes off the side of the screen. When FALSE
        the menu is mapped so all of the menu is on the screen. Often
        used in conjuction with the ScrollingMenus option to get a neat
        menu effect :)

  33..33..1144..  SSccrroollllaabblleeMMeennuuss

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: YES

     DDeessccrriippttiioonn
        If part of a menu goes off screen and this option is TRUE then
        the menu is scrolled back onto the screen as your move your
        mouse pointer towards the edge of the screen. When the pointer
        leaves the menu then it goes back to its original position. Neat
        I think :)

  33..33..1155..  AAlliiggnnSSuubbmmeennuuss

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the titlebar of a submenu is at exactly the same
        height as the titlebar of its parent when opened. When FALSE the
        titlebar of the submenu is in such a position that the first
        submenu option is at the same height as the submenu item on the
        main menu.

  33..33..1166..  OOnnTTooppTTrraannssiieennttss

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: YES

     DDeessccrriippttiioonn
        If TRUE then transient windows are kept on top of their owners

  33..33..1177..  WWiinnddoowwPPllaacceemmeenntt

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Placement

        DDeeffaauulltt:: cascade

     DDeessccrriippttiioonn
        Specifies how newly mapped windows should be placed.

  33..33..1188..  IIggnnoorreeFFooccuussCClliicckk

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the mouse click that causes a window to focus is
        not passed onto the application.
  33..33..1199..  UUsseeSSaavveeUUnnddeerrss

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        When TRUE SaveUnders for menus and icons etc are turned on. I
        believe this makes it slow, but is better for less memory or
        something? (not sure)

  33..33..2200..  OOppaaqquueeMMoovvee

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        When TRUE window contents are shown as they are moved.

  33..33..2211..  NNooAAnniimmaattiioonnss

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        When TRUE animations such as the minimize animation, shade
        animation and the "remove icon from dock" animation are
        disabled.

  33..33..2222..  NNooAAuuttooWWrraapp

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        When TRUE then something to do with autowrapping is disabled.
        (explanation to me required! :)
  33..33..2233..  NNooWWiinnddoowwUUnnddeerrDDoocckk

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then windows are prevented from getting themselves under
        the dock

  33..33..2244..  CCoonnssttrraaiinnWWiinnddoowwSSiizzee

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then windows are prevented from getting bigger than the
        screen

  33..33..2255..  HHoorriizzoonnttaallRReessiizzeeTThhrreesshhoolldd

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Int

        DDeeffaauulltt:: 0

     DDeessccrriippttiioonn
        Number of pixels from corner of window where the corner-box can
        resize in any-direction rather than just horizontally. If this
        is set to 0 (the default) then this behaviour is disabled and to
        resize horizontally just drag horizontally (the drag will lock
        to horizontal resize only).

  33..33..2266..  RReessiizzeeDDiissppllaayy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: GeomDisp

        DDeeffaauulltt:: corner

     DDeessccrriippttiioonn
        Specifies how to display the geometry box when resizing the
        window
  33..33..2277..  MMoovveeDDiissppllaayy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: GeomDisp

        DDeeffaauulltt:: corner

     DDeessccrriippttiioonn
        Specifies now to display the geometry box when moving the
        window. Note: the Line option seems to have no effect.

  33..33..2288..  WWiiddggeettCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Texture

        DDeeffaauulltt:: ( solid, gray )

     DDeessccrriippttiioonn
        The style of the little icons in the corners of the windows.

  33..33..2299..  WWoorrkkssppaacceeBBaacckk

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Texture

        DDeeffaauulltt:: ()

     DDeessccrriippttiioonn
        The style of the root window

  33..33..3300..  IIccoonnBBaacckk

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Texture

        DDeeffaauulltt:: ( solid, gray )

     DDeessccrriippttiioonn
        The style of the icon backgrounds on the dock and along the
        bottom of the screen

  33..33..3311..  TTiittlleeJJuussttiiffyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Just

        DDeeffaauulltt:: center

     DDeessccrriippttiioonn
        Justification of text in the window title bars

  33..33..3322..  WWiinnddoowwTTiittlleeFFoonntt

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Font

        DDeeffaauulltt:: contents of #define DEF_TITLE_FONT

     DDeessccrriippttiioonn
        The font to use for Window Titles

  33..33..3333..  MMeennuuTTiittlleeFFoonntt

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Font

        DDeeffaauulltt:: contents of #define DEF_MENU_TITLE_FONT

     DDeessccrriippttiioonn
        The font to use for Menu Window Titles

  33..33..3344..  MMeennuuTTeexxttFFoonntt

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Font

        DDeeffaauulltt:: contents of #define DEF_MENU_ENTRY_FONT

     DDeessccrriippttiioonn
        The font to use for Menu item text

  33..33..3355..  IIccoonnTTiittlleeFFoonntt

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Font

        DDeeffaauulltt:: contents #define DEF_ICON_TITLE_FONT

     DDeessccrriippttiioonn
        The font to use for the Icon Title

  33..33..3366..  FFiieennddTTiittlleeFFoonntt

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Font

        DDeeffaauulltt:: contents #define DEF_FIEND_TITLE_FONT

     DDeessccrriippttiioonn
        The font to use for the workspace name and number in the fiend's
        main icon

  33..33..3377..  DDiissppllaayyFFoonntt

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Font

        DDeeffaauulltt:: contents of #define DEF_INFO_TEXT_FONT

     DDeessccrriippttiioonn
        The font to use for text in things like WindowMaker dialogs etc.

  33..33..3388..  HHiigghhlliigghhttCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: white

     DDeessccrriippttiioonn
        The background color of a menu highlight

  33..33..3399..  HHiigghhlliigghhttTTeexxttCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: black

     DDeessccrriippttiioonn
        The color of the text on a menu highlight

  33..33..4400..  FFiieennddTTeexxttCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: black

     DDeessccrriippttiioonn
        The color of the workspace name and number on the fiend's main
        icon

  33..33..4411..  CCFFiieennddTTeexxttCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: "#616161"

     DDeessccrriippttiioonn
        The color the workspace name and number on the fiend's main icon
        when the fiend is collapsed

  33..33..4422..  AAFFiieennddCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: contents of #define DEF_FIEND_ACTIVE

     DDeessccrriippttiioonn
        The color the fiend workspace icon/buttons when they are active.

  33..33..4433..  IIFFiieennddCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: contents of #define DEF_FIEND_INACTIVE

     DDeessccrriippttiioonn
        The color the fiend workspace icon/buttons when they are
        inactive.

  33..33..4444..  FFTTiittlleeCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: white

     DDeessccrriippttiioonn
        The color of the text on a focused window title

  33..33..4455..  PPTTiittlleeCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: white

     DDeessccrriippttiioonn
        The color of the text on the title of the parent of the focused
        window

  33..33..4466..  UUTTiittlleeCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: black

     DDeessccrriippttiioonn
        The color of text on an unfocused window title

  33..33..4477..  FFTTiittlleeBBaacckk

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Texture

        DDeeffaauulltt:: ( solid, black )

     DDeessccrriippttiioonn
        The style of the title bacground of the focused window

  33..33..4488..  PPTTiittlleeBBaacckk

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Texture

        DDeeffaauulltt:: ( solid, "#616161" )

     DDeessccrriippttiioonn
        The style of the title background of the parent of the focused
        window

  33..33..4499..  UUTTiittlleeBBaacckk

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Texture

        DDeeffaauulltt:: ( solid, gray )

     DDeessccrriippttiioonn
        The style of the title background of an unfocused window

  33..33..5500..  MMeennuuTTiittlleeCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: white

     DDeessccrriippttiioonn
        The color of the text on a menu title

  33..33..5511..  MMeennuuTTeexxttCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: black

     DDeessccrriippttiioonn
        The color of the text on a menu item

  33..33..5522..  MMeennuuDDiissaabblleeddCCoolloorr

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Color

        DDeeffaauulltt:: "#616161"

     DDeessccrriippttiioonn
        The color of the text on a disabled menu item

  33..33..5533..  MMeennuuTTiittlleeBBaacckk

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Texture

        DDeeffaauulltt:: ( solid, black )

     DDeessccrriippttiioonn
        The style of the background of a menu title

  33..33..5544..  MMeennuuTTeexxttBBaacckk

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Texture

        DDeeffaauulltt:: ( solid, gray )

     DDeessccrriippttiioonn
        The style of the background of a menu item

  33..33..5555..  RRoooottMMeennuuKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..5566..  WWiinnddoowwLLiissttKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..5577..  WWiinnddoowwMMeennuuKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..5588..  MMiinniiaattuurriizzeeKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..5599..  HHiiddeeKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..6600..  CClloosseeKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..6611..  MMaaxxiimmiizzeeKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..6622..  VVMMaaxxiimmiizzeeKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..6633..  SSeelleeccttKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..6644..  RRaaiisseeKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: "Meta+Up"

  33..33..6655..  LLoowweerrKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: "Meta+Down"

  33..33..6666..  RRaaiisseeLLoowweerrKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..6677..  SShhaaddeeKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..6688..  FFooccuussNNeexxttKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..6699..  FFooccuussPPrreevvKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..7700..  NNeexxttWWoorrkkssppaacceeKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..7711..  PPrreevvWWoorrkkssppaacceeKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..7722..  NNeexxttWWoorrkkssppaacceeLLaayyeerrKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..7733..  PPrreevvWWoorrkkssppaacceeLLaayyeerrKKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..7744..  WWoorrkkssppaaccee11KKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..7755..  WWoorrkkssppaaccee22KKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..7766..  WWoorrkkssppaaccee33KKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..7777..  WWoorrkkssppaaccee44KKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..7788..  WWoorrkkssppaaccee55KKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..7799..  WWoorrkkssppaaccee66KKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..8800..  WWoorrkkssppaaccee77KKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..8811..  WWoorrkkssppaaccee88KKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..8822..  WWoorrkkssppaaccee99KKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..33..8833..  WWoorrkkssppaaccee1100KKeeyy

     IInnffoorrmmaattiioonn
        TTyyppee:: Dynamic

        FFoorrmmaatt:: Keybind

        DDeeffaauulltt:: None

  33..44..  TThhee WWMMWWiinnddoowwAAttttrriibbuutteess ffiillee

  This file contains options that tell WWiinnddoowwMMaakkeerr how to display
  windows and which icons to use for them etc.

  These options are read on startup and when the file is changed.

  The file conists of a dictionary containing a list of keys. Each key
  must either be an X-Window instance, an X-Window class or both
  seperated by a '.'.  An extra key may be included which is an asterisk
  '*' which is the default options for all windows in the file.

  You can get the instance and class name by using the xprop utility on
  the window. If you run it and click on the desired window you will get
  output which should contain a line like:

       ______________________________________________________________________
       WM_CLASS(STRING) = "xterm", "XTerm"
       ______________________________________________________________________

  The instance of this window is 'xterm' and the class is 'XTerm'. You
  may put in the file either 'xterm', 'XTerm' or 'xterm.XTerm'.

  Each of these keys must have as a value a dictionary containing a list
  of valid options. The valid options are described below.

  An example WMWindowAttributes file:

  ______________________________________________________________________
  {
      "*" = {
          Icon = "defaultAppIcon.xpm";
      };
      "xterm.XTerm" = {
          Icon = "NeXTTerm5.xpm";
      };
      xconsole = {
          Omnipresent = YES;
          NoTitlebar = YES;
          KeepOnTop = YES;
      };
      "Logo.WMDock" = {
          Icon = "newstep.xpm";
      };
      "Logo.WMPanel" = {
          Icon = "GNUstep.xpm";
      };
  }
  ______________________________________________________________________

  The 'Logo.WMDock' option corresponds to the icon at the top of the
  dock and the

  33..44..11..  NNooTTiittlleebbaarr

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the titlebar is not drawn for this window.

  33..44..22..  NNooRReessiizzeeBBaarr

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the resize bar (the bar along the bottom) is not
        drawn for this window

  33..44..33..  NNooMMiinniiaattuurriizzaabbllee

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO
     DDeessccrriippttiioonn
        If TRUE then the miniatuize button is not drawn for this window

  33..44..44..  NNooCClloossaabbllee

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the close button is not drawn for this window

  33..44..55..  NNooHHiiddeeOOtthheerrss

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then this window's child windows are not hidden when the
        window is miniaturized

  33..44..66..  NNooMMoouusseeBBiinnddiinnggss

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the window gets to process mouse actions before
        WWiinnddoowwMMaakkeerr does

  33..44..77..  NNooKKeeyyBBiinnddiinnggss

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the window gets to process key actions before
        WWiinnddoowwMMaakkeerr does - useful for XXEEmmaaccss perhaps ? :)

  33..44..88..  NNooAAppppIIccoonn

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then then title-less "application icon" is not displayed
        for this window. This also has the side-effect of keeping the
        '...' on the dock even after this application has been loaded,
        it also prevents you from docking the window.

  33..44..99..  KKeeeeppOOnnTToopp

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the window appears on top of all other windows

  33..44..1100..  OOmmnniipprreesseenntt

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the window appears on all workspaces

  33..44..1111..  SSkkiippWWiinnddoowwLLiisstt

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the window is not present on the Windows menu

  33..44..1122..  DDoonnttMMoovveeOOffff

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO
     DDeessccrriippttiioonn
        If TRUE then perhaps it prevents the focus leaving the window?
        (I'm not sure)

  33..44..1133..  UUnnffooccuussaabbllee

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the window cannot be focused

  33..44..1144..  AAllwwaayyssUUsseerrIIccoonn

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Bool

        DDeeffaauulltt:: NO

     DDeessccrriippttiioonn
        If TRUE then the user-supplied icon (in the Icon option) will be
        used rather than on the window supplies itself. Example is
        Netscape 4 has its own icons for each of its windows. Setting
        this to TRUE would force whatever icon you specified for
        Netscape rather than those icons it supplies.

  33..44..1155..  SSttaarrttWWoorrkkssppaaccee

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Int (>=0)

        DDeeffaauulltt:: 0

     DDeessccrriippttiioonn
        Workspace number to start in, or 0 for the current workspace.

  33..44..1166..  IIccoonn

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: Path

        DDeeffaauulltt:: ""

     DDeessccrriippttiioonn
        Path to an icon (relative to PixmapPath) to use for the
        "application icon" (and window icons too if AlwaysUserIcon is
        set). This can be used to make your desktop look cool - and to
        give applications with no high-color icons an icon.
  33..44..1177..  IIccoonnDDaattaa

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: (unknown)

        DDeeffaauulltt:: (unknown)

     DDeessccrriippttiioonn
        Dunno - I don't think its used yet

  33..44..1188..  IIccoonnLLaabbeell

     IInnffoorrmmaattiioonn
        FFoorrmmaatt:: (unknown)

        DDeeffaauulltt:: (unknown)

     DDeessccrriippttiioonn
        Dunno - I don't think its used yet

  33..55..  TThhee WWMMRRoooottMMeennuu ffiillee

  This file tells WWiinnddoowwMMaakkeerr where to get the root menu from. It
  contains a single string (its not a property-list) which points to the
  path of the menu file. Normally you wouldn't modify it unless you
  wanted to change the language of your menus.

  Example:

       ______________________________________________________________________
       "~/GNUstep/Library/WindowMaker/menu"
       ______________________________________________________________________

  33..66..  TThhee WWMMSSttaattee ffiillee

  This file is saved every time WWiinnddoowwMMaakkeerr exits and is loaded only
  when it starts. As such is not very user-modifiable. It contains
  information on the dock and the workspaces.

  (note: I'm still working out this file)

  It (as usual) contains a dictionary. This dictionary can have two
  keys, 'Dock' and 'Workspaces'. Dock is a dictionary which contains
  three keys, naming each of the workspaces. 'Lowered' is a Bool value,
  'Position' is a string containing a coordinate and 'Applications' is
  an array of dictionaries, each dictionary describing an icon on the
  dock. Whew!

  Right now there is just an example here, I'll do more later when I've
  hacked open the source sufficently to understand it :) TThhiiss eexxaammppllee iiss
  ffrroomm 00..1133 aanndd wwiillll nnoott wwoorrkk uunnddeerr 00..1144

  Example:

  ______________________________________________________________________
  {
      Dock = {
          Applications = (
              {
                  Command = "-";
                  Name = "Logo.WMDock";
                  AutoLaunch = NO;
                  Forced = NO;
              },
              {
                  Command = "asclock -shape";
                  Name = "asclock.ASClock";
                  AutoLaunch = YES;
                  Forced = NO;
              }
          );
          Position = "-64,0";
          Lowered = NO;
      };
      Workspaces = (Default, Spare);
  }
  ______________________________________________________________________

  44..  TThhee LLiibbrraarryy//WWiinnddoowwMMaakkeerr ddiirreeccttoorryy

  The files in this directory are read by WWiinnddoowwMMaakkeerr whenever required.
  Or sometimes not at all. This is the directory where you put things
  like the menu file, files to #include, pixmaps for your background,
  themes etc.

  This will be documented better soon.

  The default directory contains several menu files, the format of the
  menu file will be described here eventually, but for now a quick read
  of the file for your language should help you.

  The 'wmmacros' file contains cpp macros (see info cpp) which are
  included by the 'menu' files for example.

  The 'autostart' script is a shell-script that is executed on startup
  of WWiinnddoowwMMaakkeerr and is the ideal place to start applications you always
  want loaded, or to set the background pixmap etc.

  A file may exist called '.workspace-state' which is a shell script
  written by WWiinnddoowwMMaakkeerr when you choose to save the workspace.

  The other files are either 'spare' files, documentation or included by
  other files. The files in the 'Style' directory are just miniature
  WindowMaker files.

