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


24.2 Switches for gnatstub

-f
If the destination directory already contains a file with the 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.
--header-file=filename
Use the content of the file as the comment header for a generated 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.
-gnatecPATH
This switch has the same meaning as in calls to gcc. It defines the additional configuration file to be passed to the call to gcc issued by gnatstub to compile an argument source file.
-gnatyMn
(n is a non-negative integer). Set the maximum line length in the body stub to n; the default is 79. The maximum value that can be specified is 32767. Note that in the special case of configuration pragma files, the maximum is always 32767 regardless of whether or not this switch appears.
-gnatyn
(n is a non-negative integer from 1 to 9). Set the indentation level in the generated body sample to n. The default indentation is 3.
-gnatyo
Order local bodies alphabetically. (By default local bodies are ordered in the same way as the corresponding local specs in the argument spec file.)
-in
Same as -gnatyn
-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
Same as -gnatyMn
-obody-name
Body file name. This should be set if the argument file name does not follow the GNAT file naming conventions. If this switch is omitted the default name for the body will be obtained from the argument file name according to the GNAT file naming conventions.
-q
Quiet mode: do not generate a confirmation when a body is successfully created, and do not generate 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. This option also implies -k, whether or not the latter is set explicitly.
-t
Overwrite the existing tree file. If the current directory already contains the file which, according to the GNAT file naming 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 sample body unless this option is set.
-v
Verbose mode: generate version information.