-- --
-- S p e c --
-- --
--- Copyright (C) 2006-2009, Free Software Foundation, Inc. --
+-- Copyright (C) 2006-2011, Free Software Foundation, Inc. --
-- --
-- GNAT is free software; you can redistribute it and/or modify it under --
-- terms of the GNU General Public License as published by the Free Soft- --
--- ware Foundation; either version 2, or (at your option) any later ver- --
+-- ware Foundation; either version 3, or (at your option) any later ver- --
-- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
-- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
-- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
-- for more details. You should have received a copy of the GNU General --
--- Public License distributed with GNAT; see file COPYING. If not, write --
--- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, --
--- Boston, MA 02110-1301, USA. --
+-- Public License distributed with GNAT; see file COPYING3. If not, go to --
+-- http://www.gnu.org/licenses for a complete copy of the license. --
-- --
-- GNAT was originally developed by the GNAT team at New York University. --
-- Extensive contributions were provided by Ada Core Technologies Inc. --
Project_File_Name : String;
Project_Tree : Prj.Project_Tree_Ref;
Project_Node_Tree : Prj.Tree.Project_Node_Tree_Ref;
+ Env : in out Prj.Tree.Environment;
Packages_To_Check : String_List_Access;
Allow_Automatic_Generation : Boolean := True;
Automatically_Generated : out Boolean;
Config_File_Path : out String_Access;
Target_Name : String := "";
Normalized_Hostname : String;
- Report_Error : Put_Line_Access := null;
On_Load_Config : Config_File_Hook := null);
-- Find the main configuration project and parse the project tree rooted at
-- this configuration project.
--
+ -- Project_Node_Tree must have been initialized first (and possibly the
+ -- value for external references and project path should also have been
+ -- set).
+ --
-- If the processing fails, Main_Project is set to No_Project. If the error
- -- happend while parsing the project itself (ie creating the tree),
+ -- happened while parsing the project itself (i.e. creating the tree),
-- User_Project_Node is also set to Empty_Node.
--
-- Autoconf_Specified indicates whether the user has specified --autoconf.
Autoconf_Specified : Boolean;
Project_Tree : Prj.Project_Tree_Ref;
Project_Node_Tree : Prj.Tree.Project_Node_Tree_Ref;
+ Env : in out Prj.Tree.Environment;
Packages_To_Check : String_List_Access;
Allow_Automatic_Generation : Boolean := True;
Automatically_Generated : out Boolean;
Config_File_Path : out String_Access;
Target_Name : String := "";
Normalized_Hostname : String;
- Report_Error : Put_Line_Access := null;
On_Load_Config : Config_File_Hook := null;
- Compiler_Driver_Mandatory : Boolean := True;
- Allow_Duplicate_Basenames : Boolean := False;
- Reset_Tree : Boolean := True;
- When_No_Sources : Error_Warning := Warning);
+ Reset_Tree : Boolean := True);
-- Same as above, except the project must already have been parsed through
-- Prj.Part.Parse, and only the processing of the project and the
-- configuration is done at this level.
+ --
-- If Reset_Tree is true, all projects are first removed from the tree.
-- When_No_Sources indicates what should be done when no sources are found
-- for one of the languages of the project.
+ --
+ -- If Require_Sources_Other_Lang is true, then all languages must have at
+ -- least one source file, or an error is reported via When_No_Sources. If
+ -- it is false, this is only required for Ada (and only if it is a language
+ -- of the project).
Invalid_Config : exception;
(Project : Prj.Project_Id;
Project_Tree : Prj.Project_Tree_Ref;
Project_Node_Tree : Prj.Tree.Project_Node_Tree_Ref;
+ Env : in out Prj.Tree.Environment;
Allow_Automatic_Generation : Boolean;
Config_File_Name : String := "";
Autoconf_Specified : Boolean;
--
-- The choice and generation of a configuration file depends on several
-- attributes of the user's project file (given by the Project argument),
- -- like the list of languages that must be supported. Project must
- -- therefore have been partially processed (phase one of the processing
- -- only).
+ -- e.g. list of languages that must be supported. Project must therefore
+ -- have been partially processed (phase one of the processing only).
--
-- Config_File_Name should be set to the name of the config file specified
-- by the user (either through gprbuild's --config or --autoconf switches).
- -- In the latter case, Autoconf_Specified should be set to true, to
- -- indicate that the configuration file can be regenerated to match target
- -- and languages. This name can either be an absolute path, or the a base
- -- name that will be searched in the default config file directories (which
+ -- In the latter case, Autoconf_Specified should be set to true to indicate
+ -- that the configuration file can be regenerated to match target and
+ -- languages. This name can either be an absolute path, or the base name
+ -- that will be searched in the default config file directories (which
-- depends on the installation path for the tools).
--
- -- Target_Name is used to chose among several possibilities
- -- the configuration file that will be used.
+ -- Target_Name is used to chose the configuration file that will be used
+ -- from among several possibilities.
--
-- If a project file could be found, it is automatically parsed and
-- processed (and Packages_To_Check is used to indicate which packages
-- should be processed)
- procedure Apply_Config_File
- (Config_File : Prj.Project_Id;
- Project_Tree : Prj.Project_Tree_Ref);
- -- Apply the configuration file settings to all the projects in the
- -- project tree. The Project_Tree must have been parsed first, and
- -- processed through the first phase so that all its projects are known.
- --
- -- Currently, this will add new attributes and packages in the various
- -- projects, so that when the second phase of the processing is performed
- -- these attributes are automatically taken into account.
-
procedure Add_Default_GNAT_Naming_Scheme
(Config_File : in out Prj.Tree.Project_Node_Id;
Project_Tree : Prj.Tree.Project_Node_Tree_Ref);
- -- A hook for Get_Or_Create_Configuration_File and
- -- Process_Project_And_Apply_Config that will create a new config file (in
- -- memory) and add the default GNAT naming scheme to it. Nothing is done
- -- if the config_file already exists, to avoid overriding what the user
- -- might have put in there.
+ -- A hook that will create a new config file (in memory), used for
+ -- Get_Or_Create_Configuration_File and Process_Project_And_Apply_Config
+ -- and add the default GNAT naming scheme to it. Nothing is done if the
+ -- config_file already exists, to avoid overriding what the user might
+ -- have put in there.
--------------
-- Runtimes --
-- --config switch then automatically generating a configuration file.
function Runtime_Name_For (Language : Name_Id) return String;
- -- Returns the runtime name for a language. Returns an empty string if
- -- no runtime was specified for the language using option --RTS.
+ -- Returns the runtime name for a language. Returns an empty string if no
+ -- runtime was specified for the language using option --RTS.
+
+ function Runtime_Name_Set_For (Language : Name_Id) return Boolean;
+ -- Returns True only if Set_Runtime_For has been called for the Language
end Prj.Conf;
OSDN Git Service
