2007-04-20 Ed Schonberg <schonberg@adacore.com>

[pf3gnuchains/gcc-fork.git] / gcc / ada / mlib-utl.ads

diff --git a/gcc/ada/mlib-utl.ads b/gcc/ada/mlib-utl.ads
index 64330f0..0050110 100644 (file)
--- a/gcc/ada/mlib-utl.ads
+++ b/gcc/ada/mlib-utl.ads
@@ -6,9 +6,7 @@
 --                                                                          --
 --                                 S p e c                                  --
 --                                                                          --
---                            $Revision: 1.2 $
---                                                                          --
---              Copyright (C) 2001, Ada Core Technologies, Inc.             --
+--                     Copyright (C) 2001-2006, AdaCore                     --
 --                                                                          --
 -- 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- --
@@ -18,11 +16,11 @@
 -- 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. --
--- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). --
+-- Extensive contributions were provided by Ada Core Technologies Inc.      --
 --                                                                          --
 ------------------------------------------------------------------------------
 
@@ -31,23 +29,31 @@
 
 package MLib.Utl is
 
-   procedure Delete_File (Filename : in String);
-   --  Delete the file Filename.
+   procedure Delete_File (Filename : String);
+   --  Delete the file Filename
+   --  Why is this different from the standard OS_Lib routine???
 
    procedure Gcc
      (Output_File : String;
       Objects     : Argument_List;
       Options     : Argument_List;
-      Base_File   : String := "");
-   --  Invoke gcc to create a library.
+      Options_2   : Argument_List;
+      Driver_Name : Name_Id := No_Name);
+   --  Driver_Name indicates the "driver" to invoke; by default, the "driver"
+   --  is gcc. This procedure invokes the driver to create a shared library.
+   --  Options are passed to gcc before the objects, Options_2 after.
+   --  Output_File is the name of the library file to create. Objects are the
+   --  names of the object files to put in the library.
 
    procedure Ar
      (Output_File : String;
       Objects     : Argument_List);
-   --  Run ar to move all the binaries inside the archive.
-   --  If ranlib is on the path, run it also.
+   --  Run ar to move all the binaries inside the archive. If ranlib is on the
+   --  path, run it also. Output_File is the path name of the archive to
+   --  create. Objects is the list of the path names of the object files to be
+   --  put in the archive.
 
    function Lib_Directory return String;
-   --  Return the directory containing libgnat.
+   --  Return the directory containing libgnat
 
 end MLib.Utl;