OSDN Git Service

2010-10-05 Ed Schonberg <schonberg@adacore.com>
[pf3gnuchains/gcc-fork.git] / gcc / ada / mdll.ads
index 2a13be1..45c6a45 100644 (file)
@@ -6,23 +6,20 @@
 --                                                                          --
 --                                 S p e c                                  --
 --                                                                          --
---                            $Revision: 1.5 $
---                                                                          --
---          Copyright (C) 1992-2000 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.      --
 --                                                                          --
 ------------------------------------------------------------------------------
 
@@ -30,6 +27,7 @@
 --  to build Windows DLL
 
 with GNAT.OS_Lib;
+--  Should have USE here ???
 
 package MDLL is
 
@@ -38,40 +36,45 @@ 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        : in Argument_List;
-                                    Afiles        : in Argument_List;
-                                    Options       : in Argument_List;
-                                    Bargs_Options : in Argument_List;
-                                    Largs_Options : in Argument_List;
-                                    Lib_Filename  : in String;
-                                    Def_Filename  : in String;
-                                    Lib_Address   : in String  := "";
-                                    Build_Import  : in Boolean := False;
-                                    Relocatable   : in Boolean := False);
-   --  build a DLL and the import library to link against the DLL.
+   procedure Build_Dynamic_Library
+     (Ofiles        : Argument_List;
+      Afiles        : Argument_List;
+      Options       : Argument_List;
+      Bargs_Options : Argument_List;
+      Largs_Options : Argument_List;
+      Lib_Filename  : String;
+      Def_Filename  : String;
+      Lib_Address   : String  := "";
+      Build_Import  : 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 : in String;
-                                   Def_Filename : in String);
+   procedure Build_Import_Library
+     (Lib_Filename : String;
+      Def_Filename : String);
    --  Build an import library (.a) from a definition files. An import library
    --  is needed to link against a DLL.