aboutsummaryrefslogtreecommitdiff
path: root/gcc/ada/prj-pars.ads
diff options
context:
space:
mode:
authorArnaud Charlet <charlet@gcc.gnu.org>2009-05-06 10:29:29 +0200
committerArnaud Charlet <charlet@gcc.gnu.org>2009-05-06 10:29:29 +0200
commit7dd1ab8497bdb14e30bce8d94214be7afc6e9a90 (patch)
tree92e562ce450f003b116a2eac024ad66f8c5d5ce8 /gcc/ada/prj-pars.ads
parent28541488914f27ad9763a02c2cc786cf786399d2 (diff)
downloadgcc-7dd1ab8497bdb14e30bce8d94214be7afc6e9a90.zip
gcc-7dd1ab8497bdb14e30bce8d94214be7afc6e9a90.tar.gz
gcc-7dd1ab8497bdb14e30bce8d94214be7afc6e9a90.tar.bz2
[multiple changes]
2009-05-06 Thomas Quinot <quinot@adacore.com> * sem_ch3.adb (Access_Type_Declaration): An access type whose designated type is a limited view from a limited with clause (flagged From_With_Type) is not itself such a limited view. 2009-05-06 Emmanuel Briot <briot@adacore.com> * prj-nmsc.adb: Remove unused variable. * clean.adb, gnatcmd.adb, makeutl.ads, prj-pars.adb, prj-pars.ads, prj-proc.ads, prj.ads, switch-m.adb (Subdirs_Option): Moved to makeutl.ads, since not all users of prj.ads need this. From-SVN: r147152
Diffstat (limited to 'gcc/ada/prj-pars.ads')
-rw-r--r--gcc/ada/prj-pars.ads30
1 files changed, 19 insertions, 11 deletions
diff --git a/gcc/ada/prj-pars.ads b/gcc/ada/prj-pars.ads
index 02f1491..2c439ad 100644
--- a/gcc/ada/prj-pars.ads
+++ b/gcc/ada/prj-pars.ads
@@ -23,7 +23,7 @@
-- --
------------------------------------------------------------------------------
--- Implements the parsing of project files
+-- General wrapper for the parsing of project files
package Prj.Pars is
@@ -36,21 +36,29 @@ package Prj.Pars is
Project_File_Name : String;
Packages_To_Check : String_List_Access := All_Packages;
When_No_Sources : Error_Warning := Error;
+ Report_Error : Prj.Put_Line_Access := null;
Reset_Tree : Boolean := True;
- Is_Config_File : Boolean);
- -- Parse a project files and all its imported project files, in the
- -- project tree In_Tree.
+ Is_Config_File : Boolean := False);
+ -- Parse and process a project files and all its imported project files, in
+ -- the project tree In_Tree.
+ -- All the project files are parsed (through Prj.Tree) to create a tree in
+ -- memory. That tree is then processed (through Prj.Proc) to create a
+ -- expanded representation of the tree based on the current scenario
+ -- variables. This function is only a convenient wrapper over other
+ -- services provided in the Prj.* package hierarchy.
--
- -- If parsing is successful, Project_Id is the project ID
- -- of the main project file; otherwise, Project_Id is set
- -- to No_Project.
+ -- If parsing is successful, Project is the project ID of the root project
+ -- file; otherwise, Project_Id is set to No_Project. Project_Node_Tree is
+ -- set to the tree (unprocessed) representation of the project file. This
+ -- tree is permanently correct, whereas Project will need to be recomputed
+ -- if the scenario variables change.
--
-- Packages_To_Check indicates the packages where any unknown attribute
- -- produces an error. For other packages, an unknown attribute produces
- -- a warning.
+ -- produces an error. For other packages, an unknown attribute produces a
+ -- warning.
--
- -- When_No_Sources indicates what should be done when no sources
- -- are found in a project for a specified or implied language.
+ -- When_No_Sources indicates what should be done when no sources are found
+ -- in a project for a specified or implied language.
--
-- When Reset_Tree is True, all the project data are removed from the
-- project table before processing.