		      DPCpp Version 1.0 
                      ------------------
		For Windows NT and Windows 95
		     Copyright 1998,1999

   A Tool For Design Pattern Identification in C++ Software Systems
   ----------------------------------------------------------------
			Developers:
		Dr. Jagdish Bansiya and Anshumali
		   Email: jbansiya@cs.uah.edu
                   Web : http://indus.cs.uah.edu
	
About DPcpp
-----------	
The design pattern tool allows you to reverse-engineer an existing 
system and view its structure and implemented concepts/patterns.

!! This product is a beta version and provides limited functionality.!!

Here are the steps to use this product. The product is delivered as a
Windows zip (winzip) file and is called dptool.zip.


To Install the programs:
------------------------

-- Run a winzip to extract the files. On extraction a directory 
called 'DPTool' is created.

-- The Dptool directory contains following files and directories:

Dpcpp.exe 	- The executable file
Readme.txt	- Tool readme
Release.doc     - DPcpp description, WORD 6.0 document
Release.txt     - DPcpp description, text version
MSBSC50.dll 	- Dll used by Dpcpp.exe,  needs to be in search path.
Dphelper.exe 	- Used by Dpcpp.exe, needs to be in search path.
Dpcpp.hlp 	- Help file
CoolInterp.Bsc 	- Sample browser file
CoolInterp2.bsc - Sample browser file
afxwin50.bat 	- Batch file to create an afxwin50.bsc. This will need
		- that the 'path' and 'include' have references to MFC.
afxwin50 <dir>  - Contains source code for afxwin50.
CoolInterp <dir>- Contains source code for CoolInterp sample
CoolInterp2 <dir> - Contains source code for CoolInterp2 sample


The source code for samples have been provided because Dpcpp
refers to the source code during run-time. Since the path for 
afxwin.h could be different on different machines, it is necessary
to run afxwin50.bat to create afxwin50.bsc.  


Set System Search Path
------------------
NOTE 1: !!! Since DPcpp uses Dphelper.exe and msbsc50.dll, the system 
search path should have these two files in the system path. !!!


To use the tool:
----------------
1> Run Dpcpp. 

2> Use File - Open (also the first icon on the toolbar) to open
   a .bsc file. Select one of the .bsc files. A Text view is 
   created informing you that the system is processing the file.
   Wait till you see the 'Processing Complete' message.

3> A Tree View and a Graph View is displayed. The Tree View
   displays the Class Hierarchy of the program. To get more
   information on a class, click left mouse button on one of the 
   class-items. The attributes declared for this class are
   displayed in the Text view.

4> The Graph View shows the class hierarchy in a graphical form. This
   view is central to visualization and is used for all diagrams.

5> To view the system design click on the Graphical icons on the 
   tool-bar. Different representations of the model are displayed.
   'Clusters' detected in the system are displayed. One of the icons
   also displays the composite pattern detected in the tool. 

6> To open another .bsc file , select File - Open.

7> To use afxwin50 data, run afxwin50.bat. This will create afxwin50.bsc
file. You may get a Linker error, ignore it. Run Dpcpp again and open
axwin50.bsc.

NOTE: Read the Release.doc or Release.txt file for more 
information and description about the tool. These documents
also describe how you can run this tool on your source code.


Primrary Contact for information about the product:
---------------------------------------------------
Dr. Jagdish Bansiya and Anshumali
Email: jbansiya@cs.uah.edu
Web : http://indus.cs.uah.edu
Phone: 205-890-7317





