home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / MagicEYE.lha / MagicEYE / SCREENNO.LHA / ScreenNotify / README < prev    next >
Encoding:
Text File  |  1995-03-26  |  5.9 KB  |  160 lines
  1. ScreenNotify 1.0                                               26.03.1995
  2.  
  3.  
  4. I. DISCLAIMER
  5. -------------
  6.  
  7.    Permission is granted to make and distribute verbatim copies  of  this
  8. manual provided the copyright  notice  and  this  permission  notice  are
  9. preserved on all copies.
  10.  
  11. COPYRIGHT
  12.  
  13.    Copyright (C) 1995 Stefan Becker
  14.  
  15.    No program, document, data file or  source  code  from  this  software
  16. package, neither in whole nor in part, may be included or used  in  other
  17. software packages unless it is authorized by a  written  permission  from
  18. the author.
  19.  
  20.  
  21. NO WARRANTY
  22.  
  23.    There is no warranty for this software package.  Although  the  author
  24. has tried to prevent errors, he can't guarantee that the software package
  25. described in this document is 100% reliable. You are therefore using this
  26. material at your own risk. The author cannot be made responsible for  any
  27. damage which is caused by using this software package.
  28.  
  29.  
  30. DISTRIBUTION
  31.  
  32.    This software package is freely distributable. It may be  put  on  any
  33. media which is used for the distribution of free  software,  like  Public
  34. Domain disk collections, CDROMs, FTP servers or bulletin board systems.
  35.  
  36.    In  order  to  ensure  the  integrity  of   this   software   package,
  37. distributors should use the original  archive  file  ScreenNotify1_0.lha.
  38. The author cannot be made responsible if this software package has become
  39. unusable due to modifications of the archive contents or of  the  archive
  40. file itself.
  41.  
  42.    There is no limit on the costs  of  the  distribution,  e.g.  for  the
  43. media, like floppy disks, streamer tapes or compact discs, or the process
  44. of duplicating. Such limits have been proven to be harmful to the idea of
  45. freely distributable software, e.g. instead of reducing the price of  the
  46. floppy disk below the limit, the software was  simply  removed  from  the
  47. master disk.
  48.  
  49.    Although the author does not impose any limit on the  distribution  of
  50. this software package, he would like to express his personal opinions  on
  51. this matter:
  52.  
  53.    * This software package should be made available to everyone  free  of
  54.      charge whenever it is possible.
  55.  
  56.    * If you have acquired this software package under  normal  conditions
  57.      from a Public Domain dealer on a floppy disk at a price higher  than
  58.      5DM or US $5, then you have definitely paid too much.  Please  don't
  59.      support this improper profit making  any  longer  and  switch  to  a
  60.      cheaper source as soon as possible.
  61.  
  62.  
  63. USAGE RESTRICTIONS
  64.  
  65.    No program, document, data file or  source  code  from  this  software
  66. package, neither in whole nor in part, may be used on any  machine  which
  67. is used
  68.  
  69.    * for the research, development, construction, testing  or  production
  70.      of weapons or other military applications. This  also  includes  any
  71.      machine which is  used  in  the  education  for  any  of  the  above
  72.      mentioned purposes.
  73.  
  74.    * by people who accept, support or use violence against other  people,
  75.      e.g. citizens from foreign countries.
  76.  
  77.  
  78. II. What is ScreenNotify?
  79. -------------------------
  80.  
  81. Starting with AmigaOS V37 the Workbench offers a library with some useful
  82. functions for applications. Although this is a _BIG_ improvement over the
  83. old Workbench there are still some important features missing.  The  most
  84. annoying one is that an application with an open window on the  Workbench
  85. screen prevents the closing of the screen, e.g. after pressing  "Use"  in
  86. the ScreenMode preferences editor.
  87.  
  88. To circumvent these programs have either to  patch  the  CloseWorkBench()
  89. and OpenWorkBench() functions  in  the  intuition.library  or  to  add  a
  90. notification for the screenmode.prefs file. The ideal solution would be a
  91. new App* message from the Workbench, but  as  we  all  know  a  Workbench
  92. update/rewrite is not very likely in the near future :-(
  93.  
  94. ScreenNotify offers  an  intermediate  solution.  It  patches  the  above
  95. mentioned functions and offers a notification service for  clients.  This
  96. hides the "dirty" things in one location and offers a clean interface  to
  97. the outside world. Clients only  have  to  close  their  windows  on  the
  98. Workbench screen after receiving a CLOSE notification. They may open them
  99. again after receiving an OPEN notification.
  100.  
  101. Additionally ScreenNotify patches CloseScreen() and PubScreenStatus(). It
  102. can therefore offer a notification when a  public  screen  is  closed  or
  103. opened. This may be useful for utilities  which  open  their  windows  on
  104. public screens.
  105.  
  106.  
  107. III. Installation
  108. -----------------
  109.  
  110. Just copy libs/screennotify.library to LIBS:. When a  program  opens  the
  111. library the patches will be  installed.  The  library  can  remove  those
  112. patches as long as no other program  patches  the  functions.  This  will
  113. automatically happen when the library is asked to remove itself.
  114.  
  115. NOTE: Removing patches is a dangerous operation! The library tries to  be
  116. careful when removing the patches, but the machine may still crash  under
  117. certain conditions.
  118.  
  119. Programs which use ScreenNotify should be started after  IPrefs,  because
  120. it also patches CloseWorkBench()/OpenWorkBench().
  121.  
  122.  
  123. IV. Warnings
  124. ------------
  125.  
  126. Programs which use ScreenNotify  will  cause  dead  locks  under  certain
  127. conditions. When a dead lock occurs you  can't  move  the  mouse  pointer
  128. anymore or enter anything on the keyboard. These dead locks occur most of
  129. the time when other programs want to close a public screen.
  130.  
  131. Unfortunately there is no way to  circumvent  this  problem,  so  if  you
  132. experience dead locks with many of  your  normal  applications  then  you
  133. can't use ScreenNotify at all and MUST remove the screennotify.library.
  134.  
  135.  
  136. V. History
  137. ----------
  138.  
  139. 1.0 (26.03.1995)
  140.     - Initial release
  141.  
  142.  
  143. V. Other information
  144. --------------------
  145.  
  146. The programs in this package were developed using DICE 3.0. You will find
  147. the source codes in the directory  "src".  Use  "dmake"  to  compile  the
  148. programs.
  149.  
  150. Authors EMail address:
  151.  
  152.     stefanb@yello.ping.de
  153.  
  154. Authors postal address:
  155.  
  156.             Stefan Becker
  157.             Verkehrstrasse 11
  158.     D-44809 Bochum
  159.             GERMANY
  160.