Provided by: larswm_7.5.3-6_amd64 bug

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)