aboutsummaryrefslogtreecommitdiffstats
path: root/gcc-4.9/gcc/ada/prj-part.ads
diff options
context:
space:
mode:
Diffstat (limited to 'gcc-4.9/gcc/ada/prj-part.ads')
-rw-r--r--gcc-4.9/gcc/ada/prj-part.ads78
1 files changed, 78 insertions, 0 deletions
diff --git a/gcc-4.9/gcc/ada/prj-part.ads b/gcc-4.9/gcc/ada/prj-part.ads
new file mode 100644
index 000000000..1bf1366fb
--- /dev/null
+++ b/gcc-4.9/gcc/ada/prj-part.ads
@@ -0,0 +1,78 @@
+------------------------------------------------------------------------------
+-- --
+-- GNAT COMPILER COMPONENTS --
+-- --
+-- P R J . P A R T --
+-- --
+-- S p e c --
+-- --
+-- Copyright (C) 2000-2013, 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 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 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. --
+-- --
+------------------------------------------------------------------------------
+
+-- Implements the parsing of project files into a tree
+
+with Prj.Tree; use Prj.Tree;
+
+package Prj.Part is
+
+ type Errout_Mode is
+ (Always_Finalize,
+ Finalize_If_Error,
+ Never_Finalize);
+ -- Whether Parse should call Errout.Finalize (which prints the error
+ -- messages on stdout). When Never_Finalize is used, Errout is not reset
+ -- either at the beginning of Parse.
+
+ procedure Parse
+ (In_Tree : Project_Node_Tree_Ref;
+ Project : out Project_Node_Id;
+ Project_File_Name : String;
+ Errout_Handling : Errout_Mode := Always_Finalize;
+ Packages_To_Check : String_List_Access;
+ Store_Comments : Boolean := False;
+ Current_Directory : String := "";
+ Is_Config_File : Boolean;
+ Env : in out Prj.Tree.Environment;
+ Target_Name : String := "";
+ Implicit_Project : Boolean := False);
+ -- Parse project file and all its imported project files and create a tree.
+ -- Return the node for the project (or Empty_Node if parsing failed). If
+ -- Always_Errout_Finalize is True, Errout.Finalize is called in all cases,
+ -- Otherwise, Errout.Finalize is only called if there are errors (but not
+ -- if there are only warnings). Packages_To_Check indicates the packages
+ -- where any unknown attribute produces an error. For other packages, an
+ -- unknown attribute produces a warning. When Store_Comments is True,
+ -- comments are stored in the parse tree.
+ --
+ -- Current_Directory is used for optimization purposes only, avoiding extra
+ -- system calls.
+ --
+ -- Is_Config_File should be set to True if the project represents a config
+ -- file (.cgpr) since some specific checks apply.
+ --
+ -- Target_Name will be used to initialize the default project path, unless
+ -- In_Tree.Project_Path has already been initialized (which is the
+ -- recommended use).
+ --
+ -- If Implicit_Project is True, the main project file being parsed is
+ -- deemed to be in the current working directory, even if it is not the
+ -- case. Implicit_Project is set to True when a tool such as gprbuild is
+ -- invoked without a project file and is using an implicit project file
+ -- that is virtually in the current working directory, but is physically
+ -- in another directory.
+
+end Prj.Part;