www.delorie.com/gnu/docs/gcc/gnat_ug_21.html

search

	Buy the book!

Untitled Document

2.3 File Naming Rules

The default file name is determined by the name of the unit that the file contains. The name is formed by taking the full expanded name of the unit and replacing the separating dots with hyphens and using ^lowercase^uppercase^ for all letters.

An exception arises if the file name generated by the above rules starts with one of the characters a,g,i, or s, and the second character is a minus. In this case, the character ^tilde^dollar sign^ is used in place of the minus. The reason for this special rule is to avoid clashes with the standard names for child units of the packages System, Ada, Interfaces, and GNAT, which use the prefixes s- a- i- and g- respectively.

The file extension is `.ads' for a spec and `.adb' for a body. The following list shows some examples of these rules.

`main.ads'

Main (spec)

`main.adb'

Main (body)

`arith_functions.ads'

Arith_Functions (package spec)

`arith_functions.adb'

Arith_Functions (package body)

`func-spec.ads'

Func.Spec (child package spec)

`func-spec.adb'

Func.Spec (child package body)

`main-sub.adb'

Sub (subunit of Main)

`^a~bad.adb^A$BAD.ADB^'

A.Bad (child package body)

Following these rules can result in excessively long file names if corresponding unit names are long (for example, if child units or subunits are heavily nested). An option is available to shorten such long file names (called file name "krunching"). This may be particularly useful when programs being developed with GNAT are to be used on operating systems with limited file name lengths. See section 13.2 Using gnatkr.

Of course, no file shortening algorithm can guarantee uniqueness over all possible unit names; if file name krunching is used, it is your responsibility to ensure no name clashes occur. Alternatively you can specify the exact file names that you want used, as described in the next section. Finally, if your Ada programs are migrating from a compiler with a different naming convention, you can use the gnatchop utility to produce source files that follow the GNAT naming conventions. (For details see section 7. Renaming Files Using gnatchop.)