
This directory contains an ALPHA (please read that word three times) release
of mwm.  It is based on fvwm, with a new parser that understands mwmrc syntax,
and a general understanding of Mwm resources.  The window manager is freely
redistributable;  see the file COPYING for details.

You should know and understand both mwmrc syntax and Mwm resource
specifications if you want to modify mwm's behavior.

I departed from mwm's specification in that all window decorations have
separate resources; for example, the resize handles by default will show
up in Gold (if you use the Mwm resource file in this directory; if you don't
like this, and want mwm behavior, comment this out).  I'm not sure if Motif
offers this;  I think it does, at least with the title.

If you are familiar with fvwm, you'll notice that modules are missing:
I didn't like the socket ipc mechanism (I think protocols are more appropriate,
especially if you are managing multiple screens).  The virtual screen and the
builtin pager are still there; you can turn off the pager, but not the virtual
screens.  The desktop mechanism is not yet integrated.  If you don't want/don't
like the pager, set the Mwm*usePager resource to False.

Some of the additional flags that fvwm provides are still included, and likely
will not go away.  They are specified by the resource "clientFlags".  These
include:
    "sticky",
    "ontop",
    "circulate_skip",
    "start_iconic",
    "list_skip",
    "suppress_icon",
    "no_icon_title",
"no_icon_title" may go away, as it is also specified in the icon_decorations.
The pager is "sticky" by default:  you'll have to change code if you don't like
this.

To use this version of mwm:
 o - copy the file 'system.mwmrc' to $HOME/.mwmrc (or to
     XLIB_PATH/mwm/system.mwmrc) and make any modifications that you prefer.
 o - Copy Mwm to your app-defaults directory, again making any modifications
     that you prefer (note: not all resources do anything yet, so don't be
     surprised if you request something and it doesn't happen).
 o - If you haven't mapped your Alt keys to a modifier yet, use the provided
     alt.map file.  You can add the line
	xmodmap /usr/X11R6/lib/mwm/alt.map
     to your xinitrc to get this mapping consistently (assuming that you put
     alt.map somewhere logical).  There are other ways to do this; use
     whichever you prefer.  Unlike CSF/M*tif, you can bind any modifier to
     the Alt key in LessTif; so feel free to replace the Mod1 mapping in
     alt.map to whatever you prefer (thanks, Harald, for the clues in VirtKeys).

Things that work:
  o - menus (although the window menu placement is problematic).  If you have
      a menu item that shows up as a separator, don't panic: that function
      hasn't been integrated/implemented, and is parsing as F_NOP -- which
      draws a separator.
  o - button bindings in general.  Specifically, work needs to be done to
      pay attention to up/down/click/click2.
  o - resource specification, in general.  Note that they won't necessarily
      do anything yet, but at least they're parsed.
  o - key bindings mostly work, although the pointer doesn't warp for window
      menus (the behavior is "interesting").
  o - defaults, resource conversion, colors.  The resource converters are
      sort of crude.  If someone has some free time, take a look at
      resources.c: anyplace you see strstr(), the function needs work (hint:
      split the string, then use strcmp()).

Things that don't work:
  o - pointer warping for window menus
  o - font resources aren't paid any attention (yet)
  o - resources need to be added for pager geometry, and desktop behavior.
  o - multiscreen behavior is non-existent.
  o - bugs, bugs, bugs.
  o - everything else I've forgotten:).
  o - some of mwm's implicit button bindings have to be explicitly given.

I want feedback on likes/dislikes/bugs/whatever; send them to
<miers@packet.net> (or lesstif@hungry.com; if it's a bug, use send-pr), and
I'll try to respond.  Especially if mwm doesn't compile or link for you.
