home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / AM553.ZIP / PROGMENU.DOC < prev    next >
Encoding:
Text File  |  1990-11-14  |  3.4 KB  |  66 lines
  1.  
  2.   INSTRUCTIONS FOR USE OF THE NEW EXECUTABLE PROGRAM MENU VIA CTRL-X
  3.  
  4.   10-14-90  -  Incorporated into AM 5.3
  5.  
  6.   A new feature in AM is the ability to create and utilize executable
  7. program menus.  This feature is activated by Ctrl-X and is based upon
  8. the existence of an ASCII text file created by the user named
  9. PROGMENU.AM.  Note:  Ctrl-X formerly refreshed the current window.  Use
  10. of the "*" key will accomplish the same thing.
  11.  
  12.   Use any text editor (QEDIT is recommended) to create PROGMENU.AM.
  13. This file must be formatted as described below.  Note that in the
  14. examples provided, that upper and lower case are used for clarity
  15. and the actual file line data may be in either case.
  16.  
  17.   Comments are denoted by the semicolin (";").  AM will ignore the
  18. semicolon and all following text in any line in which it appears.  The
  19. first non-comment item on any line must be the program name.  It may or
  20. may not include the executable extension of .BAT, .COM, or .EXE.
  21.  
  22.   Two other items may appear on a given line in the file.  To force AM
  23. to change to a specified drive:\directory path prior to executing the
  24. selected program, use the switch "-d" followed immediately by the FULL
  25. DOS path name.  An example is the line "klondike -dE:\UTILS\MYGAMES",
  26. which will cause AM to switch to the directory E:\UTILS\MYGAMES before
  27. executing the program KLONDIKE.  A semi-permanent command parameter that
  28. will be passed to the target program is denoted by the "-p" switch.  An
  29. example is the line "QEDIT -pMYTEXT.FIL", which will cause AM to pass
  30. the command line parameter string of "MYTEXT.FIL" to QEDIT when it is
  31. executed.  Any line in the file may contain either/or the "-d" and the
  32. "-p" switches, but the "-d" switch MUST follow the program name and
  33. MUST precede the "-p" switch if both are used on the same line.  An
  34. example is "QEDIT -dC:\TEXT -pMYFILE.TXT, which would change to
  35. C:\TEXT and execute QEDIT, passing it MYFILE.TXT.
  36.  
  37.   Command line parameters may be added dynamically by the user just
  38. prior to running the selected program by pressing Ctrl-Enter instead of
  39. Enter.  This will bring up a window that prompts for a command line
  40. parameter string that will be passed to the target program when
  41. executed.  Note that the user entered parameter string will
  42. automatically override any "-p" switch string in the file.  The Esc key
  43. aborts from this window with no action and since the window shows both
  44. the semi-permanent parameter string and directory to change to (if any),
  45. this window can be used to check the status of any menu item.
  46.  
  47.   Up to one hundred progam definition lines are supported.  Note that
  48. menu flexibility is enhanced by the capability to have the same program
  49. file name on multiple lines in PROGMENU.AM, each with different "-d"
  50. and/or "-p" switches.
  51.  
  52.   An example PROGMENU.AM file is included in this package.  Use it for
  53. an example and modify it for your own menu list.
  54.  
  55.   When Ctrl-X is pressed, AM will first look in the current directory
  56. (left window) for PROGMENU.AM and load it if found.  If not found there,
  57. AM will search the DOS path and load it if found.  If not found, nothing
  58. happens.  This strategy permits maintaining numerous variants of
  59. PROGMENU.AM in different directories as well as maintaining one master
  60. copy in one directory in the DOS path.
  61.  
  62.   Note that AM automatically uses its swap to EMS/Disk capability when
  63. executing programs in order to maximize the amount of RAM available to
  64. the target program.
  65.  
  66.