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