mlib-tgt-vms-ia64.adb, [...] (Is_Interface): Change Ada bind file prefix on VMS from...

[gcc.git] / gcc / ada / g-os_lib.ads

diff --git a/gcc/ada/g-os_lib.ads b/gcc/ada/g-os_lib.ads
index 6c09b607252012a04b79cac701093bf6cd6bd3ca..8360d35e5e68c7c5a59cc7c27a3d5712b6a7ef04 100644 (file)
--- a/gcc/ada/g-os_lib.ads
+++ b/gcc/ada/g-os_lib.ads
@@ -520,17 +520,29 @@ package GNAT.OS_Lib is
    function Get_Debuggable_Suffix return String_Access;
    --  Return the debuggable suffix convention. Usually this is the same as
    --  the convention for Get_Executable_Suffix. The result is allocated on
-   --  the heap and should be freed when no longer needed to avoid storage
+   --  the heap and should be freed after use to avoid storage leaks.
+
+   function Get_Target_Debuggable_Suffix return String_Access;
+   --  Return the target debuggable suffix convention. Usually this is the
+   --  same as the convention for Get_Executable_Suffix. The result is
+   --  allocated on the heap and should be freed after use to avoid storage
    --  leaks.
 
    function Get_Executable_Suffix return String_Access;
-   --  Return the executable suffix convention. The result is allocated on
-   --  the heap and should be freed when no longer needed to avoid storage
-   --  leaks.
+   --  Return the executable suffix convention. The result is allocated on the
+   --  heap and should be freed after use to avoid storage leaks.
 
    function Get_Object_Suffix return String_Access;
-   --  Return the object suffix convention. The result is allocated on the
-   --  heap and should be freed when no longer needed to avoid storage leaks.
+   --  Return the object suffix convention. The result is allocated on the heap
+   --  and should be freed after use to avoid storage leaks.
+
+   function Get_Target_Executable_Suffix return String_Access;
+   --  Return the target executable suffix convention. The result is allocated
+   --  on the heap and should be freed after use to avoid storage leaks.
+
+   function Get_Target_Object_Suffix return String_Access;
+   --  Return the target object suffix convention. The result is allocated on
+   --  the heap and should be freed after use to avoid storage leaks.
 
    --  The following section contains low-level routines using addresses to
    --  pass file name and executable name. In each routine the name must be
@@ -706,12 +718,12 @@ package GNAT.OS_Lib is
       Args         : Argument_List)
       return         Process_Id;
    --  This is a non blocking call. The Process_Id of the spawned process is
-   --  returned. Parameters are to be used as in Spawn. If Invalid_Id is
+   --  returned. Parameters are to be used as in Spawn. If Invalid_Pid is
    --  returned the program could not be spawned.
    --
    --  "Non_Blocking_Spawn" should not be used in tasking applications.
    --
-   --  This function will always return Invalid_Id under VxWorks, since there
+   --  This function will always return Invalid_Pid under VxWorks, since there
    --  is no notion of executables under this OS.
 
    function Non_Blocking_Spawn
@@ -721,12 +733,12 @@ package GNAT.OS_Lib is
       Err_To_Out             : Boolean := True) return Process_Id;
    --  Similar to the procedure above, but redirects the output to the file
    --  designated by Output_File_Descriptor. If Err_To_Out is True, then the
-   --  Standard Error output is also redirected. Invalid_Id is returned
+   --  Standard Error output is also redirected. Invalid_Pid is returned
    --  if the program could not be spawned successfully.
    --
    --  "Non_Blocking_Spawn" should not be used in tasking applications.
    --
-   --  This function will always return Invalid_Id under VxWorks, since there
+   --  This function will always return Invalid_Pid under VxWorks, since there
    --  is no notion of executables under this OS.
 
    function Non_Blocking_Spawn
@@ -739,13 +751,13 @@ package GNAT.OS_Lib is
    --  a file with the name Output_File.
    --
    --  Success is set to True if the command is executed and its output
-   --  successfully written to the file. Invalid_Id is returned if the output
+   --  successfully written to the file. Invalid_Pid is returned if the output
    --  file could not be created or if the program could not be spawned
    --  successfully.
    --
    --  "Non_Blocking_Spawn" should not be used in tasking applications.
    --
-   --  This function will always return Invalid_Id under VxWorks, since there
+   --  This function will always return Invalid_Pid under VxWorks, since there
    --  is no notion of executables under this OS.
 
    procedure Wait_Process (Pid : out Process_Id; Success : out Boolean);
@@ -757,7 +769,7 @@ package GNAT.OS_Lib is
    --  Wait_Process is immediate. Pid identifies the process that has
    --  terminated (matching the value returned from Non_Blocking_Spawn).
    --  Success is set to True if this sub-process terminated successfully. If
-   --  Pid = Invalid_Id, there were no subprocesses left to wait on.
+   --  Pid = Invalid_Pid, there were no subprocesses left to wait on.
    --
    --  This function will always set success to False under VxWorks, since
    --  there is no notion of executables under this OS.