home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / vile-src.zip / vile-8.1 / doc / menus.doc < prev    next >
Text File  |  1998-04-26  |  2KB  |  89 lines
  1. -- $Header: /usr/build/vile/vile/doc/RCS/menus.doc,v 1.1 1998/04/26 14:10:39 tom Exp $
  2. -- adapted from description by Philippe Chassany (20/02/1997)
  3. -- e-mail: phil@cln46ks.der.edf.fr
  4.  
  5.  
  6. The Motif and Athena widget versions of xvile automatically support user
  7. configurable menus.
  8.  
  9. If the environment variable XVILE_MENU is set, it contains the name of
  10. the rc file.  Otherwise, the name ".vilemenu" is used.
  11.  
  12. The file contains a series of lines whose first character denotes the
  13. type of entry, subsequent fields delimited by colon:
  14.  
  15.     C - cascade (actually pulldown).  One field only is recognized,
  16.         the menu heading.
  17.  
  18.     B - button (menu entry).  The first field is the menu label. 
  19.         The second is the command which will be executed.  If the
  20.         command is a number, it is expanded into the vile command
  21.         execute-macro-<number>.
  22.  
  23.         Besides the normal vile commands, the menu implements the
  24.         following
  25.  
  26.         new_xvile - spawn a new copy of xvile.
  27.         edit_rc - switch to a buffer with ".vilerc".
  28.         parse_rc - source ".vilerc"
  29.         edit_mrc - switch to a buffer with the menu rc file
  30.             ".vilemenu"
  31.  
  32.     S - separator
  33.  
  34.     L - list buffers.  Each time you select this menu entry, vile
  35.         constructs a current list of the buffers, allowing you to
  36.         switch to any buffer by selecting it from the menu.  It has
  37.         to be at the end of a menu, and only one is allowed.
  38.  
  39.         For the Motif version, the accelerators are constructed to
  40.         correspond with the vile commands for switching buffers,
  41.         e.g., _0, _1 ...
  42.  
  43. Lines beginning with '#' are ignored, as is text after a tab character.
  44.  
  45. The special keyword "cmd" tells the menu function to invoke the following
  46. keyword as a :-line command, so that commands which must solicit input
  47. will work properly.
  48.  
  49. A sample .vilemenu file:
  50.  
  51. C:Xvile
  52. B:New:new_xvile
  53. B:Edit .vilerc:edit_rc
  54. B:Parse .vilerc:parse_rc
  55. B:Edit .vilemenu:edit_mrc
  56. B:Quit:quit
  57. #
  58. C:Edition
  59. B:Search Forward...:cmd search-forward
  60. B:Search Backward...:cmd search-reverse
  61. S
  62. B:Manual for...:2
  63. B:Word Manual:8
  64. S
  65. B:Indent Level...:31
  66. B:Window Title...:35
  67. B:Font...:36
  68. #
  69. C:Buffers
  70. B:Toggle Show:toggle-buffer
  71. L:list_buff
  72. #
  73. C:Attributes
  74. B:C/C++:17
  75. B:Tk/Tcl:22
  76. B:HTML:24
  77. B:Makefile:32
  78. B:ProC:33
  79. #
  80. C:Help:help
  81. B:General:help
  82. B:Bindings:describe-bindings
  83. B:Motions:describe-motions
  84. B:Operators:describe-operators
  85. S
  86. B:Apropos...:cmd apropos
  87. B:On Function...:cmd describe-function
  88. B:On Key...:describe-key >s
  89.