----------------------
end_session() FUNCTION
----------------------

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

    Within a PREPROCESS tag:

    &end_session();

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

    Ends the current, cookie-based PTM Session, and empties the %_SESSION hash
    variable. May ONLY be used within a PREPROCESS tag.

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

    NONE

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

    NONE

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

    -----------------------------------------------
    Example 1: If a Session Exists, End the Session
    -----------------------------------------------

      <?:
        if (&is_session()) {
          &end_session();
        }
      ?>

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

    TAGS

      PREPROCESS

    VARIABLES

      %_COOKIES, %_SESSION, %_SET_COOKIES

    FUNCTIONS

      delete_cookie(), is_session(), session_add(), session_delete(),
      session_domain(), session_id(), session_name(), session_path(),
      session_secure(), set_cookie(), start_session(), update_session()
