annotate gcc/ada/nmake.adt @ 131:84e7813d76e9

gcc-8.2
author mir3636
date Thu, 25 Oct 2018 07:37:49 +0900
parents 04ced10e8804
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
111
kono
parents:
diff changeset
1 ------------------------------------------------------------------------------
kono
parents:
diff changeset
2 -- --
kono
parents:
diff changeset
3 -- GNAT COMPILER COMPONENTS --
kono
parents:
diff changeset
4 -- --
kono
parents:
diff changeset
5 -- N M A K E --
kono
parents:
diff changeset
6 -- --
kono
parents:
diff changeset
7 -- T e m p l a t e --
kono
parents:
diff changeset
8 -- --
kono
parents:
diff changeset
9 -- Copyright (C) 1992-2007, Free Software Foundation, Inc. --
kono
parents:
diff changeset
10 -- --
kono
parents:
diff changeset
11 -- GNAT is free software; you can redistribute it and/or modify it under --
kono
parents:
diff changeset
12 -- terms of the GNU General Public License as published by the Free Soft- --
kono
parents:
diff changeset
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
kono
parents:
diff changeset
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
kono
parents:
diff changeset
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
kono
parents:
diff changeset
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
kono
parents:
diff changeset
17 -- for more details. You should have received a copy of the GNU General --
kono
parents:
diff changeset
18 -- Public License distributed with GNAT; see file COPYING3. If not, go to --
kono
parents:
diff changeset
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
kono
parents:
diff changeset
20 -- --
kono
parents:
diff changeset
21 -- GNAT was originally developed by the GNAT team at New York University. --
kono
parents:
diff changeset
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
kono
parents:
diff changeset
23 -- --
kono
parents:
diff changeset
24 ------------------------------------------------------------------------------
kono
parents:
diff changeset
25 -- This file is a template used as input to the utility program XNmake,
kono
parents:
diff changeset
26 -- which reads this template, and the spec of Sinfo (sinfo.ads) and
kono
parents:
diff changeset
27 -- generates the body and/or the spec for the Nmake package (files
kono
parents:
diff changeset
28 -- nmake.ads and nmake.adb)
kono
parents:
diff changeset
29
kono
parents:
diff changeset
30 pragma Style_Checks (All_Checks);
kono
parents:
diff changeset
31 -- Turn off subprogram order checking, since the routines here are
kono
parents:
diff changeset
32 -- generated automatically in order.
kono
parents:
diff changeset
33
kono
parents:
diff changeset
34 with Atree; use Atree; -- body only
kono
parents:
diff changeset
35 with Namet; use Namet; -- spec only
kono
parents:
diff changeset
36 with Nlists; use Nlists; -- spec only
kono
parents:
diff changeset
37 with Sinfo; use Sinfo; -- body only
kono
parents:
diff changeset
38 with Snames; use Snames; -- body only
kono
parents:
diff changeset
39 with Stand; use Stand; -- body only
kono
parents:
diff changeset
40 with Types; use Types; -- spec only
kono
parents:
diff changeset
41 with Uintp; use Uintp; -- spec only
kono
parents:
diff changeset
42 with Urealp; use Urealp; -- spec only
kono
parents:
diff changeset
43
kono
parents:
diff changeset
44 package Nmake is
kono
parents:
diff changeset
45
kono
parents:
diff changeset
46 -- This package contains a set of routines used to construct tree nodes
kono
parents:
diff changeset
47 -- using a functional style. There is one routine for each node type defined
kono
parents:
diff changeset
48 -- in Sinfo with the general interface:
kono
parents:
diff changeset
49
kono
parents:
diff changeset
50 -- function Make_xxx (Sloc : Source_Ptr,
kono
parents:
diff changeset
51 -- Field_Name_1 : Field_Name_1_Type [:= default]
kono
parents:
diff changeset
52 -- Field_Name_2 : Field_Name_2_Type [:= default]
kono
parents:
diff changeset
53 -- ...)
kono
parents:
diff changeset
54 -- return Node_Id
kono
parents:
diff changeset
55
kono
parents:
diff changeset
56 -- Only syntactic fields are included (i.e. fields marked as "-Sem" or "-Lib"
kono
parents:
diff changeset
57 -- in the Sinfo spec are excluded). In addition, the following four syntactic
kono
parents:
diff changeset
58 -- fields are excluded:
kono
parents:
diff changeset
59
kono
parents:
diff changeset
60 -- Prev_Ids
kono
parents:
diff changeset
61 -- More_Ids
kono
parents:
diff changeset
62 -- Comes_From_Source
kono
parents:
diff changeset
63 -- Paren_Count
kono
parents:
diff changeset
64
kono
parents:
diff changeset
65 -- since they are very rarely set in expanded code. If they need to be set,
kono
parents:
diff changeset
66 -- to other than the default values (False, False, False, zero), then the
kono
parents:
diff changeset
67 -- appropriate Set_xxx procedures must be used on the returned value.
kono
parents:
diff changeset
68
kono
parents:
diff changeset
69 -- Default values are provided only for flag fields (where the default is
kono
parents:
diff changeset
70 -- False), and for optional fields. An optional field is one where the
kono
parents:
diff changeset
71 -- comment line describing the field contains the string "(set to xxx if".
kono
parents:
diff changeset
72 -- For such fields, a default value of xxx is provided."
kono
parents:
diff changeset
73
kono
parents:
diff changeset
74 -- Warning: since calls to Make_xxx routines are normal function calls, the
kono
parents:
diff changeset
75 -- arguments can be evaluated in any order. This means that at most one such
kono
parents:
diff changeset
76 -- argument can have side effects (e.g. be a call to a parse routine).
kono
parents:
diff changeset
77
kono
parents:
diff changeset
78 !!TEMPLATE INSERTION POINT
kono
parents:
diff changeset
79
kono
parents:
diff changeset
80 end Nmake;