-- This package provides various file utilities.
--
package Low_Level_File_Utilities is

    procedure Append (This_File : in String;
                      To_This_File : in String;
                      Add_Page_Break : in Boolean := False);
    --
    -- This procedure appends the first file to the second file.
    -- If "Add_Page_Break" is True, the second file will be
    -- preceeded by a page break, unless the first file doesn't
    -- exist yet, in which case the second file needs no page
    -- break because there is nothing for it to be separated from.
    --
    -- Raises "IO_Failure" if the operation fails for some reason.

    function Flattened_Text (This_File : in String) return String;
    --
    -- This function returns a string containing the contents of
    -- the specified file separated by ASCII.LF's.
    --
    -- Raises "IO_Failure" if the operation fails for some reason.

    Io_Failure : exception;

end Low_Level_File_Utilities;