Switches for gnatclean (GNAT User’s Guide for Native Platforms)

#### 5.1.2 Switches for `gnatclean` ¶

`gnatclean` recognizes the following switches:

`--version`

  Display copyright and version, then exit, disregarding all other options.

`--help`

  If `--version` was not specified, display usage, then exit disregarding all other options.

`--subdirs=`subdir'`

  Actual object directory of each project file, which is the subdirectory `subdir` of the object directory specified or defaulted in the project file.

`--unchecked-shared-lib-imports`

  By default, shared library projects are not allowed to import static library projects. When this switch is specified, this restriction is lifted.

`-c`

  Only attempt to delete the files produced by the compiler, not those produced by the binder or the linker. The files that are not to be deleted are library files, interface copy files, binder generated files and executable files.

`-D `dir'`

  Indicate that ALI and object files should normally be found in directory `dir`.

`-F`

  When using project files, if some errors or warnings are detected during parsing and verbose mode is not in effect (the switch `-v` is not specified), error lines start with the full path name of the project file, rather than its simple file name.

`-h`

  Output a message explaining the usage of `gnatclean`.

`-n`

  Informative-only mode. Do not delete any files. Output the list of the files that would have been deleted if this switch was not specified.

`-P`project'`

  Use project file `project`. You can specify only one such switch. When cleaning a project file, `gnatclean` deletes the files produced by the compilation of the immediate sources or inherited sources of the project files. This does not depend on whether or not you include executable names on the command line.

`-q`

  Quiet output. If there are no errors, do not output anything, except in verbose mode (`-v`) or in information-only mode (`-n`).

`-r`

  When a project file is specified (using `-P`), clean all imported and extended project files, recursively. If you don’t specify this switch, `gnatclean` only deletes the files related to the main project file. This switch has no effect if you don’t specify a project file.

`-v`

  Verbose mode.

`-vP`x'`

  Indicates the verbosity of the parsing of GNAT project files. Switches Related to Project Files.

`-X`name'=`value'`

  Indicates that external variable `name` has the value `value`. The Project Manager will use this value for occurrences of `external(name)` when parsing the project file. See Switches Related to Project Files.

`-aO`dir'`

  When searching for ALI and object files, look in directory `dir`.

`-I`dir'`

  Equivalent to `-aO`dir'`.

`-I-`

  Do not look for ALI or object files in the directory where `gnatclean` was invoked.