summaryrefslogtreecommitdiff
path: root/gcc/ada/prj-ext.ads
diff options
context:
space:
mode:
Diffstat (limited to 'gcc/ada/prj-ext.ads')
-rw-r--r--gcc/ada/prj-ext.ads68
1 files changed, 68 insertions, 0 deletions
diff --git a/gcc/ada/prj-ext.ads b/gcc/ada/prj-ext.ads
new file mode 100644
index 000000000..1fb389c4a
--- /dev/null
+++ b/gcc/ada/prj-ext.ads
@@ -0,0 +1,68 @@
+------------------------------------------------------------------------------
+-- --
+-- GNAT COMPILER COMPONENTS --
+-- --
+-- P R J . E X T --
+-- --
+-- S p e c --
+-- --
+-- Copyright (C) 2000-2010, 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. --
+-- --
+------------------------------------------------------------------------------
+
+-- Subprograms to set, get and cache external references, to be used as
+-- External functions in project files.
+
+with Prj.Tree;
+
+package Prj.Ext is
+
+ -------------------------
+ -- External References --
+ -------------------------
+
+ -- External references influence the way a project tree is processed (in
+ -- particular they provide the values for the typed string variables that
+ -- are then used in case constructions).
+
+ -- External references are project-tree specific, so that when multiple
+ -- trees are loaded in parallel we can have different scenarios (or even
+ -- load the same tree twice and see different views of it).
+
+ procedure Add
+ (Tree : Prj.Tree.Project_Node_Tree_Ref;
+ External_Name : String;
+ Value : String);
+ -- Add an external reference (or modify an existing one)
+
+ function Value_Of
+ (Tree : Prj.Tree.Project_Node_Tree_Ref;
+ External_Name : Name_Id;
+ With_Default : Name_Id := No_Name)
+ return Name_Id;
+ -- Get the value of an external reference, and cache it for future uses
+
+ function Check
+ (Tree : Prj.Tree.Project_Node_Tree_Ref;
+ Declaration : String) return Boolean;
+ -- Check that an external declaration <external>=<value> is correct.
+ -- If it is correct, the external reference is Added.
+
+ procedure Reset (Tree : Prj.Tree.Project_Node_Tree_Ref);
+ -- Clear the internal data structure that stores the external references
+ -- and free any allocated memory.
+
+end Prj.Ext;