_______________________________________________________________________________
_______________________________________________________________________________

  Readme for Exceptq v7.1 

  Portions of Exceptq are
    Copyright (c) 2000-2010 Steven Levine and Associates, Inc.
    Copyright (c) 2010-2011 Richard L Walsh
  The remainder of Exceptq is
    Copyright (c) 1992-2000 Marc Fiammante et al.

_______________________________________________________________________________

  Contents
_______________________________________________________________________________

  * Overview
  * Options
  * Installation
  * Files

_______________________________________________________________________________

  Overview
_______________________________________________________________________________

Exceptq v7.1 creates a debugging report whenever a program that uses it
encounters a fatal exception (i.e. the app crashes).  Programmers can
also use it to generate debugging reports while the app is running.

It emits a two-tone beep, then generates the report and puts it in the
directory containing the .exe that crashed.  The name is based on the
IDs of the process and thread that encountered the problem.  For example,
'006C_01.TRP' describes a trap in process 6C, thread 1.

Reports are typically 10-30k - small enough that it should be easy to
email them to the program's author, even on dialup.  Most of the info
they contain is of little value to the user.  However, you may want to
examine the last section, "DLLs accessible from this process", to see
if a dll was loaded from an incorrect or unexpected directory.

If you have any questions about Exceptq v7.1 - or any problems with it,
please contact:

  Rich Walsh <rich@e-vertise.com>
or
  Steven Levine <steve53@earthlink.net>

_______________________________________________________________________________

  Options
_______________________________________________________________________________

Exceptq v7.1 offers several options that can be controlled by setting
the environment variable "EXCEPTQ";  the options are not case-sensitive.

Beeps
-----
The beep is intended to remind you that there's an exception report
available that you can send to the program's author.  If it bothers
you, add "SET EXCEPTQ=Q" to config.sys.

  B     "beep" [default]
  Q     "quiet"

Generate Report
---------------
Use this to disable Exceptq for a particular program while leaving it
available for other apps.  You may need this if an app is so unstable
that the reports are more of an annoyance than a help.  This option
should be added to a .cmd file used to start the app, not config.sys.

  Y     "yes" [default]
  N     "no"

Generate Debugging Report
-------------------------
Developers can include code that forces Exceptq to create a report while
the program is running without having to wait for a crash.  This feature
is normally disabled but a developer may ask you to enable it using this
option.

  D     "debug & fatal exceptions"
  F     "fatal exceptions only" [default]

_______________________________________________________________________________

  Installation
_______________________________________________________________________________

Installation is simple:  copy the two dlls and the xqs file to a directory
on your LIBPATH so that all apps that use Exceptq share the same files.

If you have copies of older versions of Exceptq, please remove them
(users of MR2I and FM/2 may have copies in those directories).  Apps
designed to work with earlier versions will work better with v7.1
(it's much faster) while new apps that expect v7.x will be unable to
use those older versions.

_______________________________________________________________________________

  Files
_______________________________________________________________________________

The users' distribution of Exceptq v7.1 (exceptq71.zip) contains these files:

  exceptq.dll         the exception handler dll
  exceptq.xqs         exceptq's public symbols
  distorm.dll         the disassember used by exceptq
  distorm.xqs         distrom's public symbols
  readme.exceptq      this file

A developers' distribution (exceptq71-dev.zip) containing files and info
needed to add Exceptq support to an application is also available.

_______________________________________________________________________________

Rich Walsh <rich@e-vertise.com>
March 1, 2011
_______________________________________________________________________________

