summaryrefslogtreecommitdiff
path: root/gcc/ada/nmake.adt
diff options
context:
space:
mode:
Diffstat (limited to 'gcc/ada/nmake.adt')
-rw-r--r--gcc/ada/nmake.adt83
1 files changed, 83 insertions, 0 deletions
diff --git a/gcc/ada/nmake.adt b/gcc/ada/nmake.adt
new file mode 100644
index 00000000000..bc7f1c4e24a
--- /dev/null
+++ b/gcc/ada/nmake.adt
@@ -0,0 +1,83 @@
+------------------------------------------------------------------------------
+-- --
+-- GNAT COMPILER COMPONENTS --
+-- --
+-- N M A K E --
+-- --
+-- T e m p l a t e --
+-- --
+-- $Revision: 1.12 $ --
+-- --
+-- Copyright (C) 1992-2001 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- --
+-- 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. --
+-- --
+-- 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). --
+-- --
+------------------------------------------------------------------------------
+
+pragma Style_Checks (All_Checks);
+-- Turn off subprogram order checking, since the routines here are
+-- generated automatically in order.
+
+-- This file is a template used as input to the utility program XNmake,
+-- which reads this template, and the spec of Sinfo (sinfo.ads) and
+-- generates the body and/or the spec for the Nmake package (files
+-- nmake.ads and nmake.adb)
+
+with Atree; use Atree; -- body only
+with Nlists; use Nlists; -- spec only
+with Sinfo; use Sinfo; -- body only
+with Snames; use Snames; -- body only
+with Stand; use Stand; -- body only
+with Types; use Types; -- spec only
+with Uintp; use Uintp; -- spec only
+with Urealp; use Urealp; -- spec only
+
+package Nmake is
+
+-- This package contains a set of routines used to construct tree nodes
+-- using a functional style. There is one routine for each node type defined
+-- in Sinfo with the general interface:
+
+-- function Make_xxx (Sloc : Source_Ptr,
+-- Field_Name_1 : Field_Name_1_Type [:= default]
+-- Field_Name_2 : Field_Name_2_Type [:= default]
+-- ...)
+-- return Node_Id
+
+-- Only syntactic fields are included (i.e. fields marked as "-Sem" or "-Lib"
+-- in the Sinfo spec are excluded). In addition, the following four syntactic
+-- fields are excluded:
+
+-- Prev_Ids
+-- More_Ids
+-- Comes_From_Source
+-- Paren_Count
+
+-- since they are very rarely set in expanded code. If they need to be set,
+-- to other than the default values (False, False, False, zero), then the
+-- appropriate Set_xxx procedures must be used on the returned value.
+
+-- Default values are provided only for flag fields (where the default is
+-- False), and for optional fields. An optional field is one where the
+-- comment line describing the field contains the string "(set to xxx if".
+-- For such fields, a default value of xxx is provided."
+
+-- Warning: since calls to Make_xxx routines are normal function calls, the
+-- arguments can be evaluated in any order. This means that at most one such
+-- argument can have side effects (e.g. be a call to a parse routine).
+
+!!TEMPLATE INSERTION POINT
+
+end Nmake;