Previous: Running gnatstub, Up: Creating Sample Bodies Using gnatstub


20.2 Switches for gnatstub

-f
If the destination directory already contains a file with a name of the body file for the argument spec file, replace it with the generated body stub.
-hs
Put the comment header (i.e. all the comments preceding the compilation unit) from the source of the library unit declaration into the body stub.
-hg
Put a sample comment header into the body stub.
-IDIR
-I-
These switches have the same meaning as in calls to gcc. They define the source search path in the call to gcc issued by gnatstub to compile an argument source file.
-in
(n is a decimal natural number). Set the indentation level in the generated body sample to n, '-i0' means "no indentation", the default indentation is 3.
-k
Do not remove the tree file (i.e. the snapshot of the compiler internal structures used by gnatstub) after creating the body stub.
-ln
(n is a decimal positive number) Set the maximum line length in the body stub to n, the default is 78.
-q
Quiet mode: do not generate a confirmation when a body is successfully created or a message when a body is not required for an argument unit.
-r
Reuse the tree file (if it exists) instead of creating it: instead of creating the tree file for the library unit declaration, gnatstub tries to find it in the current directory and use it for creating a body. If the tree file is not found, no body is created. -r also implies -k, whether or not -k is set explicitly.
-t
Overwrite the existing tree file: if the current directory already contains the file which, according to the GNAT file name rules should be considered as a tree file for the argument source file, gnatstub will refuse to create the tree file needed to create a body sampler, unless -t option is set
-v
Verbose mode: generate version information.