OSDN Git Service

2010-10-05 Ed Schonberg <schonberg@adacore.com>
[pf3gnuchains/gcc-fork.git] / gcc / ada / mdll.ads
index e4ae999..45c6a45 100644 (file)
@@ -6,22 +6,20 @@
 --                                                                          --
 --                                 S p e c                                  --
 --                                                                          --
---                                                                          --
---          Copyright (C) 1992-2001 Free Software Foundation, Inc.          --
+--          Copyright (C) 1992-2008, 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. --
--- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). --
+-- Extensive contributions were provided by Ada Core Technologies Inc.      --
 --                                                                          --
 ------------------------------------------------------------------------------
 
@@ -29,6 +27,7 @@
 --  to build Windows DLL
 
 with GNAT.OS_Lib;
+--  Should have USE here ???
 
 package MDLL is
 
@@ -37,20 +36,21 @@ package MDLL is
 
    Null_Argument_List : constant Argument_List := (1 .. 0 => new String'(""));
 
-   Null_Argument_List_Access : Argument_List_Access
-     := new Argument_List (1 .. 0);
+   Null_Argument_List_Access : Argument_List_Access :=
+                                 new Argument_List (1 .. 0);
 
-   Tools_Error    : exception;
+   Tools_Error : exception;
+   --  Comment required
 
-   Verbose        : Boolean := False;
-   Quiet          : Boolean := False;
+   Verbose : Boolean := False;
+   Quiet   : Boolean := False;
+   --  Comment required ???
 
+   Kill_Suffix : Boolean := False;
    --  Kill_Suffix is used by dlltool to know whether or not the @nn suffix
    --  should be removed from the exported names. When Kill_Suffix is set to
    --  True then dlltool -k option is used.
 
-   Kill_Suffix    : Boolean := False;
-
    procedure Build_Dynamic_Library
      (Ofiles        : Argument_List;
       Afiles        : Argument_List;
@@ -61,14 +61,16 @@ package MDLL is
       Def_Filename  : String;
       Lib_Address   : String  := "";
       Build_Import  : Boolean := False;
-      Relocatable   : Boolean := False);
+      Relocatable   : Boolean := False;
+      Map_File      : Boolean := False);
    --  Build a DLL and the import library to link against the DLL.
    --  this function handles relocatable and non relocatable DLL.
    --  If the Afiles argument list contains some Ada units then it will
    --  generate the right adainit and adafinal and integrate it in the DLL.
    --  If the Afiles argument list is empty (there is only some object files
    --  provided) then it will not try to build a binder file. This is ok to
-   --  build DLL containing no Ada code.
+   --  build DLL containing no Ada code. If Map_File is set to True, a map
+   --  file named Lib_Filename & ".map" will be created.
 
    procedure Build_Import_Library
      (Lib_Filename : String;