LARSMENU(1x)															      LARSMENU(1x)

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 win-
       dow 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 loca-
		     tion 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)