---------------
_PTM() FUNCTION
---------------

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

    DO NOT USE THIS FUNCTION

    Although _PTM() is a publicly accessible function, it is not intended for
    public use. _PTM() is, figuratively speaking, the heart of the PTM language.
    This function parses out all PTM script tags and evaluates them according to
    their type. In the process of doing so it adjusts the values of the global
    variables @_PTM, $_PTM_POS, $_PTM_PREPROCESS, and @_REQUIRE. _PTM() returns
    a string of Perl script to be evaluated, using the mentioned variables.

    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_FILE()