home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 4 / CDPD_IV.bin / fish / 931-950 / ff934 / publicmanager / publicmanager.doc < prev    next >
Text File  |  1993-12-22  |  8KB  |  264 lines
  1.  
  2.  
  3.  
  4.     PublicManager V1.4
  5.  
  6.  
  7.  
  8.     ©    1993 by Michael Watzl
  9.     
  10.     freely distributable as long as no profit is made with this
  11.     program and all documents are included to the distribution.
  12.     If you want to use this program as a part of a commercial
  13.     distribution you have to ask me first!
  14.  
  15.     PublicManager is written with SAS/C 6.2
  16.  
  17.     >OS 2.04 only!
  18.  
  19.  
  20. Read this fictive interview and you know everything about
  21. PublicManager or simply skip it.
  22.  
  23. User: What does your new PublicManager do?
  24. Mike: Well, the PublicManager makes it easy to work with public
  25.       screens.
  26. User: Hey, Mike! There are already tools which handle public
  27.       screens like PSX.
  28. Mike: Yes, there are. But none of them has its own menu, in
  29.       which the user can configure nearly everything which is
  30.       possible.
  31. User: Ok. But do you really need such a tool. I mean - it just
  32.       opens a screen and "shanghai"s around if you want, and you
  33.       may make some programs open their windows on this screen.
  34.       Isn't it a litte bit USELESS?!
  35. Mike: Well, I don't think so. Look, if you use the new features of
  36.       Kickstart 2.0 like other fonts, new displaymodes, and and
  37.       and, a lot of programs, tools and utilities do not support
  38.       the new features: their GUI (graphical user interface) looks
  39.       awful or they just won't open another screen than PAL:HIRES
  40.       (flicker, flicker). Now you can use bigger fonts in WB, and
  41.       open a PublicManager-Screen with topaz 8 font (maybe in
  42.       productivity or ntsc:hires) grabbing all the applications
  43.       windows that wanted to open on the Workbench. Your Workbench
  44.       remains clean AND the tool's window is ok. But this is only
  45.       one aspekt: with PublicManager V1.4 you can also configure a
  46.       tools-menu.
  47. User: Ok, ok. But there are much better tools allowing me to
  48.       configure my menus like the great ToolManager V2.0.
  49. Mike: Yes, you are right. But it wasn't my intention to write
  50.       program like the toolmanager. The original intention was to 
  51.       create a utility which makes it easy for everyone to handle
  52.       public screens and the toolsmenu is just a useful "goodie".
  53. User: Yeah, let's try it out!
  54.       Well, maybe I'll write a little letter with bug reports,
  55.       suggestions, congratulations, ...
  56.  
  57. ---------------------------------------------------------------------
  58.  
  59.  
  60. A short walk through the menus:
  61.  
  62.  
  63. 1. Project:    
  64. ===========
  65.  
  66. Update Screen
  67.  
  68. Tries to close the public screen and reopen it.
  69. This is only possible when no visitor windows are on the screen.
  70.  
  71. Update Modes
  72.  
  73. Since there are other tools modifying the public screen flags and
  74. probably setting another default public screen you can update your
  75. selected modes. The modes shown by the checkmarks in the public
  76. mode window are used.
  77.  
  78. Toggle Workbench
  79.  
  80. Tries to close the workbench screen. This will save chip memory.
  81. (Works only if there are no application windows on the wb screen)
  82.  
  83. About
  84.  
  85. Some information about the author, the number of visitors on this
  86. screen, ... 
  87.  
  88. Save Prefs
  89.  
  90. Saves the selected options as 'Publicmanager.prefs' in the home
  91. directory of the main program. PublicManager no longer should be
  92. started from workbench.
  93.  
  94. Quit
  95.  
  96. Closes the screen and exits.
  97. This is only possible if there is no other window on this screen.
  98.  
  99.  
  100. 2. Preferences
  101. ==============
  102.  
  103. Public Modes...
  104. ---------------
  105.  
  106.     Opens a window with 3 checkbox gadgets.
  107.  
  108.     - Default Publicscreen
  109.     
  110.         If selected it makes the PublicManager screen to the
  111.         default public screen. If not the workbench screen
  112.         will be the default public screen.
  113.         
  114.     - Pop publicscreen to front    
  115.     
  116.         Sets the POPPUBSCREEN flag. This means that the public
  117.         screen will be brought to front if a window opens on it.
  118.         
  119.     - Shanghai    
  120.     
  121.         Sets the SHANGHAI flag. All the windows (like shell window,
  122.         application windows which would open on wb, ...) will appear
  123.         on the default public screen.
  124.         
  125. Public Name...        
  126. --------------
  127.  
  128.     Here you can specify the public screen name. With this name you    
  129.     can force windows to open on this screen although the shanghai flag
  130.     is not set, e.g. 'NewShell CON:0/0/640/200/PublicShell/SCREEN<name>'
  131.     
  132. Palette...    
  133. ----------
  134.  
  135.     Opens a palette requester.
  136.     
  137. Screenmode...
  138. -------------
  139.  
  140.     Opens the screenmode requester (lores is no longer supported).    
  141.     
  142. Font...
  143. -------
  144.         
  145.     Opens the font requester.
  146.     
  147. Menus...
  148. --------    
  149.  
  150.     Opens the Menu configuration window.
  151.     (See below)
  152.     
  153.  
  154.  
  155.  
  156. 3. Configuring the Menus
  157. ========================
  158.  
  159. a) Menus (left side)
  160. --------------------
  161.  
  162.     Gadgets:
  163.     --------
  164.     
  165.     New         Creates a new menu named 'new menu'.
  166.     Edit        Opens the 'edit menu' window.
  167.                 (the window can also be opened by doubleclicking
  168.                 a menu name)
  169.     Up          Moves the active menu one step upwards (if possible).
  170.     Down        Moves the active menu one step downwards (if possible).
  171.     Remove      Removes the active menu.
  172.     Sort        Sorts the list of menus.
  173.     
  174.     
  175.     Edit window:
  176.     ------------
  177.     
  178.     Name        Here you can edit the menu title.
  179.     Disable     If selected the menu (and all the items) appear 
  180.                 disabled (ghosted).
  181.                 
  182.                 
  183. b) Items
  184. --------
  185.  
  186.     Gadgets:    (also accessable via SHIFT + underscored key)
  187.     --------
  188.     
  189.     New to Sort is the same as above.
  190.     
  191.     Barlabel    Appends a barlabel to the items list.
  192.     
  193.     
  194.     Edit window:
  195.     ------------
  196.     
  197.     Alias       The name which will appear in the menu.
  198.     Name        string gadget:
  199.                     Name can be manually edited.
  200.                 button gadget:
  201.                     Opens a file requester. If a file has
  202.                     been selected the filepart will be used
  203.                     for the alias and name gadget; the 
  204.                     path will be used for the driectory.    
  205.                     If there is an icon the stack will also
  206.                     be set to this value.
  207.     Directory   string gadget:
  208.                     Directory can be manually edited.
  209.                 button gadget:    
  210.                     Opens a directory requester. The selected
  211.                     directory name will be copied to the
  212.                     string gadget.
  213.     Arguments   Here you can insert special arguments for this                
  214.                 application.
  215.                     Example:
  216.                     Name:   Newshell
  217.                     Args:   CON:0/0/640/200/SpecialShell
  218.     Disabled    If selected the application's name will appear
  219.                 ghosted in the menu.
  220.                 
  221.  
  222. -----------------------------------------------------------------
  223.  
  224. CHANGES:
  225.  
  226. V1.2        First release as FD.
  227. V1.3        Internal revision:
  228.             - Editing tools with GUI
  229.             - Configuration via tooltypes dropped
  230.               Now it I use a .prefs file in the current
  231.               directory.
  232.             - Internal changes (lots of work...)  
  233. V1.4        BIG rewirte:            
  234.             - Only dynamically handled lists
  235.             - Packer (ByteRun0) for configuration files
  236.               (Don't like saving 000000000000...)
  237.             - No more Enforcer hits (I hope so :-) )
  238.             - More than one menu supported
  239.             - Easy to use configuration via GUI
  240.             - 'Toggle Workbench' added
  241.  
  242. TODO:
  243.             - Patching the OpenWindow / OpenWindowTagList
  244.               for local shanghais.
  245.               It nearly works but it is not yet usable.
  246.               What it does: 
  247.                 Shanghais windows by name
  248.             - Backgroud graphic...    
  249.                     
  250. -----------------------------------------------------------------
  251.  
  252. If you find this tool useful, be happy. If you don't, throw it
  253. away. If you find any bugs or if you have any suggestions for the
  254. next version please let me know.
  255.  
  256. Michael Watzl
  257. Konradstr. 11
  258. W-8850 Donauwörth
  259. Germany
  260.  
  261. Tel.: (Germany) 0906 / 5834
  262.  
  263. Support shareware!
  264.