---------------------------
append_file_text() FUNCTION
---------------------------

  ------------
  USAGE FORMAT
  ------------

    Where $rv is the numeric return value:
    
    $rv = &append_file_text($file, $text);

  -----------
  DESCRIPTION
  -----------

    The append_file_text() function opens the requested file and adds the
    requested text to the end of it.

  ---------
  ARGUMENTS
  ---------

    $file

      REQUIRED
      
      The path/name of the file to be opened. This path may be either the
      absolute system path, or the path relative to the location of the calling
      PTM script file.

    $text

      REQUIRED

      The text to append to the end of the file. If this field is left blank, no
      text is appended.

  -------
  RETURNS
  -------

    1 if successful.
    0 if not successful.

  --------------
  USAGE EXAMPLES
  --------------

    -----------------------------------------------------------------
    Example 1: Appending "Test" to the End of a File Named "Test.txt"
    -----------------------------------------------------------------

      <? &append_file_text('Text.txt', 'Test'); ?>

  --------
  SEE ALSO
  --------

    TAGS

      DO

    FUNCTIONS
    
      get_file_text(), write_file_text()