1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 2000-2009, Free Software Foundation, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING3. If not, go to --
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
21 -- GNAT was originally developed by the GNAT team at New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 ------------------------------------------------------------------------------
26 -- General wrapper for the parsing of project files
30 procedure Set_Verbosity (To : Verbosity);
31 -- Set the verbosity when parsing the project files
34 (In_Tree : Project_Tree_Ref;
35 Project : out Project_Id;
36 Project_File_Name : String;
37 Packages_To_Check : String_List_Access := All_Packages;
38 Flags : Processing_Flags;
39 Reset_Tree : Boolean := True);
40 -- Parse and process a project files and all its imported project files, in
41 -- the project tree In_Tree.
42 -- All the project files are parsed (through Prj.Tree) to create a tree in
43 -- memory. That tree is then processed (through Prj.Proc) to create a
44 -- expanded representation of the tree based on the current scenario
45 -- variables. This function is only a convenient wrapper over other
46 -- services provided in the Prj.* package hierarchy.
48 -- If parsing is successful, Project is the project ID of the root project
49 -- file; otherwise, Project_Id is set to No_Project. Project_Node_Tree is
50 -- set to the tree (unprocessed) representation of the project file. This
51 -- tree is permanently correct, whereas Project will need to be recomputed
52 -- if the scenario variables change.
54 -- Packages_To_Check indicates the packages where any unknown attribute
55 -- produces an error. For other packages, an unknown attribute produces a
58 -- When Reset_Tree is True, all the project data are removed from the
59 -- project table before processing.