NAME

       larsmenu - create a menu to run commands

SYNOPSIS

       larsmenu [ -bg background-color ] [ -display displayname ] [ -file name
       ] [ -fg foreground-color ] [ -font fname ] [ -geometry geom ] [ -iconic
       ]  [  -label name ] [ -path ] [ -popdown ] [ -popup ] [ -shell prog ] [
       -teleport ] [ -version ] [ -warp ] menuitem[:command] ...

DESCRIPTION

       larsmenu is a simple program that accepts  a  list  of  menu  item  and
       command  pairs  on the command line.  It creates a window that consists
       of nothing but a  menu.   When  a  particular  item  is  selected,  the
       corresponding command is executed.

       Any mouse button may be used to select an item.  Alternatively, the UP-
       ARROW and DOWN-ARROW cursor keys may be  used  to  highlight  different
       items, with ENTER used to select the highlighted item. ESCAPE exits the
       menu without selecting an entry.

       Menu items and commands are  separated  by  a  colon.   The  colon  and
       command  are  optional.  If  they  are  missing,  then the menu item is
       assumed to be a command that can be executed directly.

       A menu item consisting of the word exit causes larsmenu to exit when it
       is  selected.  Otherwise,  to stop larsmenu, delete it using the window
       manager.  If a command is supplied  along  with  the  exit  item,  that
       command is executed before larsmenu exits.

       If a command starts with the word exec, larsmenu ceases operating after
       launching it.

       larsmenu  accepts  the   following   command   line   options,   listed
       alphabetically:

              -bg background-color
                     Set   the   background  color  to  background-color.   By
                     default, the background color is white.

              -display displayname
                     Use the X display displayname,  instead  of  the  default
                     display.

              -file filename
                     Read  items  to display from filename, in addition to any
                     other command line arguments.  This is intended  for  use
                     with #!  in scripts.

              -fg foreground-color
                     Set   the   foreground  color  to  foreground-color.   By
                     default, the foreground color is black.

              -font fname
                     Use the font fname, instead of fixed.

              -geometry geom
                     Use geom  (a  geometry  in  standard  X  format)  as  the
                     geometry of the menu.  This is most useful for specifying
                     the initial location of the  menu.   Note  that  larsmenu
                     overrides  the  size  part of the geometry specification.
                     The window is always just large enough to hold the menu.

              -iconic
                     Start up in the iconified state.

              -label name
                     Change both the window and icon labels of the  window  to
                     name.

              -path  Append the current directory to the command search path.

              -popdown
                     Once  an  item is selected, the menu window automatically
                     iconifies itself.

              -popup Act like a pop-up menu. Once a  menu  item  is  selected,
                     larsmenu exits.  This option overrides -popdown.

              -shell prog
                     Use  prog  as  the  shell  to  run  commands,  instead of
                     /bin/sh.  If the shell cannot be executed, larsmenu  then
                     silently falls back to using /bin/sh.

              -teleport
                     Move  the  menu  to  where  the mouse is when the menu is
                     uniconified.  This option  is  particularly  useful  when
                     combined with -popdown.

              -version
                     This  option  prints  the  version  of  larsmenu  on  the
                     standard output, and then exits with  an  exit  value  of
                     zero.

              -warp  Warp  the mouse to the menu when the menu is uniconified.
                     After the selection is made, restore the mouse  to  where
                     it was.  This option is particularly useful when combined
                     with -popdown.

EXAMPLE

       larsmenu -popup "XTerm:xterm" "Calculator:xcalc"

LICENSE

       This is a modified version of 9menu, which has this license:

       ---

       9menu is free software, and is Copyright (c) 1994 by  David  Hogan  and
       Arnold  Robbins.  Permission  is  granted to all sentient beings to use
       this software, to make copies of it, and to  distribute  those  copies,
       provided that:

       (1) the copyright and licence notices are left intact

       (2) the recipients are aware that it is free software

       (3) any unapproved changes in functionality are either

       (i) only distributed as patches

       or  (ii)  distributed  as  a  new program which is not called 9menu and
       whose documentation gives credit where it is due

       (4) the authors are not held responsible for any defects

       or shortcomings in the software, or damages caused by it.

       There is no warranty for this software.  Have a nice day.

       ---

       Please consider my code to be under the same type of license as  9menu,
       inserting my name where appropriate.

SEE ALSO

       larsclock(1x), larsremote(1x), larswm(1x)

AUTHORS

       larsmenu  was  created by Lars Bernhardsson <lab@fnurt.net> by building
       on 9menu by David Hogan and Arnold Robbins.

                                                                  LARSMENU(1x)