NCDLAUNCHER(1) USER COMMANDS NCDLAUNCHER(1)
NAME
ncdlauncher - application launcher
SYNTAX
ncdlauncher [-display displayname] [-f launcherInitfile | -m
mwmInitfile] [-q ]
DESCRIPTION
The ncdlauncher program is intended to work with ncdwm to
provide the application startup built into most window
managers.
OPTIONS
ncdlauncher accepts the following command line options:
-display displayname
This option specifies which NCD display to use.
-f filename
This option specifies the name of the startup file
to be used. This file must be in .launchrc format.
By default, ncdlauncher will first look in the
user's home directory for the file named .launchrc.
If this doesn't exist, ncdlauncher will then search
for the file named .mwmrc, in the user's home direc-
tory, and finally system.launchrc then system.mwmrc
both in /usr/lib/X11.
-m filename
This option specifies the name of the mwm startup
file to be used. This file must be in .mwmrc for-
mat.
-q This option tells the launcher to be quiet and not
print warning messages
CUSTOMIZATION
ncdlauncher's behavior is controlled by providing an init
file describing button and key bindings. The init file may
either be in .mwmrc format, or may be in the .launchrc for-
mat described below.
ncdlauncher init files contain two types of specifications:
Bindings and Menus. The Bindings section usually comes
first and is used to specify the functions that should be
invoked when keys or pointer buttons are pressed in the root
window. The Menus section specifies any user-defined menus
containing functions to be invoked or commands to be exe-
cuted.
Keywords are case-insensitive. Strings must be surrounded
by double quotes and are case-sensitive. A pound sign (#)
NCDware 3.1 1
NCDLAUNCHER(1) USER COMMANDS NCDLAUNCHER(1)
outside of a string causes the remainder of the line to be
treated as a comment.
BINDINGS
Key and pointer button specifications must give the modif-
iers that must be pressed and the function to be invoked.
Keys are given as strings containing the appropriate keysym
name; buttons are given as the keywords Button1-Button3:
"FP1" = modlist : function
Button1 = modlist : function
The modlist is any combination of the modifier names shift,
control, lock, meta, mod1, mod2, mod3, mod4, or mod5 (which
may be abbreviated as s, c, l, m, m1, m2, m3, m4, m5,
respectively) separated by a vertical bar (|). The function
is any of the f. keywords described below. For example,
the default startup file contains the following binding:
Button1 = : f.menu "Menu"
FUNCTIONS
! string
This is an abbreviation for f.exec string.
f.exec string
This function passes the argument string to /bin/sh
for execution.
f.killncdwm
This function will kill the NCD window manager if it
is running.
f.line This function causes a line to be drawn inside a
menu.
f.menu string
This function invokes the menu specified by the
argument string. Cascaded menus may be built by
nesting calls to f.menu.
f.nop This function does nothing and is typically used to
introduce blank lines in menus.
f.quit This function quits ncdlauncher.
f.restart
This function kills and restarts ncdlauncher. This
is typically used when the .launchrc file has been
modified and you wish to see the changes.
NCDware 3.1 2
NCDLAUNCHER(1) USER COMMANDS NCDLAUNCHER(1)
f.restartncdwm
This function kills and restarts ncdwm.
f.title string
This function causes a title string to be placed in
a menu.
MENUS
Functions may be grouped and interactively selected using
pop-up menus. Each menu specification contains the name of
the menu as it will be referred to by the f.menu function
and the list of item names and the functions they should
invoke, or the f.line function.
Menu "menuname"
{
string f.title
string1 function1
f.line
string2 function2
}
The menuname is case-sensitive. The string portion of each
menu entry will be the text which will appear in the menu.
X DEFAULTS
ncdlauncher understands the following resources, when
attached to the root window RESOURCE_MANAGER property (using
the xrdb[1] host utility or the initial-x-resources remote
configuration option).
Remote configuration is not available for units using
XRemote.
The instance of name of the ncdlauncher is ncdlauncher and
the class name is NCDlauncher. String values are quoted in
the description only to make them visible; the quotation
marks should not be included in the resource.
font (class Font)
This string specifies the name of the font to
use for the title bar and menus. The default
is ``variable.''
menuFont (class MenuFont)
This string specifies the name of the font to
use for the menus. The default is ``vari-
able.''
background (class Background)
On color displays, the color of the menu back-
grounds. The default is NCD green (#58d2a6).
NCDware 3.1 3
NCDLAUNCHER(1) USER COMMANDS NCDLAUNCHER(1)
menuBackingStore (class BackingStore)
Specifies how the menus should use backing
store. The default is Always, but this can
take up a large amount of memory, especially on
color displays.
EXAMPLES
Commonly used resources include:
NCDlauncher*font: -adobe-helvetica-bold-r-normal--*-120-*-*-p-*-iso8859-1
FILES
$HOME/.launchrc
$HOME/.mwmrc
/usr/lib/X11/system.launchrc
/usr/lib/X11/system.mwmrc
ENVIRONMENT VARIABLES
DISPLAY This variable is used to determine which X server to
use. It is also set during f.exec so that programs
come up on the proper screen.
HOME This variable is used as the prefix for locating the
ncdlauncher init file.
SEE ALSO
ncdwm(1), X(1)
COPYRIGHT
Copyright 1990-1993, Network Computing Devices, Inc. All
rights reserved.
BUGS
Cyclic menus will cause problems.
AUTHOR
Dave Lemke, Network Computing Devices, Inc.
NCDware 3.1 4