GNATMETRIC(1)
NAME
gnatmetric - Ada metrics tool
SYNOPSIS
gnatmetric [options] {filename | -files filename} [gcc_switches]
DESCRIPTION
gnatmetric takes a set of compilable Ada sources as input, computes for them various programming metrics and generates the output. Argument Ada sources may be provided as command line arguments, or you can place the names of the Ada sources to compute the metrics for into a textual file and to provide the name of this file as the parameter of -files option.
OPTIONS
-v verbose mode
-q quiet mode
-dv generate debug output
-dd generate string to be used as input for progress indicator
-nocc do not compute the McCabe Cyclomatic Complexity
-noec do not compute the Essential Complexity
-nonl do not compute maximal loop nesting level
- -ne do not consider exit statements as gotos when computing Essen
- tial Complexity
- -nolocal
- do not compute detailed metrics for local program units
- Line metrics
- When not specified explicitly, all line metrics are set on, otherwise only specified metrics are computed:
- -la the number of all lines
- -lcode the number of code lines
- -lcomm the number of comment lines
- -leol the number of code lines also containing comments
- -lb the number of blank lines
- Element metrics
- When not specified explicitly, all element metrics are set on, otherwise only specified metrics are computed:
- -ed the total number of declarations
- -es the total number of statements
- -eps the number of public subprograms in a compilation unit
- -eas the number of all the subprograms in a compilation unit
- -ept the number of public types in a compilation unit
- -eat the number of all the types in a compilation unit
- -enu the maximal program unit nesting level
- -ec the maximal construct nesting level
- Output file control
- -d dirname
put files with detailed metrics into dirname
- -x generate the XML output
- -nt do not generate the output in text form, implies '-x'
- -o file-suffix
the suffix for the file to put the detailed metrics for a source file (file-suffix should begin with a dot)
- -og filename
the name of the file to put the global metrics info into (if not set, this info is sent to Stdout)
- -ox filename
the name of the file to put the XML output into, implies '-x'
- -sfn use short source file name in the output
- Input files
- filename
the name of the Ada source file for which metrics should be computed. Wildcards are allowed.
- -files filename
the name of the text file containing a list of Ada source files for which metrics should be computed.
- GCC switches
- gcc_switches
Passed to gnatgcc as "-cargs gcc_switches".
AUTHOR
ASIS-for-GNAT was originally developed by the ASIS-for-GNAT team at the
Software Engineering Laboratory of the Swiss Federal Institute of Technology (LGL-EPFL) in Lausanne, Switzerland, in cooperation with the
Scientific Research Computer Center of Moscow State University (SRCC
MSU), Russia, with funding partially provided by grants from the Swiss
National Science Foundation and the Swiss Academy of Engineering Sciences. ASIS-for-GNAT is now maintained by AdaCore (http://www.adacore.com).
This manual page was written by Ludovic Brenta <ludovic@ludovicbrenta.org> for the Debian project, from the gnatmetric sources.
COPYRIGHT
Copyright (c) 1995-2006, Free Software Foundation, Inc.
SEE ALSO
asistant(1), gnat(1), gnatcheck(1), gnatelim(1), gnatpp(1), gnatstub(1)
/usr/share/doc/asis-programs/README.gnatmetric
- info asis_ug ASIS-for-GNAT User's Guide, provided by by package
- libasis-doc in the Info system, and in text, PDF and HTML formats in /usr/share/doc/libasis-doc. (asis-doc is in the nonfree section of Debian).
- info asis_rm ASIS-for-GNAT Reference Manual, same package.