Software    : Error Buddy
Version     : 2.1
Price       : free
Distribution: unrestricted

Copyright 1995, 1996, 1997, Pete Rowley
--- free, but not *that* free ---

I accept no liability for anything you
might do with Error Buddy, or the consequencies
of any such action.  However, to the best of
my knowledge Error Buddy is bug free unless
otherwise stated below.


About Error Buddy
----------------------------------------
If you are not a developer, and you do not
ever need to decode error codes reported by
software, then you do not need Error Buddy.

Error Buddy makes sense of those error
codes you keep getting back from
API calls.  Enter the error code in either
hex or decimal format and press return to
get a textual description of the error,
often along with the C macro definition
for that error.

Error Buddy currently supports the following
API's: Win32, MAPI, TAPI, Notes, LDAP,
DirectSound, DirectSetup, DirectPlay,
DirectInput, DirectDraw, and Winsock.

When you first run Error Buddy, you have to
tell it what translation DLLs to use.  Click
on the system menu and select translators.
Click on the add button, and make sure you
are in the Error Buddy sub-directory.  Select
all DLLs in the directory and click on open.
The translations you have installed will be
listed, click OK and start translating :)

Note, Error Buddy works out if the DLL is the
right kind, and will let you know if it isn't.
It is always safe to select all DLLs in a
sub-directory.

There two options you may change by selecting
options in the system menu.  You can make
Error Buddy assume every code is in hex, this
means you don't need to type 0x before the
number.  You can also decide how many error
codes are remembered in the combo box.

You can create new Error Tranlation DLL's
using the code template supplied.  These could
be for publicly available API's or for
proprietry API's for use within your company
only.

If you want contribute to Error Buddy (and
why wouldn't you, you got this free didn't
you?), you can do so by coding error translation
DLLs for APIs and protocols not already covered,
and sending them to me with a text file
giving permission to redistribute.  If you
do so, I'll credit you in this file along
with your email address if you say you want
it.  Oh, one more thing, it should work without
any little "side effects" before you send it :)

If you think Error Buddy is useful, share him
with your developer buddies - hey mention him
on your website, or just name your dog after
him.

Pete Rowley

Error Buddy currently doesn't really have
a website, but you might find something at:

http://people.netscape.com/rowley/ebud.html

Bug reports/suggestions to Pete.Rowley@bigfoot.com

Known bugs
----------

The Notes translator may incorrectly identify a code
as one it recognizes along with repeatable but seemingly
random text.  Status won't be fixed, this is a side effect
of Notes own translation utility and is due to the method
of storing error texts.

The Win32 translator can incorrectly identifies a code as
a success code.  Status: this happens on error codes which
are valid but do not conform to the specification for HRESULT e.g.
ERROR_INVALID_FUNCTION (0x1), ERROR_FILE_NOT_FOUND (0x2) etc.

----------

If a bug exists in a translation dll not written by
me, it may (read "will") be quicker to contact the
author directly:



Developer Credits
=================

Winsock         Marius Milner         mariusm@lucent.com



Revision History
================
Version		Date		Description
-------		----		-----------
2.1		10/6/97		Added interface code for adding translation DLLs.
				Added the following translation DLLs:
				DirectDraw
				DirectInput
				DirectPlay
				DirectSetup
				DirectSound
				LDAP
				Notes
				TAPI
2.0		23/4/97		New interface.  Now uses error translation Dlls, and can
				add error dlls users have written.
1.6R		14/10/96		First public release.  No proprietry error code support.
1.6		8/10/96		Special release which uses debug libraries to avoid conflict with
				the Unified Messenger Client.
1.5		22/7/96		Now uses new proprietry error codes
				Now keeps last 10 combo codes in registry
				Changed the tab order so the combo gets the focus
				Added useless tooltips
1.4		5/7/96		Now uses combo box to keep previous error codes
1.3		30/5/96		Added proprietry error translation
				Now displays all three error translations at once
1.1		29/1/96		Added MAPI translation
1.0		20/11/95		Original release