--------------------
_PTM_FILE() FUNCTION
--------------------

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

    DO NOT USE THIS FUNCTION

    Althought _PTM_FILE() is a publicly acessible function, it is not intended
    for public use. _PTM_FILE() simply calls the get_file_text() function and
    passes the returned string to the _PTM() function. This is one of the first
    things called after overhead processing has occured in the PPA (PTM Parser
    Application) [ptm.cgi], and should really only be called once outside of
    its secondary recursive nature within _PTM().

    Although there are a small set of safe instances in which to call this
    function directly, it is not recommended for the average developer.

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

    VARIABLES

      @_PTM, $_PTM_POS, $_PTM_PREPROCESS, @_REQUIRE

    FUNCTIONS

      _PTM(), get_file_text()