2007-04-20 Vincent Celier <celier@adacore.com>

[pf3gnuchains/gcc-fork.git] / gcc / ada / prj-pars.ads

diff --git a/gcc/ada/prj-pars.ads b/gcc/ada/prj-pars.ads
index 47fd0bf..237a934 100644 (file)
--- a/gcc/ada/prj-pars.ads
+++ b/gcc/ada/prj-pars.ads
@@ -6,8 +6,7 @@
 --                                                                          --
 --                                 S p e c                                  --
 --                                                                          --
---                                                                          --
---          Copyright (C) 2000-2001 Free Software Foundation, Inc.          --
+--          Copyright (C) 2000-2005, 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- --
@@ -17,27 +16,39 @@
 -- 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,  59 Temple Place - Suite 330,  Boston, --
--- MA 02111-1307, USA.                                                      --
+-- to  the  Free Software Foundation,  51  Franklin  Street,  Fifth  Floor, --
+-- Boston, MA 02110-1301, USA.                                              --
 --                                                                          --
 -- GNAT was originally developed  by the GNAT team at  New York University. --
--- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). --
+-- Extensive contributions were provided by Ada Core Technologies Inc.      --
 --                                                                          --
 ------------------------------------------------------------------------------
---
---  Implements the parsing of project files.
+
+--  Implements the parsing of project files
 
 package Prj.Pars is
 
    procedure Set_Verbosity (To : Verbosity);
-   --  Set the verbosity when parsing the project files.
+   --  Set the verbosity when parsing the project files
 
    procedure Parse
-     (Project           : out Project_Id;
-      Project_File_Name : String);
-   --  Parse a project files and all its imported project files.
+     (In_Tree           : Project_Tree_Ref;
+      Project           : out Project_Id;
+      Project_File_Name : String;
+      Packages_To_Check : String_List_Access := All_Packages;
+      When_No_Sources   : Error_Warning := Error);
+   --  Parse a project files and all its imported project files, in the
+   --  project tree In_Tree.
+   --
    --  If parsing is successful, Project_Id is the project ID
    --  of the main project file; otherwise, Project_Id is set
    --  to No_Project.
+   --
+   --  Packages_To_Check indicates the packages where any unknown attribute
+   --  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.
 
 end Prj.Pars;