home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga 13 / MA_Cover_13.bin / source / c / stefanb_src / toolmanager / readme.alpha < prev    next >
Encoding:
Text File  |  1997-02-22  |  6.0 KB  |  150 lines
  1. ToolManager 3.0 Alpha 3                                       28-Oct-1996
  2.  
  3.    THIS IS AN ALPHA RELEASE! SOME FEATURES ARE NOT IMPLEMENTED YET!
  4.  
  5.       --->>> REDISTRIBUTION OF THESE FILES IS FORBIDDEN! <<<---
  6.  
  7.  
  8. Installation
  9.  
  10.     Copy  Libs/toolmanager.library                      to  LIBS:
  11.     Copy  Prefs/ToolManager                             to  SYS:Prefs
  12.     Copy  WBStartup/ToolManager                         to  SYS:WBStartup
  13.     Copy  Locale/Catalogs/deutsch/toolmanager*.catalog  to  LOCALE:...
  14.  
  15.     Please quit any running ToolManager 2.x programs. The old and the new
  16.     version can't run in  parallel!
  17.  
  18.     Start    the    program    "Prefs/Converter".    It     will     read
  19.     ENVARC:ToolManager.prefs  and  write  the  new  preferences  file  to
  20.     ENVARC:ToolManager.prefs.new. Save your old  ENVARC:ToolManager.prefs
  21.     file, rename the new file to ENVARC:ToolManager.prefs and copy it  to
  22.     ENV:.
  23.  
  24.  
  25. Requirements
  26.  
  27.     - OS 3.x or better
  28.     - WBStart 2.0 or better
  29.     - DOSPath 1.0 or better
  30.     - (optional) ScreenNotify 1.0
  31.     - (optional) Sushi
  32.  
  33.  
  34. Changed features since 2.1b:
  35.  
  36.     - General:       Again rewritten (almost) from scratch :-)
  37.     - General:       Old object system removed, TM objects are now BOOPSI
  38.                      objects
  39.     - Memory:        Uses memory pools now (not in debug version)
  40.     - Exec Objects:  Delay parameter removed
  41.     - Image Objects: Animation support removed
  42.     - Image Objects: picture.datatype V43 support added
  43.     - Icon Objects:  Only icons supported
  44.     - Dock Objects:  Only images supported
  45.     - Dock Objects:  Pattern & Vertical flags removed
  46.     - Dock Objects:  Title parameter removed
  47.     - Dock Objects:  Image flag added, dock objects can display text & image
  48.     - Dock Objects:  Border flag added, object name used for window title
  49.     - Dock Objects:  Dragbar gadget removed for borderless windows.
  50.     - Group/Button/
  51.       Entry classes: New classes which build the contents of the dock windows
  52.     - Group:         This is the actual content of a dock. It is a BOOPSI
  53.                      gadget and might be exportable through the library
  54.                      interface to create "tool bars" in programs
  55.     - Button:        Each dock entry contains now a frame. The graphics for
  56.                      dock entries have (probably) to be redesigned
  57.     - Entry:         Displays text and/or image
  58.     - Config:        New preferences file format, hopefully more flexible
  59.     - Config:        Events are now checked while the configuration is read.
  60.                      This improves the responsiveness in startup/config change
  61.     - ScreenNotify:  All dock objects get the notification, not only the global
  62.                      ones.
  63.     - CLIStart:      dospath.library support added.
  64.     - Cmdline:       Command lines are not limited to 4KB anymore.
  65.     - Prefs:         Rewritten from scratch
  66.     - Prefs:         Now a MUI application. Benefits:
  67.                        * Resizable windows
  68.                        * Multiple open windows
  69.                        * Drag&Drop
  70.     - Prefs:         Changing an objects name automatically updates all
  71.                      references to the object.
  72.     - Prefs:         Support for grouping objects.
  73.  
  74.     plus everything I might have forgotten...
  75.  
  76.     Please read also the file Source/History!
  77.  
  78.  
  79. Not yet implemented features:
  80.  
  81.     See file Source/TODO
  82.  
  83.  
  84. Debugging information:
  85.  
  86.     The debugging information is printed using kprintf(). Sushi should be
  87.     installed to record this information. The programs read the  contents
  88.     of the following environment variables  to  enable/disable  debugging
  89.     information. Error information can't be disabled.
  90.  
  91.         Library         ToolManagerLibDebug
  92.         Preferences     ToolManagerPrefsDebug
  93.         Converter       ToolManagerConverterDebug
  94.         Starter         ToolManagerStarterDebug
  95.  
  96.     The following number formats are currently supported:
  97.  
  98.         X<hex digits (0-9, A-F)>
  99.  
  100.         Y<binary digits (0, 1)>
  101.  
  102.     Example:
  103.  
  104.         setenv ToolManagerLibDebug X20800
  105.  
  106.     to set library debug flags 11 and 17.
  107.  
  108.     Available debug flags:
  109.  
  110.      Bit |   Hex   | Library        | Converter      | Preferences
  111.     ---------------------------------------------------------------
  112.        0 |       1 | INTERFACE      | MAIN           | STARTUP
  113.        1 |       2 | MEMORY         | MEMORY         | MEMORY
  114.        2 |       4 | HANDLER        | SCAN           | LOCALE
  115.        3 |       8 | TMHANDLE       | EXEC           | MAINWINDOW
  116.        4 |      10 | COMMANDS       | IMAGE          | LISTPANEL
  117.        5 |      20 | BASECLASS      | SOUND          | LISTTREE
  118.        6 |      40 | EXECCLASS      | MENU           | BASE
  119.        7 |      80 | IMAGECLASS     | ICON           | EXEC
  120.        8 |     100 | SOUNDCLASS     | DOCK           | IMAGE
  121.        9 |     200 | MENUCLASS      | ACCESS         | SOUND
  122.       10 |     400 | ICONCLASS      | MISC           | MENU
  123.       11 |     800 | DOCKCLASS      |                | ICON
  124.       12 |    1000 | CONFIG         |                | DOCK
  125.       13 |    2000 | GLOBAL         |                | ACCESS
  126.       14 |    4000 | IDCMP          |                | GROUP
  127.       15 |    8000 | COMMODITIES    |                | CONFIG
  128.       16 |   10000 | APPMSGS        |                | GLOBAL
  129.       17 |   20000 | NETWORK        |                | POPASL
  130.       18 |   40000 | SCREEN         |                | DROPAREA
  131.       19 |   80000 | CLISTART       |                | ENTRYLIST
  132.       20 |  100000 | WBSTART        |                | ENTRIES
  133.       21 |  200000 | AREXX          |                | MISC
  134.       22 |  400000 | CMDLINE        |                | CLIPWINDOW
  135.       23 |  800000 | GROUPCLASS     |                | CLIPLIST
  136.       24 | 1000000 | BUTTONCLASS    |                |
  137.       25 | 2000000 | ENTRYCLASS     |                |
  138.       26 | 2000000 | LOCALE         |                |
  139.  
  140.     The starter has only one flag: MAIN, Bit 0, Hex 1
  141.  
  142. For further information please read the History file.
  143. Send your comments & bug reports to:
  144.  
  145.    stefanb@yello.ping.de
  146.  
  147. Regards,
  148.  
  149.    Stefan
  150.