-- --
-- S p e c --
-- --
--- Copyright (C) 1992-2005 Free Software Foundation, Inc. --
+-- Copyright (C) 1992-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- --
-- 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. --
-- Extensive contributions were provided by Ada Core Technologies Inc. --
-- Type Support Subprogram (TSS) handling
+with Namet; use Namet;
with Types; use Types;
package Exp_Tss is
-- TSS Naming --
----------------
- -- A TSS is identified by its Chars name. The name has the form typXY,
- -- where typ is the type name, and XY are two characters that identify
- -- the particular TSS routine, using the following codes:
+ -- A TSS is identified by its Chars name. The name has the form typXY or
+ -- typ_<serial>XY, where typ is the type name, and XY are two characters
+ -- that identify the particular TSS routine. A unique serial number is
+ -- included for the case where several local instances of the same TSS
+ -- must be generated (see discussion under Make_TSS_Name_Local).
+
+ -- The following codes are used to denote TSSs:
-- Note: When making additions to this list, update the list in snames.adb
function Make_TSS_Name_Local
(Typ : Entity_Id;
Nam : TSS_Name_Type) return Name_Id;
- -- Similar to the above call, but a string of the form _nnn is appended
- -- to the name, where nnn is a unique serial number. This is used when
- -- multiple instances of the same TSS routine may be generated in the
- -- same scope (see also discussion above of current limitations).
+ -- Similar to the above call, but a string of the form _nnn is inserted
+ -- before the TSS code suffix, where nnn is a unique serial number. This
+ -- is used when multiple instances of the same TSS routine may be
+ -- generated in the same scope (see also discussion above of current
+ -- limitations).
function Make_Init_Proc_Name (Typ : Entity_Id) return Name_Id;
-- Version for init procs, same as Make_TSS_Name (Typ, TSS_Init_Proc)
procedure Set_TSS (Typ : Entity_Id; TSS : Entity_Id);
-- This procedure is used to install a newly created TSS. The second
- -- argument is the entity for such a new TSS. This entity is placed in
- -- the TSS list for the type given as the first argument, replacing an
- -- old entry of the same name if one was present. The tree for the body
- -- of this TSS, which is not analyzed yet, is placed in the actions field
- -- of the freeze node for the type. All such bodies are inserted into the
- -- main tree and analyzed at the point at which the freeze node itself is
- -- is expanded.
+ -- argument is the entity for such a new TSS. This entity is placed in the
+ -- TSS list for the type given as the first argument, replacing an old
+ -- entry of the same name if one was present. The tree for the body of this
+ -- TSS, which is not analyzed yet, is placed in the actions field of the
+ -- freeze node for the type. All such bodies are inserted into the main
+ -- tree and analyzed at the point at which the freeze node itself is
+ -- expanded.
procedure Copy_TSS (TSS : Entity_Id; Typ : Entity_Id);
-- Given an existing TSS for another type (which is already installed,
-- analyzed and expanded), install it as the corresponding TSS for Typ.
- -- Note that this just copies a reference, not the tree. This can also
- -- be used to initially install a TSS in the case where the subprogram
- -- for the TSS has already been created and its declaration processed.
+ -- Note that this just copies a reference, not the tree. This can also be
+ -- used to initially install a TSS in the case where the subprogram for the
+ -- TSS has already been created and its declaration processed.
function Init_Proc (Typ : Entity_Id) return Entity_Id;
pragma Inline (Init_Proc);
-- the corresponding base type (see Base_Init_Proc function). A special
-- case arises for concurrent types. Such types do not themselves have an
-- init proc TSS, but initialization is required. The init proc used is
- -- the one fot the corresponding record type (see Base_Init_Proc).
+ -- the one for the corresponding record type (see Base_Init_Proc).
function Base_Init_Proc (Typ : Entity_Id) return Entity_Id;
-- Obtains the _Init TSS entry from the base type of the entity, and also