Read Me

$Id$


To make yume, see directions in INSTALL.  That file explains
how to get the xforms library which yume uses to draw graphic
objects, and how to make yume.  


yume is a menu system with user-editable, mouse-activated shell
commands, based on the xforms library for X Window System.  It 
creates and runs a menu based on user-provided arguments.

For example,

      yume -bu date ls -ex &

creates a menu window with three buttons, labeled date, ls, exit.
Clicking the button labeled date runs the date command and displays
the result in the window where yume started; clicking the ls button
runs the ls command; clicking exit closes the menu window.


As another example, 

      yume -do 'ls -al' 'cal -3' &

makes a menu window with two "do" items, with command text in an
editing box where you can change it, and with the option to turn
on "roll-over" operation, where an item is executed when the mouse
cursor crosses it.

For more examples, cd to the yume2/examples directory after you
make yume, and enter the command ./yume-examples.  Also, see 
man yume and man yume-examples.

- jiw, 11 Jan 2011