home *** CD-ROM | disk | FTP | other *** search
/ PCNET 2006 September - Disc 1 / PCNET_CD_2006_09.iso / linux / puppy-barebones-2.01r2.iso / pup_201.sfs / usr / share / doc / Start.menu.txt < prev    next >
Encoding:
Text File  |  2005-09-02  |  3.1 KB  |  95 lines
  1. CHANGES:
  2.  
  3. Aug 31, 2005 3.00
  4. Changed Makefile to remove new 'Start.menu' binary.
  5.  
  6. Feb 25, 2005 3.00
  7. Added Up, Down, Enter and Escape key processing for keyboard steering.
  8. Rewrote this README to support new features.
  9.  
  10. Feb 9, 2005 2.04
  11. Added mime decoding scripts requiring menu to be renamed 'Start.menu'
  12.  
  13. -------------------
  14. Hey, thanks Elliot.
  15.  
  16. I have hacked menu up and renamed it 'Start.menu' so that it is a small
  17. vertical, xlib only, single parameter, general purpose pop-up menu. See the
  18. source for detailed technical operation.
  19.  
  20. Bug fixes, flames and code improvements can be sent to:
  21. loveall@iinet.com
  22. For other Xlib only apps on my home page see:
  23. http://www.modest-proposals.com/
  24.  
  25. To compile menu, type:
  26.  
  27.     xmkmf
  28.     make
  29.  
  30. Place generated binary, renamed to Start.menu, in your default search path
  31. and/or invoke it from within a program/script with the complete
  32. path/filename. See sub-directory 'mime' for example scripts designed to
  33. operate from dir /usr/local/bin.
  34.  
  35. INSTALL:
  36.  
  37. copy binary 'Start.menu' to /usr/local/bin. Copy the files in sub-dir 'mime'
  38. to /usr/local/bin.
  39.  
  40. Supports right button click in other programs from my web-site, e.g. uxplor,
  41. guiTAR, hacked dillo, txplor, retawq ...
  42.  
  43. usage: Start.menu [[menu-file] parameter]
  44.  
  45. Optional menu-file path and file-name. With no menu-file defaults to '.menu'
  46. in the current dir. If no menu-file found then defaults to a single menu
  47. option of 'localhost' which fires up an xterm.
  48.  
  49. Optional: _one_ filespec parameter, _requires_ menu-file to be specified.
  50. Parameter is passed on to menu options that contain the string '$F' in the
  51. execution portion of the menu line.
  52.  
  53. Menu format:
  54.  
  55. <Menu_label><tab><execution_string>
  56.  
  57. <Menu_label> is any ASCII string not including a tab character. Spaces are
  58. allowed. Tab character terminates <Menu_label>.
  59.  
  60. <tab> either terminates a <Menu_label> or, as the first character on a line,
  61. causes the following <execution_string> to be executed DURING MENU-FILE
  62. LOADING. Can be used for preprocessing before menu execution.
  63.  
  64. <execution_string> is the command line executed upon menu selection with a
  65. left mouse button. A single parameter passed to the menu-file can be passed
  66. to the specified command line by including the string '$F' (without the tick
  67. marks) see the included example.menu for a working example.
  68.  
  69. e.g. 'Browser    dillo $F' (without the tick marks) displays the menu seletion,
  70. 'Browser' which will execute 'dillo' (which needs to be in the search path)
  71. on the optional parameter $F.
  72.  
  73. Start.menu is now keyboard driven in addition to mouse operation. Up, down
  74. and <Enter> select and execute the highlighted menu option. <Esc> key
  75. terminates Start.menu without making a menu selection.
  76.  
  77. BTW in example.menu and .menu the command 'Cmd' is a shell script which I use
  78. which fires up an rxvt term with my personal preferences, and 'xedit' is a
  79. softlink to an X-win text editor, which you will need to set.
  80.  
  81. Original README
  82. ----------------------
  83. To compile menu, type:
  84.  
  85.     xmkmf
  86.     make
  87.  
  88. you should have a "menu" binary in the current directory.
  89.  
  90. Menu reads a .menu file from its current directory to decide what to
  91. make available. I've provided my .menu file as an example.
  92.  
  93.     - Elliott Hughes, 1999-05-28
  94.  
  95.