Newsgroups: comp.os.linux.announce
From: Eckehard Stolz <stolz@informatik.tu-muenchen.de>
Subject: C-BAT 0.1m (C-Browsing and Analysis Toolkit) available
Message-ID: <1994Mar15.041121.20298@cs.cornell.edu>
Date: Tue, 15 Mar 1994 04:11:21 GMT
Approved: linux-announce@tc.cornell.edu (Matt Welsh)

Hi !

Here is the announcment of C-BAT 0.1m (C-Browsing and Analysis Toolkit)
It is still ALPHA-code, but it might be useful for some of you.. You can
use it to investigate compilable C-code, view calltree-structures, ...
There is a function-interface for adding browsing capabilities to your
favorite programming enviroment (see README below).

C-BAT is available at:

ftp.informatik.tu-muenchen.de

/pub/comp/os/linux/local/ALPHA/c-bat

files:

c-bat-0.1m.tar.gz       main browser archive
c-bat-cc-2.4.5.tar.gz   precompiled GCC 2.4.5
c-bat-cc-2.5.8.tar.gz   precompiled GCC 2.5.8


cu

Eckehard Stolz

stolz@informatik.tu-muenchen.de
stolz@fiffi.sta.sub.org


LSM-Entry
Begin2
Title        = C Browsing and Analysis Toolkit
Version      = 0.1m (ALPHA)
Desc1        = c-bat creates browsing information during compile time. A server 
Desc2        = answers information requests from client-applications (like: "where
Desc3        = is function defined", "which functions call a function", "who uses 
Desc4        = var. x", ...). Browsing capabilities can be added to own programs
Desc5        = using provided functions. Some sample clients included.
Author       = Eckehard Stolz
AuthorEmail  = stolz@fiffi.sta.sub.org
Maintainer   = Eckehard Stolz
MaintEmail   = stolz@fiffi.sta.sub.org
Site1        = ftp.informatik.tu-muenchen.de
Path1        = /pub/comp/os/linux/local/ALPHA/c-bat
File1        = c-bat-0.1m.tar.gz
FileSize1    = 122449 Bytes
File2        = c-bat-cc-2.4.5.tar.gz
FileSize2    = 663493 Bytes
File3        = c-bat-cc-2.5.8.tar.gz
FileSize3    = 712987 Bytes
Required1    = GCC 2.4.5 or 2.5.8, ncurses, Sys-V IPC
CopyPolicy1  = GNU GPL
Keywords     = source browser, programming, cross-reference, calltree, c-bat
Comment1     = This release is not finished yet ! This toolkit is intented to
Comment2     = give you the possibility to add browsing capabilities to
Comment3     = your own programming environments ! 
Entered      = 13MAR94
EnteredBy    = Eckehard Stolz
CheckedEmail = stolz@fiffi.sta.sub.org
End


1. WHAT IS C-BAT AND HOW TO USE IT ****************************************

This tool is based on GCC (2.4.5 and 2.5.8) for Linux and is 
intented to help programmers understand foreign (or their 
own :-) code by analyzing call-structures, use of variables, ...

It uses a client-server-concept where the server returns
information requested by client applications. Besides a single
example-client this toolkit provides a function library for 
retrieving information from the browser-server which can be
integrated in everyone's favorite programming environment.

First step is the compiling the project with a patched version of
GCC and the option "-aux-brs" (or "-aux-BRS"). This will generate
a browser-file for every source file with the same basename and the
extension ".brs" (e.g.  compiling "foo.c" will produce "foo.brs").
Aditionally, the preprocessor creates a ".brp" file for every source
file, which holds ALL macro definitions in this file !
If you use the option "-aux-BRS" instead of "-aux-brs", symbols declared
in system-include-files will also appear in the browser file, 
otherwise system-symbols (mostly library-calls or library-variables)
will be ommitted.

[... continued in README ... ]

There are the following clients provided in the toolkit:

brs_client     ...   interactive browsing-tool
brs_calltree   ...   print a calltree from a function
brs_f_list     ...   print a list of all functions in a project
