home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / amigan / amigan 4 / popcli / popcli.doc next >
Encoding:
Text File  |  1994-01-27  |  5.8 KB  |  111 lines
  1. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  2. /* |_o_o|\\ Copyright (c) 1986 The Software Distillery.  All Rights Reserved */
  3. /* |. o.| || This program may not be distributed without the permission of   */
  4. /* | .  | || the authors.                                                    */
  5. /* | o  | ||    Dave Baker     Ed Burnette  Stan Chow    Jay Denebeim        */
  6. /* |  . |//     Gordon Keener  Jack Rouse   John Toebes  Doug Walker         */
  7. /* ======          BBS:(919)-471-6436      VOICE:(919)-469-4210              */ 
  8. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  9.  
  10. POPCLI II by John Toebes © 1986 The Software Distillery.  All Rights Reserved
  11.  235 Trillingham Ln, Cary, NC 27511
  12.  
  13. Contributions to continue development of this and other fine products for the
  14. Amiga should be sent to the Software Distillery at the above address.
  15.  
  16. Other Products produced by the Software Distillery are:
  17.    BLINK  - the Turbo-charged Alink replacement
  18.    HACK   - The Amiga port of the famous UNIX game
  19.    MAKE   - A software development tool one shouldn't be without
  20.    KERMIT - The World renown file transfer protocol brought to the Amiga
  21.    ICONEXEC, SETALTERNATE, SETWINDOW - Icon manipulation tools
  22.    TSIZE  - A short utility for determining directory sizes.
  23. All of these are available on our BBS.
  24.  
  25. Permission is hereby granted to distribute this program provided both this
  26. documentation accompanies the executable and that no charge is made for its
  27. distribution.
  28.  
  29. POPCLI is designed to solve two problems at once.  First it provides a simple
  30. way of starting another CLI at any time without having to load workbench or
  31. exit whatever program you may be using.  Second it has a builtin screen saver
  32. mode that automatically turns off the Amiga display when there has been no
  33. input for a given period of time.
  34.  
  35. Once POPCLI is running, you can use it to get a new CLI from whatever program
  36. you are running by pressing Left Amiga and ESC at the same time.  What this
  37. does is to bring the workbench screen to the front and then start up a new
  38. CLI window on the workbench screen.  This is extremely handy when you start
  39. a program from CLI and then find you need to do a CLI command.
  40.  
  41. The other function that POPCLI performs is to blank the screen for you.  This
  42. saves on the wear of the monitor phospher.  It will do this for you
  43. automatically any time that you have not pressed any key or moved the mouse
  44. for a given period of time regardless of what has been written to the screen.
  45. This is useful when you leave the Amiga on unattended so that you don't have
  46. to mess with the brightness control or worse yet tunr the monitor off putting
  47. wear and tear on its power supply.  Furthermore it only takes a touch of the
  48. mouse or any key on the keyboard to bring it all back.
  49.  
  50. To use POPCLI, you need to execute the command:
  51.   RUN POPCLI <seconds> <command>
  52.  
  53. Where <seconds> is any number of seconds after which the screen saver is to
  54. go into effect.  If nothing is specified it defaults to turning off the
  55. screen after 300 seconds. (Five minutes)  Note that it makes its decision to
  56. shut blank the screen solely upon the absence of any keyboard, gameport, or
  57. mouse input.  Even if a program is printing to the screen it will shut down.
  58. This is not a problem, to unblank the screen merely move the mouse or touch any
  59. key (SHIFT or CTRL are excellent choices since they don't do anything).
  60.  
  61. <command> is the command to be executed when the Left Amiga and ESC keys are
  62. pressed simaultaneously.  By default the command is
  63.    NEWCLI >NIL:
  64. to bring up a CLI window in the center of the screen.  Note the >NIL: on the
  65. command to supress any output that the NEWCLI program may give.  This is
  66. important because at the time the command is executed, the original window
  67. may be long gone.  If you wish to have a CLI come up elsewhere on the screen
  68. you can put the window definition in the command such as:
  69.    NEWCLI >NIL: CON:0/0/640/200/MYCLI
  70. Which will open a CLI to fill the entire screen.  POPCLI does no parsing on
  71. the command, merely passing the ENTIRE string without any processing to
  72. AmigaDOS.
  73.  
  74. If you wish to specify a command with POPCLI you must include the seconds
  75. value followed by one or more spaces.  Some valid commands are:
  76.    RUN POPCLI 200
  77.    RUN POPCLI 200 NEWCLI >NIL: CON:0/0/640/100/MYWINDOW
  78.    RUN POPCLI 10
  79.    RUN POPCLI 180 NEWCLI >NIL: CON:0/10/640/120/POPUP
  80.  
  81. To install a copy of POPCLI on your workbench, put a copy of POPCLI in your
  82. C directory and edit the Startup-Sequence file in the S directory to add
  83. a RUN POPCLI command of your own taste.
  84.  
  85. Notes:
  86. 1) Once POPCLI is installed, the only way to get rid of it is to reboot.
  87. 2) POPCLI blanks the screen by creating a one bit-blane lo-res screen in front
  88.    of all other screens and setting the background color to solid black.  It
  89.    then turns off the display freeing the cycles for any program that might
  90.    be running.
  91. 3) Once the screen blanks, if the AMIGA is left undisturbed for 68.096 years
  92.    the screen may briefly flash back on for the next 68.096 years.  I have not
  93.    taken the time to test this.  If this turns out to be a problem, please
  94.    let me know.
  95.  
  96. Enhancements Provided under POPCLI II:
  97.  
  98. * POPCLI now runs from WORKBENCH.  An icon is provided for doing so.  When
  99.   run from workbench, the default command and default times will be used.
  100.  
  101. * When run from CLI, the original window now goes away.  In doing so, it
  102.   also appears that incompatibilities with 1.2 have been removed.  Please
  103.   feel free to comment on potential future improvements.
  104.  
  105. * The size of the screen used to blank the display has been reduced to reduce
  106.   memory required to blank the screen.
  107.  
  108. * POPCLI has been recompiled to take advantage of the latest features of 3.04
  109.   Lattice and BLINK.  Although source is being distributed, it is not likely
  110.   that a version of POPCLI could be reconstructed without these products.
  111.