home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / system / newpop-4.1 / newpop.doc < prev    next >
Text File  |  1995-02-27  |  8KB  |  149 lines
  1.                       NewPop v4.1 by Loren J. Rittle
  2.                          Sun Apr 18 22:07:14 1993
  3.  
  4. Newpop is based upon:
  5. >
  6. > /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  7. > |_o_o|\\ Copyright (c) 1986 The Software Distillery.  All Rights Reserved
  8. > |. o.| || This program may not be distributed without the permission of
  9. > | .  | || the authors.
  10. > | o  | ||    Dave Baker     Ed Burnette  Jay Denebeim John Mainwaring
  11. > |  . |//     Gordon Keener  Jack Rouse   John Toebes  Doug Walker
  12. > ======                    BBS:(919)-471-6436
  13. > * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  14. >
  15. > POPCLI III by John Toebes © 1987 The Software Distillery.
  16. > All Rights Reserved    235 Trillingham Ln, Cary, NC 27511
  17. >
  18. > Contributions to continue development of this and other fine products for
  19. > the Amiga should be sent to the Software Distillery at the above address.
  20.  
  21. Additions and modifications Copyright © 1989, 1990, 1991, 1993 Loren J. Rittle.
  22.  
  23. Permission is hereby granted to distribute this program provided both this
  24. documentation accompanies the executable and that no charge is made for its
  25. distribution.  (As in the original PopCLI III documentation.  - LJR)
  26.  
  27. I assume that this statement includes the right to modify the source and
  28. futher distribute the modified work under this same agreement.  - LJR
  29.  
  30. [Special note to Matt Dillon:  I wanted the damn clock! :-) PS: I use
  31. DMouse and NewPop at the same time, Thanks Matt for all your great
  32. Amiga code.  The fish disks would be a lot less full if there was no
  33. Matt Dillon.  And we would have no D* programs to kick around! :-) - LJR]
  34.  
  35. NewPop is designed to solve a few problems at once.  First it provides a
  36. simple way of starting another CLI at any time without having to load
  37. workbench or exit whatever program you may be using.  Second it has a
  38. builtin screen saver mode that automatically turns off the Amiga display
  39. when there has been no input for a given period of time.  On the blank
  40. screen, a cute little Q*X-type pattern dances about changing colors slowly
  41. over time.  Finally, a discreet informative backdrop window opens in the
  42. titlebar region of the WorkBench screen.  This window reports the current
  43. date, a rough indication of CPU usage and SCSI disk I/O and available
  44. memory [Note:  In past releases of NewPop, this information was rendered
  45. directly into the titlebar of the WorkBench Screen.  It was decided that
  46. this is a system unfriendly thing to do, thus the information was moved to
  47. a backdrop window that is placed in front of the titlebar.  The bad aspect
  48. of this change is that you may no longer click on that part of the titlebar
  49. to slide the screen up and down.  Such is life.  This problem is being
  50. looked into.].
  51.  
  52. Once NewPop is running, you can use it to get a new CLI from whatever
  53. program you are running by pressing Left Amiga and ESC at the same time.
  54. What this does is to bring the workbench screen to the front and then start
  55. up a new CLI window on the workbench screen.  This is extremely handy when
  56. you start a program from the CLI and then find you need to do a CLI
  57. another command.
  58.  
  59. The other major function that NewPop performs is to blank the screen for
  60. you.  This saves on the wear of the monitor phospher.  It will do this for
  61. you automatically any time that you have not pressed any key or moved the
  62. mouse for a given period of time regardless of what has been written to the
  63. screen.  This is useful when you leave the Amiga on unattended so that you
  64. don't have to mess with the brightness control or worse yet turn the
  65. monitor off putting wear and tear on its power supply.  Furthermore it only
  66. takes a touch of the mouse or any key on the keyboard to bring it all back.
  67. NewPop adds two blanking features not found in PopCLI releases:
  68.  
  69. 1) Instant blanking --- to invoke, move the mouse to the upper right corner
  70.    (within five pixels of the corner) of the WorkBench screen (it's
  71.    location, even if another screen is in front of it).  Remove mouse from
  72.    zone to disable instant blanking feature.  It is also possible to turn
  73.    on a HOT KEY for the instant balnker and to configure which corner(s)
  74.    trigger the instant blanking (see .newpoprc).
  75.  
  76. 2) Defeat blanking, in other words, stop blanking from occuring even if
  77.    timeout period has expired --- to invoke, move mouse to the lower right
  78.    corner of the WorkBench screen.  Disable defeat blanking by removing
  79.    mouse from zone.  One can also enable a HOT KEY that will trigger the
  80.    defeat blanker and, as above, the corner(s) that trip the defeat
  81.    blanker can configured (see .newpoprc).
  82.  
  83. Starting NewPop:
  84. ----------------
  85. To use NewPop, you need to execute the following command after setting
  86. up the configuration file, [s:].newpoprc (see below):
  87.  
  88.    Run <nil: >nil: NewPop
  89.  
  90. Note: NewPop v3.0 and later uses a file called .newpoprc to find the user
  91. options that override the compiled in defaults.  NewPop searches for this
  92. file at startup time in the following directories, in order: 
  93. Current Directory, S: Directory. (see .newpoprc for more information)
  94. All command line options are considered obsolete.
  95.  
  96. Terminating NewPop:
  97. -------------------
  98. Once NewPop has been installed, you can terminate it with the command:
  99.  
  100.    break [cli number of running NewPop]
  101.    [or if you forgot to `run' it, a control C in the window NewPop is
  102.     running in will stop it.]
  103.  
  104. Note: With NewPop v3.0 and beyond, NewPop must be stopped and restarted if
  105. you want to change any options.
  106.  
  107. Installing NewPop:
  108. ------------------
  109. To install a copy of NewPop on your workbench, put a copy of NewPop in your
  110. C: directory and edit the Startup-Sequence file in the S: directory to add
  111. the NewPop command.
  112. Copy .newpoprc to your S: directory, and then edit it to your own tastes.
  113.  
  114. Or under 2.0:
  115. At least the last time I checked, NewPop could be safely placed in the
  116. WBStartUp directory (I don't remember the exact directory name).
  117. Copy .newpoprc to your S: directory, and then edit it to your own tastes.
  118.  
  119. NewPop should run fine from the WorkBench.  Double click on it's
  120. icon once to start it and again to stop it.
  121. Making an icon (.info file) for NewPop is left as an exercise for the
  122. reader.  [Sample Icon is now included... :-]
  123.  
  124. Some Notes:
  125. -----------
  126. The Helvetica.font (size 9) as distributed by Commodore on the Extras disk
  127. from release 1.3 (maybe 1.2 also) must be in your fonts:  directory.  If
  128. the font NewPop needs is not available, it will quit without an error
  129. message, and without a crash :-).
  130. [Note:  It appears Gold Disk made their own version of the Helvetica font
  131. and shipped them with a few products.  Some of the sizes (size 9 at least)
  132. are present in both distributions (Gold Disk's and Commodore's).  The
  133. problem lies in the fact that the fonts are different.  Very different!
  134. See the FONTNAME section of .newpoprc for more details on Gold Disk version
  135. problem.]
  136.  
  137. NewPop's technique for determining SCSI I/O usage may or may not work with
  138. your device driver.  All I can say is check it out yourself.  It does work
  139. with the A3000's onboard SCSI device and the "scsi.device" device driver.
  140. With this information, I would guess that it works with all Commodore SCSI
  141. controller, but I don't know for sure.  You may change the name of the task
  142. to watch in .newpoprc.
  143.  
  144. NewPop's pseudo titlebar window can be made dragable by recompiling 
  145. with the WEWANTWINDOWDRAG define uncommented. See .newpoprc.
  146.  
  147. See .newpoprc for more user configurable options and features of NewPop
  148. v4.1 and for more details on all of the above features and options.
  149.