==========================================================================
=    bscg: experimental binary-based static call graph generator         =
=          using DWARF2 debugging info.                                  = 
=    -- Copyright (c) 2003, gondow@jaist.ac.jp                           =
==========================================================================

Disclaimer:
-----------
    WARNING: this software is not completely tested.
    This software is intended to be useful, but it has no warranty.
    Use this software at your own risk. We disclaim any liability of any 
    kind of damages whatsoever resulting from the use of this software.

Overview:
---------
    This is the alpha version of dcg, an experimental static call graph
    generator using DWARF2 debugging information.
    `bscg' is still under development; 
    further debugging, testing, and refactoring are required.
    bscg requires `readelf+' and `dwarf2.dtd' to produce DWARF2-XML documents.

Platform:
---------
    Currently, we compiled and tested bscg in the following platform.

    - Solaris 8, GCC 3.0.2, GCC 3.3.2

Build and Installation:
------------
    Before do the following, please make sure that libxml2 is installed.

    To build, 

	% tar xvzf bscg-b2.tgz; cd bscg-b2
        % make

    To install, 
        % make install INSTALL_DIR=/somewhere/bscg/to/be/placed
        % set path = (/somewhere/bscg/to/be/placed $path)

Usage:
------
    	% gcc -gdwarf-2 foo.c
        % cp /somewhere/bscg/to/be/placed/dwarf2.dtd .
        % readelf+ -X a.out > foo.xml
    	% bscg a.out foo.xml > foo.dot
	% dot -Tgif foo.dot -o foo.gif

