NAME

       gnatelim - eliminate dead code from Ada programs

SYNOPSIS

       gnatelim [OPTION]... name

DESCRIPTION

       When  you  are  working  with  a  program which shares some set of Ada packages with other
       programs, it may happen, that your program uses only a part of subprogram defined in these
       packages,  whereas  the  code  created  for  unused  subprograms increases the size of the
       executable your program.

       gnatelim is a utility tracking unused subprograms in an Ada program. Its  output  consists
       of  a  list  of Eliminate pragmas marking all the subprograms that are declared, but never
       called in a given program. Eliminate is a GNAT-specific pragma. By ecompiling your program
       with these pragmas, you may decrease the size of its executable, because the compiler will
       not create the code for unused subprograms.

       gnatelim is an ASIS application developed on top of the ASIS implementation for  GNAT.  It
       needs a set of tree files representing a program to analyze and the bind file for its main
       subprogram to be created in the current directory. For the current version, it  is  a  the
       user's  responsibility  to  maintain the consistency of the set of tree files processed by
       gnatelim, if the user also changes the sources of the Ada program to be processed.

       To produce a list of Eliminate pragmas, gnatelim has to do an extensive  analysis  and  it
       may  take  some time. For example, to process itself, gnatelim takes 4 minutes of CPU time
       on a Pentium 200.

OPTIONS

       -v     verbose mode: gnatelim version information is printed (in the form of Ada comments)
              in stdout; the names of the files being processed are printed to standard-error.

       -vf    Same  as  -v,  but  in  addition  various  debugging  information  and  information
              reflecting  some  details  of  the  analysis  done  by  gnatelim  are  printed   to
              standard-error.

       -a     Process  RTL  components: by default, gnatelim does not analyze the units which are
              the components of the GNAT  Run-Time  Library  (RTL),  and  it  does  not  generate
              Eliminate  pragmas for subprograms declared in the RTL.  If '-a' option is set, RTL
              components are  also  analyzed  (except  some  units,  which  contains  subprograms
              implicitly called by the compiler).

       -m     Check missed units: if this option is set, gnatelim checks that all the units which
              (according to the bind file) has to be analyzed by gnatelim are really  represented
              by  the  set  of tree files processed by gnatelim (depending on whether or not '-a'
              option is set). By default (that is, if '-m' option is not set), gnatelim  analyzes
              a  set of units represented by a given set of tree files "as is" (excluding library
              packages which require bodies, but for which bodies are not available).

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    Ada   Core   Technologies   Inc
       (http://www.gnat.com).

       This manual page was written by Ludovic Brenta <ludovic@ludovic-brenta.org> for the Debian
       project.

COPYRIGHT

       Copyright (c) 1995-1997, Free Software Foundation, Inc.

SEE ALSO

       asistant(1), gnat(1), gnatcheck(1), gnatmetric(1), gnatpp(1), gnatstub(1)

       The full documentation for gnatelim in /usr/share/doc/asis-programs/README.gnatelim

       info asis_ug ASIS-for-GNAT User's Guide

       info asis_rm ASIS-for-GNAT Reference Manual