Cxref - C program cross-referencing & documentation tool
From: Andrew M. Bishop (amb_at_gedanken.demon.co.uk)
Date: 06/13/04
- Next message: Frederick Noronha (FN): "[school-discuss] Release 0.9.13 of Dr.Geo and Mac OS X port (fwd)"
- Previous message: Andrew M. Bishop: "WWWOFFLE - Web proxy with features for dial-up users"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
Date: 13 Jun 2004 09:05:01 GMT
C Cross Referencing & Documenting tool. Version 1.5g - cxref
============================================================
Cxref is a program that will produce documentation (in LaTeX, HTML, RTF or SGML)
including cross-references from C program source code.
Works for ANSI C, including most gcc extensions.
The documentation for the program is produced from comments in the code that
are appropriately formatted. The cross referencing comes from the code itself
and requires no extra work.
The documentation is produced for each of the following:
Files - A comment that applies to the whole file.
Functions - A comment for the function, including a description of
each of the arguments and the return value.
Variables - A comment for each of a group of variables and/or
individual variables.
#include - A comment for each included file.
#define - A comment for each pre-processor symbol definition, and
for macro arguments.
Type definitions - A comment for each defined type and for each element of a
structure or union type.
Any or all of these comments can be present in suitable places in the
source code.
The cross referencing is performed for the following items
Files - The files that the current file is included in
(even when included via other files).
#includes - Files included in the current file.
- Files included by these files etc.
Variables - The location of the definition of external variables.
- The files that have visibility of global variables.
- The files / functions that use the variable.
Functions - The file that the function is prototyped in.
- The functions that the function calls.
- The functions that call the function.
- The files and functions that reference the function.
- The variables that are used in the function.
Each of these items is cross referenced in the output.
Includes extensive README and FAQ with details and examples on how to use the
program.
Changes
-------
Since version 1.5f:
Bug fixes
New fix allowing a mix of declarations and statements in compound statements.
Fix handling of -Afoo=bar options again.
Configure/Make changes
Add a --without-cxref-cpp option to force using gcc instead of cxref-cpp.
cxref-cpp changes
cxref-cpp now gets gcc defines and include path at runtime from config file.
There is a script cxref-cpp-configure to create this configuration file.
Availability
------------
Previous versions of this program have been tested on the following systems:
Linux 1.[123].x, Linux 2.[01234].x, SunOS 4.1.x, Solaris 2.x, HPUX 10.x
FTP server: ftp://ftp.ibiblio.org/pub/Linux/devel/lang/c/cxref-1.5g.tgz
HTTP server: http://www.gedanken.demon.co.uk/download-cxref/cxref-1.5g.tgz
Web page: http://www.gedanken.demon.co.uk/cxref/
Author & Copyright
------------------
This program is copyright Andrew M. Bishop 1995,96,97,98,99,2000,01,02,03,04
(amb@gedanken.demon.co.uk) and distributed under GPL.
email: amb@gedanken.demon.co.uk
[Please put cxref in the subject line]
--
Andrew.
----------------------------------------------------------------------
Andrew M. Bishop amb@gedanken.demon.co.uk
http://www.gedanken.demon.co.uk/
##########################################################################
# Send submissions for comp.os.linux.announce to: cola@stump.algebra.com #
# PLEASE remember a short description of the software and the LOCATION. #
# This group is archived at http://stump.algebra.com/~cola/ #
##########################################################################
- Next message: Frederick Noronha (FN): "[school-discuss] Release 0.9.13 of Dr.Geo and Mac OS X port (fwd)"
- Previous message: Andrew M. Bishop: "WWWOFFLE - Web proxy with features for dial-up users"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
Relevant Pages
|
