asexec(1) asexec(1)
NAME
asexec - the AfterStep state machine and arbitrary command
launcher.
SYNOPSIS
asexec [-h] [--help] [-v] [--version]
DESCRIPTION
asexec is an X11 application that provides a simple state
machine and the ability to execute a command when changing
states. asexec provides a distinctive AfterStep window
manager look and feel and uses a resource file to allow
customization.
The states are described in asexec's resource file. Each
state may have a distinctive pixmap bound to it, which
asexec presents in a window just large enough to display
the largest pixmap.
The state transitions can be bound to a number of events.
These events are: entering or leaving the asexec window,
mouse click, and a timeout. When a state transition
occurs, a command may be executed.
CONFIGURATION OPTIONS
None.
RESOURCE FILE SYNTAX
The following options may be placed in the user's asexecrc
configuration file. Note that all options are case-insen
sitive.
*ASExec pixmappath "path"
Specifies the directory list that will be searched
by asexec for the pixmaps specified in this
resource file. The path must be quoted and contain
a colon-separated list of directories. For example:
"/usr/local/share/pixmaps:/usr/include/X11/pixmaps:."
*ASExec swallow "window-name" command
Specifies a command to be run when asexec starts.
Not to be confused with the state option of the
same name. asexec will watch for new windows with
the name window-name. When one is found, it will be
"swallowed". That is, its window will disappear
from the desktop and optionally reappear within the
asexec window. See the state swallow option below
for more details. window-name should be specified
in quotes, for example:
Version 1.3 05 November 1998 1
asexec(1) asexec(1)
*ASExec swallow "asclock" asclock -shape
*ASExec state "state-label" "pixmap"
Specifies the beginning of a state definition. This
line defines the state-label and starts the list of
the state transition descriptions. Each state is
bound to a pixmap that represents the state. The
pixmap must be a valid X11 pixmap that can be found
in the path specified by pixmappath. Both state-
label and pixmap name should be enclosed in double
quotes. For example:
*ASExec state "frame0" "frame0.xpm"
*ASExec swallow "window-name" [x y]
Specifies a swallowed window to associate with this
state. Not to be confused with the global option of
the same name. If a global swallow option was spec
ified with the same window-name, then the swallowed
window associated with that option will be shown
while in this state. x and y are optional, and
specifies the location within the asexec window
that the window will be shown. window-name should
be enclosed in double quotes. For example:
*ASExec swallow "asclock" 4 3
*ASExec "binding-label" bind "to-state-label" event
Specifies a state transition and its trigger. This
statement is only valid within a state definition.
The to-state-label specifies the target state of
the state machine and the event specifies the the
event which will trigger the state transition. Both
binding-label and to-state-label must be enclosed
in double quotes as shown in the example:
*ASExec "next" bind "frame1" timeout 500
The valid events for triggering state transitions
are:
timeout milliseconds
Triggers after milliseconds in this state.
mouse button
Triggers when button is pressed in the
asexec window.
enter
Triggers when the cursor enters the asexec
window.
leave
Triggers when the cursor leaves the asexec
window.
Version 1.3 05 November 1998 2
asexec(1) asexec(1)
*ASExec "binding-label" exec "command"
Specifies a command to be executed when the state
transition bound to the label binding-label occurs.
For example, for the state transition in the above
example we could bind the following action:
*ASExec "next" exec echo hello, world!
*ASExec ~state
Specifies the end of a state definition of a state
and terminates the list of state transitions and
action descriptions.
INVOCATION
asexec can be called in different ways. The most common
invocation is the command line:
user@host[1]% asexec &
Another way to call asexec is from the window manager:
*Wharf "asexec" nil Swallow "asexec" asexec &
This line, when placed in the wharf file in the user's
Afterstep configuration directory will cause asexec to be
a button on the Wharf (1) button bar under the afterstep
(1) window manager.
BUGS
None have been found to date.
FILES
asexecrc
The asexec configuration file. It may be in the
following places, in searching order:
~/GNUstep/Library/AfterStep/asexec, ~/.asexecrc, ./asexecrc
SEE ALSO
Wharf(1),AfterStep(1)
COPYRIGHTS
Copyright (c) 1998 Ethan Fischer <allanon@crystal
tokyo.com>
Distributed under GNU General Public License v2 ; see
LICENSE file for more information.
Version 1.3 05 November 1998 3
asexec(1) asexec(1)
AUTHORS
Application:
Ethan Fischer <allanon@crystaltokyo.com>
Man page:
Albert Dorofeev <albert@mail.dma.be>
Ethan Fischer <allanon@crystaltokyo.com>
Version 1.3 05 November 1998 4
Man(1) output converted with
man2html