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 Essential 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@ludovic-brenta.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 non-free section of Debian).

       info asis_rm ASIS-for-GNAT Reference Manual, same package.