home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 500.lha / NewPop_v3.0 / NewPop.doc < prev    next >
Text File  |  1991-04-08  |  7KB  |  143 lines
  1.                       NewPop v3.0 by Loren J. Rittle
  2.                          Mon Jan 28 21:10:50 1991
  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 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 CPU usage and SCSI disk I/O (Note:  In past
  44. releases of NewPop, this information was rendered directly into the
  45. titlebar of the WorkBench Screen.  It was decided that this is a system
  46. unfriendly thing to do, thus the information was moved to a backdrop window
  47. that is placed in front of the titlebar.  The bad aspect of this change is
  48. that you may no longer click on that part of the titlebar to slide the
  49. screen up and down.  Such is life.  This problem is being looked into.).
  50.  
  51. Once NewPop is running, you can use it to get a new CLI from whatever
  52. program you are running by pressing Left Amiga and ESC at the same time.
  53. What this does is to bring the workbench screen to the front and then start
  54. up a new CLI window on the workbench screen.  This is extremely handy when
  55. you start a program from the CLI and then find you need to do a CLI
  56. another command.
  57.  
  58. The other major function that NewPop performs is to blank the screen for
  59. you.  This saves on the wear of the monitor phospher.  It will do this for
  60. you automatically any time that you have not pressed any key or moved the
  61. mouse for a given period of time regardless of what has been written to the
  62. screen.  This is useful when you leave the Amiga on unattended so that you
  63. don't have to mess with the brightness control or worse yet turn the
  64. monitor off putting wear and tear on its power supply.  Furthermore it only
  65. takes a touch of the mouse or any key on the keyboard to bring it all back.
  66. NewPop adds two blanking features not found in PopCLI releases:
  67.  
  68. 1) Instant blanking --- to invoke move the mouse to the upper right corner
  69.    (within five pixels of the corner) of the WorkBench screen (it's
  70.    location, even if another screen is in front of it).  Remove mouse from
  71.    zone to disable instant blanking feature.
  72.  
  73. 2) Defeat blanking, in other words, stop blanking from occuring even if
  74.    timeout period has expired --- to invoke move mouse to the lower right
  75.    corner of the WorkBench screen.  Disable defeat blanking by removing
  76.    mouse from zone.
  77.  
  78. Starting NewPop:
  79. ----------------
  80. To use NewPop, you need to execute the following command after setting
  81. up the configuration file, [s:].newpoprc (see below):
  82.  
  83.    NewPop
  84.  
  85. Note: NewPop v3.0 and later uses a file called .newpoprc to find the user
  86. options that override the compiled in defaults.  NewPop searches for this
  87. file at startup time in the following directories, in order: 
  88. Current Directory, S: Directory. (see .newpoprc for more information)
  89. All command line options are considered obsolete, save `-q' to request
  90. a running NewPop to stop.
  91.  
  92. Terminating NewPop:
  93. -------------------
  94. Once NewPop has been installed, you can terminate it with the command:
  95.  
  96.    NewPop -q
  97.  
  98. Note: With NewPop v3.0, NewPop must be stopped and restarted if you
  99. want to change any options.
  100.  
  101. Installing NewPop:
  102. ------------------
  103. To install a copy of NewPop on your workbench, put a copy of NewPop in your
  104. C: directory and edit the Startup-Sequence file in the S: directory to add
  105. the NewPop command.
  106. Copy .newpoprc to your S: directory, and then edit it to your own tastes.
  107.  
  108. Or under 2.0:
  109. At least the last time I checked, NewPop could be safely placed in the
  110. WBStartUp directory (I don't remember the exact directory name).
  111. Copy .newpoprc to your S: directory, and then edit it to your own tastes.
  112.  
  113. NewPop should run fine from the WorkBench.  Double click on it's
  114. icon once to start it and again to stop it.
  115. Making an icon (.info file) for NewPop is left as an exercise for the
  116. reader.
  117.  
  118. Some Notes:
  119. -----------
  120. The Helvetica.font (size 9) as distributed by Commodore on the Extras disk
  121. from release 1.3 (maybe 1.2 also) must be in your fonts:  directory.  If
  122. the font NewPop needs is not available, it will quit without an error
  123. message, and without a crash :-).
  124. [Note:  It appears Gold Disk made their own version of the Helvetica font
  125. and shipped them with a few products.  Some of the sizes (size 9 at least)
  126. are present in both distributions (Gold Disk's and Commodore's).  The
  127. problem lies in the fact that the fonts are different.  Very different!
  128. See the FONTNAME section of .newpoprc for more details on Gold Disk version
  129. problem.]
  130.  
  131. NewPop's technique for determining SCSI I/O usage may or may not work with
  132. your device driver.  All I can say is check it out yourself.  It does work
  133. with the A3000's onboard SCSI device and the "scsi.device" device driver.
  134. With this information, I would guess that it works with all Commodore SCSI
  135. controller, but I don't know for sure.  You may change the name of the task
  136. to watch in .newpoprc.
  137.  
  138. NewPop's pseudo titlebar window can be made dragable by recompiling 
  139. with the WEWANTWINDOWDRAG define uncommented. See .newpoprc.
  140.  
  141. See .newpoprc for more user configurable options and features of NewPop
  142. v3.0 and for more details on all of the above features and options.
  143.