home *** CD-ROM | disk | FTP | other *** search
/ Carousel Volume 2 #1 / carousel.iso / mactosh / da / syserror.sit / SysErr.DOC next >
Text File  |  1988-02-29  |  5KB  |  98 lines
  1. You really don't need docs for SysErr DA, but...
  2.  
  3. (1) System Errors DA is free, but it is copyrighted by Bill Steinberg,
  4.     (me) 1988, and all commercial rights are reserved. The system
  5.     errors list it displays is from the MPW 2.0 SysErr.a file, and
  6.     is copyright by Apple Computer.
  7.  
  8. (2) System Errors DA is a standard DA. You install it with Font/DA Mover,
  9.     and it will work fine with Suitcase(tm) and everything else.
  10.  
  11. (3) System Errors DA displays a comprehensive list of all the Macintosh
  12.     errors. The window comes set for the proper width, and it autocenters
  13.     itself on your main screen. If you have a color mac2, it'll be in
  14.     color. On Macs with the extended adb keyboard, the home, end,
  15.     page up, page down, up arrow, and down arrow keys do what you would
  16.     expect them to. The return and enter keys "page down" the display on
  17.     all macs. When I get the keycodes for the up, down, right, and left
  18.     arrows on the mac plus, and find out what keys are available (and
  19.     what their codes are) on the smaller adb keyboard, I'll implement
  20.     them too. (Somebody want to send me the low WORD in evtMessage for
  21.     all the above keys, I'd appreciate it!)
  22.  
  23. (4) Better customization control. Though System Errors DA was designed to
  24.     display the system errors, it can display anything you want, up to
  25.     32K. You can also control where the window shows up, and what size
  26.     it is. You can control what font is used, what size the font is, and
  27.     whether the text word wraps or not. You can even change the title
  28.     in the window, the name of the DA in the apple menu, and the colors
  29.     of the window and scrollbar.  You'll have to be able to edit
  30.     resources with ResEdit to make any of these customizations, and I'm
  31.     not going to hold your hand in this document and teach you about
  32.     resources and how to use ResEdit, however, if you already know how...
  33.  
  34.     (A) The 'WIND' resource:  You can change the DA window title.
  35.     You can also change the window size and position as follows:
  36.     If the window top or left is anything but 0, the DA assumes
  37.     all 4 window coordinates (top, left, bottom, and right) are
  38.     correct, and doesn't try and size or position the window,
  39.     except to size the bottom in a bit if necessary to make the
  40.     window height an even multiple of the teLineHite. Ergo, if
  41.     you want the window to show up in a specific place, you
  42.     gotta change all 4 window coordinates to what you want.
  43.     If you leave the topLeft window coordinates at 0,0, the
  44.     DA will start helping you; the bottom and right coordinates
  45.     then become height and width parameters, and the DA autocenters
  46.     the window in your main screen. If you leave either the
  47.     bottom or the right parameters 0 too, (or both) the DA will
  48.     autosize that dimension for you as well as autocentering it.
  49.     For example, System Errors DA comes set with window coordinates
  50.     of 0,0,0,470.  This means the window will be autocentered
  51.     in both the vertical and horizontal planes, (the initial
  52.     topLeft of 0,0), it will be autosized to just fit your main
  53.     screen in the vertical plane (the next 0, which is the
  54.     bottom parameter, which is height since the topLeft was
  55.     0,0), and the window will have a width of 470 pixels (the
  56.     final, or right parameter).
  57.  
  58.     (B) The 'wctb' resource: You can change the window colors.
  59.     
  60.     (C) The 'cctb' resource: You can change the scrollbar colors.
  61.     
  62.     (D) The 'Info' resource: The Info resource holds two words and a
  63.     boolean (a byte). The first word in resource holds the
  64.     font number to be used (default is monaco, #4). The second
  65.     word holds the font size to be used (default is 9). The
  66.     final byte is a boolean flag for word wrap. The default is
  67.     0 (false), for no word wrap. If you put anything but 0 in
  68.     that byte (= true), the text will word wrap in the window.
  69.  
  70.     (E) The 'DRVR' resource: You can change the resource NAME to
  71.     have whatever name you want in the Apple menu.
  72.  
  73.     (F) The 'TEXT' resource: This contains the text of what is dis-
  74.     played in the window. It is nothing more than plain text
  75.     with carriage returns. (8-bit Macintosh text is fine; you
  76.     can use all those weird characters if you like, like I did
  77.     with the 'bullet' characters, which are option-8). Note that
  78.     there are no length bytes preceding any of the text, nor
  79.     are there any special terminating bytes. (IE The text is
  80.     just text, not Pascal or C strings). Since text edit is
  81.     used to display the text, carriage returns are significant,
  82.     but tabs and other formatting characters are not, and you
  83.     are limited to 32K of text.
  84.  
  85. CHANGES LOG:
  86.  
  87. 1.1 - First Public Release
  88. 1.2 - Fixed Bug in screen height routine (DIVU uses a LONG in the dest...)
  89. 1.3 - Keyboard support, squarer corners in window, better customizing.
  90.  
  91. Bill Steinberg - Monday, February 29, 1988
  92.  
  93. CompuServe - 76703,1027
  94. AppleLink  - X0542
  95. Delphi     - BillS
  96. MacNet     - BillS
  97. GEnie      - BillS
  98.