OSDN Git Service

* common.opt (Wmudflap): New option.
[pf3gnuchains/gcc-fork.git] / gcc / ada / prj-proc.ads
index bda95ca..1074f3a 100644 (file)
@@ -6,39 +6,78 @@
 --                                                                          --
 --                                 S p e c                                  --
 --                                                                          --
---                                                                          --
---             Copyright (C) 2001 Free Software Foundation, Inc.            --
+--          Copyright (C) 2001-2007, 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,  59 Temple Place - Suite 330,  Boston, --
--- MA 02111-1307, 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.      --
 --                                                                          --
 ------------------------------------------------------------------------------
---
+
 --  This package is used to convert a project file tree (see prj-tree.ads) to
---  project file data structures (see prj.ads), taking into account
---  the environment (external references).
+--  project file data structures (see prj.ads), taking into account the
+--  environment (external references).
 
 with Prj.Tree;  use Prj.Tree;
 
 package Prj.Proc is
 
    procedure Process
-     (Project           : out Project_Id;
-      From_Project_Node : Project_Node_Id;
-      Report_Error      : Put_Line_Access);
-   --  Process a project file tree into project file data structures.
-   --  If Report_Error is null, use the standard error reporting mechanism
-   --  (Errout). Otherwise, report errors using Report_Error.
+     (In_Tree                : Project_Tree_Ref;
+      Project                : out Project_Id;
+      Success                : out Boolean;
+      From_Project_Node      : Project_Node_Id;
+      From_Project_Node_Tree : Project_Node_Tree_Ref;
+      Report_Error           : Put_Line_Access;
+      When_No_Sources        : Error_Warning := Error;
+      Reset_Tree             : Boolean := True;
+      Current_Dir            : String := "");
+   --  Process a project file tree into project file data structures. If
+   --  Report_Error is null, use the error reporting mechanism. Otherwise,
+   --  report errors using Report_Error.
+   --
+   --  Current_Dir is for optimization purposes, avoiding extra system calls.
+   --
+   --  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.
+   --
+   --  Process is a bit of a junk name, how about Process_Project_Tree???
+
+   --  The two procedures that follow are implementing procedure Process in
+   --  two successive phases. They are used by gprbuild/gprclean to add the
+   --  configuration attributes between the two phases.
+
+   procedure Process_Project_Tree_Phase_1
+     (In_Tree                : Project_Tree_Ref;
+      Project                : out Project_Id;
+      Success                : out Boolean;
+      From_Project_Node      : Project_Node_Id;
+      From_Project_Node_Tree : Project_Node_Tree_Ref;
+      Report_Error           : Put_Line_Access;
+      Reset_Tree             : Boolean := True);
+   --  See documentation of parameters in procedure Process above
+
+   procedure Process_Project_Tree_Phase_2
+     (In_Tree                : Project_Tree_Ref;
+      Project                : Project_Id;
+      Success                : out Boolean;
+      From_Project_Node      : Project_Node_Id;
+      From_Project_Node_Tree : Project_Node_Tree_Ref;
+      Report_Error           : Put_Line_Access;
+      When_No_Sources        : Error_Warning := Error;
+      Current_Dir            : String);
+   --  See documentation of parameters in procedure Process above
 
 end Prj.Proc;