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