WMCONFIG (1)
Window Manager Config helper program
SYNOPSIS
[ --flag=flags ] [ --sysdir=system_directory ]
[ --userdir=user_directory ]
[ --outputdir=output_directory ]
[ --no-icons ] [ --no-mini-icons ]
[ --directories ] [ --no-promote ]
[ --newstyle-directories ]
[ --no-sysdir ] [ --no-userdir ]
[ --help ]
[ --version ]
[ file ... ]
DESCRIPTION
wmconfig is a program that will produce output consisting of menu
definitions compatible with the selected window manager. You can include
that output in your .rc file or have the output read through a pipe
for dynamic configurations.
wmconfig will read all the files located in
/etc/X11/wmconfig. It will then read the files
from the .wmconfig directory in the user's home directory. Therefore,
the user's settings will override the system-wide settings from
/etc/X11/wmconfig. If optionally any extra files are given as an
argument on the command line, those will be read last and merged with the others
(possibly overriding the settings in system and user home dir files)
Each of these files have the following format. For example, here's the
gv package:
gv name "Ghostview"
gv icon "ghostview.bmp"
gv mini-icon "mini-gv.xpm"
gv exec "gv &"
gv group "Graphics/Viewers"
The format of the config file is:
<package> <tag string>
denotes the name of the package, and is used internally by
wmconfig to group together multiple tags intended for the
same application. This item does not have any other special meaning.
This can have several possible values. Among them:
This is the name of the application, as it should be displayed in the
menu.
Example: name "My Cute Application"
This is the filename of an icon for this application. Use of full
paths is discouraged because not all window managers can read and
cope with full paths in icon names. Try to put your icons in a
place where your window manager can find them by default.
Example: icon "my-icon.xpm"
Some window managers support mini icons in menus or title bars, etc. This
tag is intended for those kind of window managers (among them, mwm, fvwm2,
fvwm95, icewm). The same remarks from the icon tag apply here. See the
example from icon.
This will result in the configuration (entries) for this application being
completed (by copying) from another application.
Example: copy anotherpackage
This is the command that will be excuted by the window manager when
this menu entry is selected.
Example: exec "xterm -T mailer pine"
This is the group you want to have you application listed under. The
group items are separated by / (that is a forward slash).
Groups are created on the fly, so you do have to be careful with typos!.
Example: group "Applications/Graphics Utilities/Viewers"
The above example will generate code (for the window manager of your
choice) to generate a menu entry named Applications with another menu
entry under it named Graphics Utilities and finaly a menu entry under
that one named Viewers containing your application as an entry.
User config files in $HOME/.wmconfig can have multiple packages
defined in there; order does not matter. The only way to have an app in two
different groups is to use copy to copy another package and override
the group setting.
OPTIONS
Where manager can currently be one of: fvwm2,
fvwm95, mwm, afterstep, icewm, wmaker, kde or debug. The only
entry which is special in this list is the debug entry, which
will produce a nice tree-like output to debug your settings and show
you how the data is represented internally by wmconfig.
Where flags can be one of:
no-icons - this will tell wmconfig not to produce any
icon-related output. You might want to do this if you don't want to have
Icon styles applied to your application in your window manager. For
instance, if you don't want to have iconified windows on the desktop.
no-mini-icons - the same thing, except for mini-icons (currently
only supported by fvwm2, fvwm95 and afterstep).
directories - some window managers are expecting their menu configuration
as a hierarchy of directories/files. This option is working together with
--output setting. Currently it is known to work only when invoked
with --output=afterstep, and it will create the directories/files
in ~/GNUstep/Library/AfterStep/start. This path can be changed using
--outputdir switch.
newstyle-directories - enhanced version of directories. Menu
has mini-icons. Only for AfterStep >= 1.5.
no-promote - Menus that have only one application defined will be
\"destroyed\" and that application promoted to the higher level menu
(yeah, some people find it irritating to have menus with only one app in!).
This flag will turn off this default behavior.
If you want to specify more than one flag at a time, you can either
repeat the --flag switch, or list all the flags comma-separated
with no spacing in between.
Example:
--flag=flag1,flag2,flag3 or
--flag=flag1 --flag=flag2 ...
This switch is used to set the system directory instead of using the
default (which is /etc/X11/wmconfig).
The default value for this switch is .wmconfig. This means that
a directory called $HOME/.wmconfig will be searched for files
containing valid wmconfig entries, and will be read after the system
directory is read. By using --userdir you have a way to change that
value.
By default, the name of the root menu is RootStart. If you want
wmconfig to begin generating entryies starting at a certain point in
your already-existing menu tree, you will want to use this switch.
The default output directory is ~/GNUstep/Library/AfterStep/start.
Using this switch you can tell wmconfig to generate menu tree in specified
path. Works only for --output=afterstep with directories or
newstyle-directories flags.
Does the same thing as --flag=no-icons
Does the same thing as --flag=no-mini-icons
Does the same thing as --flag=directories
Does the same thing as --flag=newstyle-directories
Does the same thing as --flag=no-promote
Do not parse the files from the system-wide settings (/etc/X11/wmconfig) directory.
Do not parse the files from the user's $HOME/.wmconfig directory.
This is the popular "show me the help-screen !" switch.
This is the popular "what version was that ?" switch.
BUGS
Probably the source code of the whole thing is far more useful than
this man page.
The BUGS section of this man page might be inaccurate.
FILES
The default system directory containing wmconfig files
The default user directory containing wmconfig files
AUTHOR
Cristian Gafton <gafton@redhat.com>
Red Hat Software, Inc.
n \{\
ct "
|