------------------------
delete_cookie() FUNCTION
------------------------

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

    Within a PREPROCESS tag:

    &delete_cookie($name)
    &delete_cookie($name, $domain)
    &delete_cookie($name, $domain, $path)

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

    Deletes a cookie from the end user's cache, using the standard '-1d' format.
    May ONLY be used in a PREPROCESS tag.

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

    $name

      REQUIRED

      The name of the cookie (case sensitive if replacing a set_cookie()
      statement)

    $domain

      OPTIONAL/REQUIRED

      The domain assigned to the cookie. By default this is the host server,
      such as '.mydomain.com'. Only required if another domain was set in the
      initial cookie.

    $path

      OPTIONAL/REQUIRED

      The path assigned to the cookie. By default this is set to '/'. Only
      required if a different path was set to the initial cookie.

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

    NONE

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

    ----------------------------
    Example 1: Deleting a Cookie
    ----------------------------

      <?: delete_cookie('color', '.mycomain.com', '/'); ?>

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

    TAGS

      PREPROCESS

    VARIABLES

      %_COOKIES, %_SESSION, %_SET_COOKIES

    FUNCTIONS

      set_cookie()