3.3.4.3 Config File Related Attributes

In the value of config file attributes defined below, there are some placeholders that GPRbuild will replace. These placeholders are:

• %u : the unit name
• %f : the file name of the source
• %s : the spec suffix
• %b : the body suffix
• %c : the casing
• %d : the dot replacement string

Attributes:

• Config_File_Switches (<language>)

  Specifies the switch or switches to be used to specify a configuration file to the compiler. When attribute Config_File_Switches is not declared, then no config file is specified to the compiler. The value of this attribute is a string list. The path name of the config file is concatenated with the last string in the string list, which may be empty. Example:

     for Config_File_Switches ("Ada") use ("-gnatec=");
    

• Config_Body_File_Name (<language>)

  Specifies the line to be put in a config file to indicate the file name of a body. Example:

     for Config_Body_File_Name ("Ada") use
         "pragma Source_File_Name_Project (%u, Body_File_Name => ""%f"");";
    

• Config_Spec_File_Name (<language>)

  Specifies the line to be put in a config file to indicate the file name of a spec. Example:

     for Config_Spec_File_Name ("Ada") use
         "pragma Source_File_Name_Project (%u, Spec_File_Name => ""%f"");";
    

• Config_Body_File_Name_Pattern (<language>)

  Specifies the line to be put in a config file to indicate a body file name pattern. Example:

     for Config_Body_File_Name_Pattern ("Ada") use
         "pragma Source_File_Name_Project " &
         "  (Body_File_Name  => ""*%b""," &
         "   Casing          => %c," &
         "   Dot_Replacement => ""%d"");";
    

• Config_Spec_File_Name_Pattern (<language>)

  Specifies the line to be put in a config file to indicate a spec file name pattern. Example:

     for Config_Spec_File_Name_Pattern ("Ada") use
         "pragma Source_File_Name_Project " &
         "  (Spec_File_Name  => ""*%s""," &
         "   Casing          => %c," &
         "   Dot_Replacement => ""%d"");";
    

• Config_File_Unique (<language>)

  Specifies, for languages that support config files, if several config files may be indicated to the compiler, or not. This attribute may have only two values: "true" or "false" (case insensitive). The default, when this attribute is not specified, is "false". When the value "true" is specified for this attribute, GPRbuild will concatenate the config files, if there are more than one. Example:

     for Config_File_Unique ("Ada") use "True";