home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 633.lha / PublicScreen_v1.02.08 / PublicScreen.doc.pp / PublicScreen.doc
Text File  |  1992-05-17  |  7KB  |  131 lines
  1.  
  2. PublicScreen.doc :  PublicScreen 1.02.08  (Release 1, rev 2 minor rev 7)
  3. ===============================================================================
  4. Copyright ©1992 Edward D. Berger, freely redistributable.
  5.  
  6. What is a Public Screen?
  7. ===============================================================================
  8. Public Screens are new Amiga Screens that can have program windows on them,
  9. instead of the Workbench Screen, allowing you to avoid shuffling windows around
  10. the Workbench Screen in order to get to your Icons. A good use of this would be
  11. for opening a public screen and putting both an Amiga Shell Window and a Clock
  12. Window, as a CLI work environment, leaving Workbench available for file/icon
  13. manipulation.
  14.  
  15.  
  16. ***********************************************
  17. * WARNING!! WARNING!!  DANGER WILL ROBINSON!! *
  18. ***********************************************
  19. 1.) Do NOT try to close a PublicScreen Screen any way other than by
  20. selecting its menu item, or you will crash your Amiga!
  21.     (Other public screen programs are not aware of our menu window.)
  22.  
  23. 2.) PublicScreen may not find ALL programs that use its screen, and therefore
  24. not shutdown properly, resulting in an ill/crashed Amiga.
  25.     (OK, I found 1 old program that caused this behavior...)
  26.  
  27. REQUIREMENTS:
  28. ===============================================================================
  29. Amiga OS 2.04 (v37 system libraries) is required to use PublicScreen.
  30.  
  31. USAGE INSTRUCTIONS:
  32. ===============================================================================
  33. CLI Usage:       PublicScreen <ScreenName>   (defaults to PublicScreen.1 etc.)
  34. Workbench Usage: Double Click on icon (what else?)
  35.  
  36. Installation: PublicScreen expects to find the following programs/files
  37.                 S:PublicScreen-Startup  (a startup script for the shell menu item)
  38.                 PublicScreen (in the current dir or C: [I have no paths])
  39.                 C:ED (the standard AmigaOS 2.04 Editor)
  40.                 SYS:Tools/memacs (the standard AmigaOS 2.04 memacs editor)
  41.                 SYS:Utilities/clock (the standard AmigaOS 2.04 clock)
  42.                 SYS:Tools/Calculator
  43.  
  44. About the Tools Menu:
  45.               These are currently hardcoded values, through use of some C string
  46.               manipulation, I directly supply ED and SHELL with CON:specs that
  47.               substitute the current screen, for the SCREEN keyword argument.
  48.               CLOCK, CALCULATOR, and MEMACS are SHANGHAI'd by setting that mode
  49.               silently, launching the program and waiting half a second, before
  50.               returning default/shanghai back to their previous off status.  In
  51.               A user configurable version, I will probably have a settable DELAY
  52.               value, for people with slow machines.
  53.  
  54.               In a future release I hope to make this tools menu(s) configurable,
  55.               I just wanted to give something out now that was more usable than
  56.               the previous releases of PublicScreen.
  57.  
  58. Description:  PublicScreen simply opens a Public Screen with the same attributes
  59.               as your workbench screen, (Same Font, Same Screenmode, etc.)
  60.               and stays open until you select the menu item to close the screen.
  61.               (If it finds no other programs using the screen. See Warning above.)
  62.  
  63.               I have included a basic Tools Menu, so you can launch a shell,
  64.               ed-editor, memacs-editor, clock, and/or calculator windows on
  65.               your newly opened public screens.
  66.  
  67.               PublicScreen has menu items on the public screen for default mode.
  68.               On a 512K CHIP amiga approx 12 non-interlaced public screens can
  69.               be opened, or 6 interlaced ones.  These numbers increase with
  70.               1M CHIP and 2M CHIP machines. Machines with ECS should be able to
  71.               open public screens in Productivity or SuperHires modes, if that is
  72.               how their workbench screen is configured.
  73.  
  74. Requirements: AmigaOS Release 2.04 (v37)
  75.  
  76. Known BUGS:  YES!
  77.  
  78. Revision History:
  79.   REV 1.01: first usable version - alpha released 04/08/92
  80.   REV 1.02: changed default behavior for CLI to match workbench - not released
  81.   REV 1.03: reorganized some code, etc. - not released
  82.   REV 1.04: basic Menu functionality Added -alpha released 04/09/92
  83.   REV 1.05: fixed "leave shanghai/popup mode on" bug - not released
  84.   REV 1.06: added autoname function code both CLI (no-args) and Workbench
  85.   REV 2.00: RELEASED for general consumption   04/10/92
  86.   REV 2.02: changed process name from "Background_Process" to "PublicScreen" 04/12/92
  87.             (was quite rude, not giving our real name, could be suspected as virus...)
  88.             added Command Template for CLI "PublicScreen ?"  04/12/92
  89.             fixed another "leave shanghai/popup mode on" bug 04/12/92
  90.   REV 2.03: added 'low CHIP ram' to Error requester and updated docs 04/12/92
  91.   REV 2.04: added menu item for New PublicScreen (buggy implementation) 04/14/92
  92.             added cli warning message for 1.3 lusers                    04/14/92 not released
  93.   REV 2.05: looking into adding startup file design and calling modes   04/15/92 not released
  94.             changing CLI template to SCREENAME,FROM/K:
  95.             for SCREENAME=<name_of_screen> and FROM=<startup_file>
  96.             rearranging some code, increasing number and clarity of comments
  97.             since there will be a lot of changes coming.
  98.   REV 2.06: added basic CLI based program launching, and Tools Menu     04/17/92 not released
  99.             fixed bug with CON: opening with wrong font, used wrong screentag, Sorry!!
  100.             replaced some SAS/C specific code with something more portable. 04/19/92 not released
  101.   REV 2.07  Got SCREEN independent program launching working... Yeah! 04/21/92 RELEASED
  102.   REV 2.08  Changed ED commandline to have a proper close gadget, oops!
  103.             Changed CLOCK commandline to be over more to left (fit on no-overscan screens)
  104. FUTURE:
  105.   Rev 3 and Beyond:
  106.    - Add a user configurable menu for launching programs so that once a public
  107.      screen is popped up, it is immediately usable, without switching screens.
  108.      SCREENMODE/Font selection support?
  109.  
  110.    - Add user configurable option to automatically start various programs when
  111.      publicscreen is opened.
  112.  
  113.    - Add External (arexx?) Support to 1.)Close Screen
  114.                                       2.)Bring Screen to Front
  115.                                       3.)Push Screen to Back
  116.                                       4.)Open other screens?
  117.  
  118.    - Get closer to the 'ideal application' in Amiga User Interface Style Guide.
  119.  
  120.   Anyone want to create a better Icon?
  121.   Write Some utilities with JUMP gadgets?
  122.  
  123. NOTICE TO OTHER PROGRAMMERS:
  124. --------------------------------------------------------
  125. PLEASE make your programs Public Screen aware, and font sensitive.
  126.  
  127. -Ed Berger
  128.  internet: eberger@psc.edu
  129.            eb15@andrew.cmu.edu
  130.  
  131.