<HTML>
<HEAD><TITLE>Manpage of MWMRC</TITLE>
</HEAD><BODY>
<H1>MWMRC</H1>
Section: LessTif Manuals (5x)<BR>Updated: JULY 2001<BR><A HREF="#index">Index</A>
<BR><A HREF="http://localhost/cgi-bin/man2html">Return to Main Contents</A>
<HR>
<A NAME="lbAB"> </A>
<H2>NAME</H2>
mwmrc - The M*tif Window Manager configuration file
<P>
<A NAME="lbAC"> </A>
<H2>DESCRIPTION</H2>
The LessTif window manager
<B>mwm</B>
supports both a global configuration file
<B>/etc/X11/mwm/system.mwmrc</B>
and a per-user configation file
<B>~/.mwmrc</B>.
<P>
<A NAME="lbAD"> </A>
<H2>STRUCTURE</H2>
Each mwm configuration file consist of blocks of bindings.
Each block consists of a block type keyword, a name and a set of entries
between curly braces (`{' and '}').
<P>
An exclamation mark (`!') introduces a comment. Comments extend to the end
of the line.
<P>
<A NAME="lbAE"> </A>
<H2>Block types</H2>
There are three types of blocks:
<DL COMPACT><DT><DD>
<DL COMPACT>
<DT>Menu bindings<DD>
<DT>Button bindings<DD>
<DT>Key bindings<DD>
</DL></DL>
<P>
<A NAME="lbAF"> </A>
<H2>Menu bindings</H2>
Menu bindings are introduced by the
<B>Menu</B>
keyword.
The generic form of the entries is
<I>label mnemonic accelerator function .</I>
Both
<I>mnemonic </I>
and
<I>accelerator</I>
may be empty.
For example:
<DL COMPACT><DT><DD>
"Foo bar"<TT> </TT>_R<TT> </TT>Alt<Key>F5<TT> </TT>f.restore<BR>
</DL>
<P>
<P>
<A NAME="lbAG"> </A>
<H2>Button bindings</H2>
<P>
Button bindings are introduced by the
<B>Buttons</B>
keyword.
The entries each are
<I>Button name Context Function .</I>
For example:
<DL COMPACT><DT><DD>
<Btn3Down><TT> </TT>icon|frame<TT> </TT>f.post_wmenu<BR>
</DL>
<P>
<A NAME="lbAH"> </A>
<H2>Key bindings</H2>
Key bindings are very similar to button bindings.
The entries each are
<I>Key name Context Function .</I>
For example:
<DL COMPACT><DT><DD>
Alt<Key>Tab<TT> </TT>root|icon|window<TT> </TT>f.next_key<BR>
</DL>
<P>
<A NAME="lbAI"> </A>
<H2>Label</H2>
A label is either a plain string, or a bitmap. Bitmaps are indicated as
"@" followed by the filename.
For example:
<DL COMPACT><DT><DD>
mailer
@fortytwo.bmp
</DL>
<P>
<A NAME="lbAJ"> </A>
<H2>Mnemonic</H2>
A mnemonic is an underscore ("_") followed by a single character.
For example:
<DL COMPACT><DT><DD>
_M
</DL>
<P>
<A NAME="lbAK"> </A>
<H2>Accelerator</H2>
An accelerator is a key name.
<P>
<A NAME="lbAL"> </A>
<H2>Button name</H2>
A button name is
<B>Btn</B>
followed by the number
(<B>1</B>..<B>5</B>)
and an action
(<B>Up</B>, <B>Down</B>, <B>Click</B>, <B>Click2</B>);
for example:
<DL COMPACT><DT><DD>
Btn2Click
</DL>
<P>
<A NAME="lbAM"> </A>
<H2>Context </H2>
A context is a single string consisting of bar (`|') separated object names
(<B>root</B>, <B>icon</B>, <B>menub</B>, <B>minimizeb</B>, <B>maximizeb</B>
, <B>window</B>, <B>title</B>, <B>frame</B>, <B>border</B>);
for example:
<DL COMPACT><DT><DD>
icon|title
</DL>
<P>
<A NAME="lbAN"> </A>
<H2>Function</H2>
A function is a string starting with "f.". The functions are:
<B>f.beep</B>,
<B>f.circle_down</B>,
<B>f.circle_up</B>,
<B>f.desk</B>,
<B>f.exec</B>,
<B>f.focus_color</B>,
<B>f.focus_key</B>,
<B>f.goto_page</B>,
<B>f.kill</B>,
<B>f.lower</B>,
<B>f.maximize</B>,
<B>f.menu</B>,
<B>f.minimize</B>,
<B>f.move</B>,
<B>f.next_cmap</B>,
<B>f.next_key</B>,
<B>f.nop</B>,
<B>f.normalize</B>,
<B>f.normalize_and_raise</B>,
<B>f.pack_icons</B>,
<B>f.pass_keys</B>,
<B>f.post_wmenu</B>,
<B>f.prev_cmap</B>,
<B>f.prev_key</B>,
<B>f.quit_mwm</B>,
<B>f.raise</B>,
<B>f.raise_lower</B>,
<B>f.refresh</B>,
<B>f.refresh_win</B>,
<B>f.resize</B>,
<B>f.restart</B>,
<B>f.restore</B>,
<B>f.restore_and_raise</B>,
<B>f.screen</B>,
<B>f.send_msg</B>,
<B>f.separator</B>,
<B>f.set_behavior</B>,
<B>f.title</B>,
<B>f.toggle_page</B>,
<B>f.window_list</B>.
<P>
<A NAME="lbAO"> </A>
<H2>EXAMPLE</H2>
For a complete example, check out
<B>/etc/X11/mwm/system.mwmrc</B>
or look at the
<B>system.mwmrc</B>
distributed with the LessTif sources.
<P>
<A NAME="lbAP"> </A>
<H2>AUTHORS</H2>
<B>mwm</B>
was written by the LessTif project,
<B><A HREF="http://www.lesstif.org/">http://www.lesstif.org/</A></B>
and others. This manpage was written by Ray Dassen
<I><<A HREF="mailto:jdassen@debian.org">jdassen@debian.org</A>></I>.
<A NAME="lbAQ"> </A>
<H2>SEE ALSO</H2>
<B><A HREF="mwm.html">mwm</A></B>(1x)
<P>
<HR>
<A NAME="index"> </A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
<DT><A HREF="#lbAD">STRUCTURE</A><DD>
<DT><A HREF="#lbAE">Block types</A><DD>
<DT><A HREF="#lbAF">Menu bindings</A><DD>
<DT><A HREF="#lbAG">Button bindings</A><DD>
<DT><A HREF="#lbAH">Key bindings</A><DD>
<DT><A HREF="#lbAI">Label</A><DD>
<DT><A HREF="#lbAJ">Mnemonic</A><DD>
<DT><A HREF="#lbAK">Accelerator</A><DD>
<DT><A HREF="#lbAL">Button name</A><DD>
<DT><A HREF="#lbAM">Context </A><DD>
<DT><A HREF="#lbAN">Function</A><DD>
<DT><A HREF="#lbAO">EXAMPLE</A><DD>
<DT><A HREF="#lbAP">AUTHORS</A><DD>
<DT><A HREF="#lbAQ">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by <EM>man2html</EM>,
using the manual pages.<BR>
</BODY>
</HTML>
