home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 073.lha / CommandRequester / CommandReq-README < prev    next >
Encoding:
Text File  |  1986-11-20  |  4.0 KB  |  100 lines
  1. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  2.                    CommandReq -- Command File Requester
  3.                  Copyright 1987 Jay Johnson and Sam Morse
  4. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  5.                    Written by Jay Johnson and Sam Morse
  6.                       Version 1.0 July 17th, 1987
  7. ***************************************************************************
  8. This program is public domain. It may be freely distributed as long as this
  9. file accompanies it. The authors assume no liability for missuse of this
  10. program and are not liable for any damage incurred during use. Use at your
  11. own risk.
  12.  
  13. This program may be used in commercial software ONLY with the written consent
  14. of the original authors.
  15.  
  16. Please send modifications of this code to the below address so that we may
  17. better control the evalution and insure that the best revisions are included
  18. in updates.
  19. *****************************************************************************
  20.  
  21.     This little program comes in quite handy at certain times.  What it does
  22. is allows a user to place optional commands into 'execute' files.  When
  23. executed, the program will place a requester on the screen asking if you
  24. want a specified command string executed.
  25. For example:
  26.  
  27.   You have a 'execute' file that contains:
  28.  
  29.     cc +p filename
  30.     ln filename -lc
  31.  
  32.   that you use for standard compiles and links with the Aztec compiler.
  33.   You want the link to be optional, so you would use the command:
  34.  
  35.     CommandReq "ln filename -lc"
  36.  
  37.   in place of the second line. This would allow you to optionally link the
  38. program whenever you want. The requester looks something like:
  39.  
  40.     ---------------------------------
  41.     | Execute this command:         |
  42.     |                               |
  43.     | [command               ]      |
  44.     |                               |
  45.     | [  YES  ] [ STOP! ] [  NO   ] |
  46.     ---------------------------------
  47.  
  48.   Selecting YES, would execute the command. Selecting NO, would pass over
  49. the specified command and continue with the 'execute' file. Selecting STOP
  50. would cause CommandReq to return an error and stop the 'execute' file at
  51. that point.
  52.  
  53.   The requester command line is a string-gadget and allows the user to
  54. modify the contents of the command-line before returning it to the program.
  55. Lets say that you pass the command 'ln filename -lc' to the program and
  56. decide that you want it to be 'ln filename -lm'.  You could then edit into
  57. the string-gadget the replacement command and press return and it will be
  58. executed.
  59.  
  60.   CommandReq also allows timeout defaults with the requester. You can tell
  61. the program that if no selection is made after n seconds, that a default
  62. selection will be made. This allows unattended operation of the program and
  63. makes the program useful in the 'startup-sequence' of your system. The full
  64. command line is:
  65.  
  66.  CommandReq "command" [default(YES/NO/STOP)] [seconds(1-600)]
  67.  
  68.  
  69. If you do not select a default, the requester will stay up infinitely until
  70. one of the gadgets is selected, or <return> typed while working in the string
  71. gadget.  If you select a default paramater (YES/NO/STOP) and do not supply
  72. the seconds, the default time is 10 seconds. You must specify a default
  73. before you specify a timeout count. BEWARE, the requester WILL timeout after the
  74. timeout period reagrdless of what you are doing in the requester. If you
  75. think you will be editing the command-line in the requester, do not specify
  76. a default in the command-line.
  77.  
  78. Use it to selectively set up your environment on the fly. Optionally send
  79. stuff to RAM:, optionally start clock and other background programs. This is
  80. the best way to control the Amiga environment when your uses vary from power
  81. up to power up.
  82.  
  83. NOTE: 'cd' does not work properly as of this version.
  84.  
  85.   If you have any questions about the program or have comments, feel free
  86. to send them to:
  87.  
  88.      Sam Morse c/o
  89.      A.M.I.G.A.
  90.      P.O. Box 32374
  91.      Fridley, MN 55432
  92.  
  93.   or call:
  94.  
  95.      'The Phoenix' - An Amiga Citadel BBS
  96.      (612) 459-8095 (300/1200/2400 BAUD)
  97.      24 Hours (carriage returns to connect)
  98.  
  99.    
  100.