NAME

       gnatpp - Ada pretty-printer

SYNOPSIS

       gnatpp [options] {filename | -files filename} [gcc_switches]

DESCRIPTION

       gnatpp recreates the source text of the specified Ada units from GNAT's parse tree.  Along
       the way, it reformats the source text according to the many  options.   The  defaults  are
       suitable for the GNAT style guide.

OPTIONS

       -A(0|1|2|3|4|5)
              set alignment, all the alignments are set ON by default

              0      set the default for all the alignments OFF

              1      align colons in declarations

              2      align assignments in declarations

              3      align assignments in assignment statements

              4      align arrow delimiters in associations

              5      align 'AT' keywords in component clauses

       -a(L|U|M)
              set attribute casing

              L      lower case

              U      upper case

              M      mixed case (set as default)

       -c(0|1|2|3|4)
              comments layout

              0      do not format comments

              1      GNAT style comment line indentation (set as default)

              2      standard comment line indentation

              3      GNAT style comment beginning

              4      reformat comment blocks

       -clnnn indentation level for continuation lines, nnn from 1 .. 9

       -Dfile set file as the dictionary file defining casing exceptions

       -D-    do  not  use  RM95-defined  casing  for  predefined names, use casing defined by -n
              parameter and dictionary file(s) instead

       -e     do not set missed end/exit labels

       -ff    put Form Feed after a pragma Page

       -gnatecpath
              the same as GNAT -gnatec option

       -innn  indentation level, nnn from 1 .. 9, the default value is 3

       -Idir  the same as GNAT -I option

       -I-    the same as GNAT -I- option

       -k(L|U)
              set keyword casing

              L      lower case (set as default)

              U      upper case

       -l(1|2|3)
              set construct layout

              1      GNAT style layout (set as default)

              2      compact layout

              3      uncompact layout

       -Mnnn  set maximum line length, nnn from 32 .. 256, the default value is 79

       -n(D|U|L|M)
              set name casing (for both defining and usage occurrences)

              D      as declared (set as default)

              U      all in upper case

              L      all in lower case

              M      mixed

       -N     no tabulation in comments

       -p(L|U|M)

              L      lower case

              U      upper case

              M      mixed case (set as default)

       --RTS=dir
              the same as GNAT --RTS option

       -Tnnn  do not use additional indentation level for case alternatives and variants if their
              number is nnn or more (the default value is 10)

       -q     quiet mode

       -v     verbose mode

       -dd    progress indicator verbose mode

       -w     warnings ON

   Output file control
       -pipe  send the output into stdout

       -o output_file
              write the output into output_file. Give up if output_file already exists

       -of output_file
              write the output into output_file, overriding the existing file

       -r     replace  the  argument  source with the pretty-printed source and copy the argument
              source into filename.npp. Give up if filename.npp already exists.

       -rf    replace the argument source with the pretty-printed source and  copy  the  argument
              source into filename.npp, overriding the existing file

       -rnb   replace  the  argument  source with the pretty-printed source and do not create the
              back-up copy of the argument source

   Input files
       filename
              the name of the Ada source file to be reformatted.  Wildcards are allowed.

       -files filename
              the name of the text file containing a list of Ada source files to reformat

   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 gnatpp sources.

COPYRIGHT

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

SEE ALSO

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

       /usr/share/doc/asis-programs/README.gnatpp

       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.