readme.txt

一个异常处理的类

	ExceptionalMagic for Delphi3,4,5 & C++Builder 4,5
		(c) 1999-2000, Dmitriy Gremyakov
              e-mail: [e-mail] 

			
CONTENTS
========

1. OVERVIEW
2. REGISTRATION
3. INSTALLATION
4. CONTACT INFORMATION


1.OVERVIEW
==========


ExceptionalMagic is shareware unit for use with Inprise Delphi 3,4,5 and
C++ Builder 4,5. This unit replaces standard exception handling behaviour 
with much more controlled and informative one. It allows you to customize 
many aspects of exception handling and provides a lot of useful info and 
features: 

	+ location of exception in source (file name & line number) 
	+ call-stack information (module name & proc name)
	+ contents of CPU registers and stack 
	+ custom formatting of error message 
	+ custom displaying of error message 
	+ write exception information into log file 

Recommended usage:

1. Add ExcMagic into 'uses' clause in your project main source file.
2. Compile and link your project with stack frames and debug info turned ON.
   Also turn on 'include TD32 debug info' linker option.
3. Run TDSPack utility with options -a -o -p -e to strip debug information from
   executable file, optimize it, pack and then append to executable file. 
4. Thats all. 

Step 3 is not necessary for ExceptionalMagic, but it's strange at any rate
to distribute your executable with debug-info. There are a lot of curious guys
with TurboDebugger...

If you want to minimize size of distributed debuginfo you can use tdspack
with -n option (in conjunction with -o). tdspack will remove any information
about procedures (and their names) from debuginfo. Resulting debuginfo will
contain only sources filenames and linenumbers that's much smaller.

For more information see file Help\ExcMagic.chm


2. REGISTRATION
===============

ExceptionalMagic is shareware. You must read and accept the terms detailed 
in the license.txt file before you can use this component. You may register
on-line via link on ExceptionalMagic author site (http://dimus.virtualave.net)

Registered users will receive full (non-limited) version of ExceptionalMagic
unit via e-mail (with or w/o sources). 

Registration also gives you lifetime support and free of charge upgrades to
all further versions of ExceptionalMagic unit. 



3. INSTALLATION
===============

There is no special installation procedure. Units directory contains
subdirectories for all supported compilers - just copy files from 
subdirectory corresponding to your compiler into your project source 
directory or any other directory within your project 'Search path'. 


4. CONTACT INFORMATION
======================

Comments, questions and suggestions regarding ExceptionalMagic can be 
directed by e-mail to [e-mail]


Dmitriy Gremyakov
http://dimus.virtualave.net