11.9.10.5 Package Compiler Attributes

• General
  • Default_Switches: list, indexed, case-insensitive index

    Index is a language name. Value is a list of switches to be used when invoking the compiler for the language for a source of the project, if there is no applicable attribute Switches.

  • ^Switches^Switches^: list, optional index, indexed, case-insensitive index, others allowed

    Index is a source file name or a language name. Value is the list of switches to be used when invoking the compiler for the source or for its language.

  • Local_Configuration_Pragmas: single

    Value is the file name of a configuration pragmas file that is specified to the Ada compiler when compiling any Ada source in the project.

  • Local_Config_File: single, indexed, case-insensitive index

    Index is a language name. Value is the file name of a configuration file that is specified to the compiler when compiling any source of the language in the project.

• Configuration - Compiling
  • Driver: single, indexed, case-insensitive index

    Index is a language name. Value is the name of the executable for the compiler of the language.

  • Language_Kind: single, indexed, case-insensitive index

    Index is a language name. Indicates the kind of the language, either file based or unit based. Only authorized case-insensitive values are "unit_based" and "file_based" (the default).

  • Dependency_Kind: single, indexed, case-insensitive index

    Index is a language name. Indicates how the dependencies are handled for the language. Only authorized case-insensitive values are "makefile", "ali_file", "ali_closure" or "none" (the default).

  • Required_Switches: list, indexed, case-insensitive index

    Equivalent to attribute Leading_Required_Switches.

  • Leading_Required_Switches: list, indexed, case-insensitive index

    Index is a language name. Value is the list of the minimum switches to be used at the beginning of the command line when invoking the compiler for the language.

  • Trailing_Required_Switches: list, indexed, case-insensitive index

    Index is a language name. Value is the list of the minimum switches to be used at the end of the command line when invoking the compiler for the language.

  • PIC_Option: list, indexed, case-insensitive index

    Index is a language name. Value is the list of switches to be used when compiling a source of the language when the project is a shared library project.

  • Path_Syntax: single, indexed, case-insensitive index

    Index is a language name. Value is the kind of path syntax to be used when invoking the compiler for the language. Only authorized case-insensitive values are "canonical" and "host" (the default).

  • Source_File_Switches: single, indexed, case-insensitive index

    Index is a language name. Value is a list of switches to be used just before the path name of the source to compile when invoking the compiler for a source of the language.

  • Object_File_Suffix: single, indexed, case-insensitive index

    Index is a language name. Value is the extension of the object files created by the compiler of the language. When not specified, the extension is the default one for the platform.

  • Object_File_Switches: list, indexed, case-insensitive index

    Index is a language name. Value is the list of switches to be used by the compiler of the language to specify the path name of the object file. When not specified, the switch used is "-o".

  • Multi_Unit_Switches: list, indexed, case-insensitive index

    Index is a language name. Value is the list of switches to be used to compile a unit in a multi unit source of the language. The index of the unit in the source is concatenated with the last switches in the list.

  • Multi_Unit_Object_Separator: single, indexed, case-insensitive index

    Index is a language name. Value is the string to be used in the object file name before the index of the unit, when compiling a unit in a multi unit source of the language.

• Configuration - Mapping Files
  • Mapping_File_Switches: list, indexed, case-insensitive index

    Index is a language name. Value is the list of switches to be used to specify a mapping file when invoking the compiler for a source of the language.

  • Mapping_Spec_Suffix: single, indexed, case-insensitive index

    Index is a language name. Value is the suffix to be used in a mapping file to indicate that the source is a spec.

  • Mapping_Body_Suffix: single, indexed, case-insensitive index

    Index is a language name. Value is the suffix to be used in a mapping file to indicate that the source is a body.

• Configuration - Config Files
  • Config_File_Switches: list: single, indexed, case-insensitive index

    Index is a language name. Value is the list of switches to specify to the compiler of the language a configuration file.

  • Config_Body_File_Name: single, indexed, case-insensitive index

    Index is a language name. Value is the template to be used to indicate a configuration specific to a body of the language in a configuration file.

  • Config_Body_File_Name_Index: single, indexed, case-insensitive index

    Index is a language name. Value is the template to be used to indicate a configuration specific to the body a unit in a multi unit source of the language in a configuration file.

  • Config_Body_File_Name_Pattern: single, indexed, case-insensitive index

    Index is a language name. Value is the template to be used to indicate a configuration for all bodies of the languages in a configuration file.

  • Config_Spec_File_Name: single, indexed, case-insensitive index

    Index is a language name. Value is the template to be used to indicate a configuration specific to a spec of the language in a configuration file.

  • Config_Spec_File_Name_Index: single, indexed, case-insensitive index

    Index is a language name. Value is the template to be used to indicate a configuration specific to the spec a unit in a multi unit source of the language in a configuration file.

  • Config_Spec_File_Name_Pattern: single, indexed, case-insensitive index

    Index is a language name. Value is the template to be used to indicate a configuration for all specs of the languages in a configuration file.

  • Config_File_Unique: single, indexed, case-insensitive index

    Index is a language name. Indicates if there should be only one configuration file specified to the compiler of the language. Only authorized case-insensitive values are "true" and "false" (the default).

• Configuration - Dependencies
  • Dependency_Switches: list, indexed, case-insensitive index

    Index is a language name. Value is the list of switches to be used to specify to the compiler the dependency file when the dependency kind of the language is file based, and when Dependency_Driver is not specified for the language.

  • Dependency_Driver: list, indexed, case-insensitive index

    Index is a language name. Value is the name of the executable to be used to create the dependency file for a source of the language, followed by the required switches.

• Configuration - Search Paths
  • Include_Switches: list, indexed, case-insensitive index

    Index is a language name. Value is the list of switches to specify to the compiler of the language to indicate a directory to look for sources.

  • Include_Path: single, indexed, case-insensitive index

    Index is a language name. Value is the name of an environment variable that contains the path of all the directories that the compiler of the language may search for sources.

  • Include_Path_File: single, indexed, case-insensitive index

    Index is a language name. Value is the name of an environment variable the value of which is the path name of a text file that contains the directories that the compiler of the language may search for sources.

  • Object_Path_Switches: list, indexed, case-insensitive index

    Index is a language name. Value is the list of switches to specify to the compiler of the language the name of a text file that contains the list of object directories. When this attribute is not declared, the text file is not created.