-------------------------
update_session() FUNCTION
-------------------------

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

    Within a PREPROCESS tag:

    &update_session();

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

    Removes all PTM Session cookies and then replaces the cookie set with
    currently applicable %_SESSION values. This function should be called after
    all intended %_SESSION modification has been made, before the end of the
    PREPROCESS tags to update session cookie information in the HTTP headers.
    May be used ONLY in a PREPROCESS tag.

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

    NONE

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

    NONE

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

    --------------------------------------------------------------------------
    Example 1: Updating the Session After Adding a Color Cookie to the Session
    --------------------------------------------------------------------------

      <?:
        &session_add('Color', 'red');
        &update_session();
      ?>

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

    TAGS

      PREPROCESS

    VARIABLES

      %_COOKIES, %_SESSION, %_SET_COOKIES

    FUNCTIONS

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