lynx-dev [dev17 patch] cookie options documentation

[brian j pardy]

Here's a bit of improved documentation for the cookie options that
have recently been added, and a couple fixes for some abysmal grammar
of mine that has been around a while.

Klaus, if you can think of a better way to explain some of these
options, please do. :)

Once we have some kind of generally accepted wording, we can get these
into the user's guide (if someone wants to volunteer to document
these, I'd really appreciate it, I'm no good at such things).


diff -cr 2.8.2dev.17/lynx.cfg 2.8.2dev.17.bri/lynx.cfg
*** 2.8.2dev.17/lynx.cfg        Wed Feb 17 06:29:33 1999
--- 2.8.2dev.17.bri/lynx.cfg    Fri Feb 19 19:30:55 1999
***************
*** 834,848 ****
  #
  #ACCEPT_ALL_COOKIES:FALSE
  
! # COOKIE_ACCEPT_DOMAINS and COOKIE_REJECT_DOMAINS are comma-delimited lists of
! # domains (with a leading '.') to automatically accept or reject all cookies
! # from.  These can also be specified in the lynxrc file, and are overridden by
! # the ACCEPT_ALL_COOKIES parameter.  If a single domain is specified in both
! # COOKIE_ACCEPT_DOMAINS and in COOKIE_REJECT_DOMAINS, the rejection will take
! # precedence.
  #
  #COOKIE_ACCEPT_DOMAINS:
  #COOKIE_REJECT_DOMAINS:
  
  # COOKIE_FILE is the default file to store persistent downloaded cookies
  # in, if Lynx was compiled with EXP_PERSISTENT_COOKIES.  The cookie file
--- 834,859 ----
  #
  #ACCEPT_ALL_COOKIES:FALSE
  
! # COOKIE_ACCEPT_DOMAINS and COOKIE_REJECT_DOMAINS are comma-delimited lists
! # of domains from which Lynx should automatically accept or reject all 
! # cookies.  If a domain is specified in both options, rejection will take
! # precedence.  The ACCEPT_ALL_COOKIES parameter will override any settings
! # made here.
  #
  #COOKIE_ACCEPT_DOMAINS:
  #COOKIE_REJECT_DOMAINS:
+ 
+ # COOKIE_LOOSE_INVALID_DOMAINS, COOKIE_STRICT_INVALID_DOMAINS, and
+ # COOKIE_QUERY_INVALID_DOMAINS are comma-delimited lists of which domains
+ # should be subjected to varying degrees of validity checking.  If a
+ # domain is set to strict checking, strict conformance to RFC2109 will
+ # be applied.  A domain with loose checking will be allowed to set cookies
+ # with an invalid path or domain attribute.  All domains will default to
+ # querying the user for an invalid path or domain.
+ #
+ #COOKIE_LOOSE_INVALID_DOMAINS:
+ #COOKIE_STRICT_INVALID_DOMAINS:
+ #COOKIE_QUERY_INVALID_DOMAINS:
  
  # COOKIE_FILE is the default file to store persistent downloaded cookies
  # in, if Lynx was compiled with EXP_PERSISTENT_COOKIES.  The cookie file
diff -cr 2.8.2dev.17/src/LYrcFile.c 2.8.2dev.17.bri/src/LYrcFile.c
*** 2.8.2dev.17/src/LYrcFile.c  Wed Feb 17 06:29:33 1999
--- 2.8.2dev.17.bri/src/LYrcFile.c      Fri Feb 19 19:39:33 1999
***************
*** 897,907 ****
  
      fprintf(fp, gettext("\
  # cookie_accept_domains and cookie_reject_domains are comma-delimited\n\
! # lists of domains (with a leading '.') to automatically accept or\n\
! # reject all cookies from.  The accept_all_cookies parameter will\n\
! # override any settings made here.  If a single domain is specified in\n\
! # both cookie_accept_domains and in cookie_reject_domains, the rejection\n\
! # will take precedence.\n"));
      fprintf(fp, "cookie_accept_domains=%s\n",
                    (LYCookieAcceptDomains == NULL ? ""
                    : LYCookieAcceptDomains));
--- 897,906 ----
  
      fprintf(fp, gettext("\
  # cookie_accept_domains and cookie_reject_domains are comma-delimited\n\
! # lists of domains from which Lynx should automatically accept or reject\n\
! # all cookies.  If a domain is specified in both options, rejection will\n\
! # take precedence.  The accept_all_cookies parameter will override any\n\
! # settings made here.\n"));
      fprintf(fp, "cookie_accept_domains=%s\n",
                    (LYCookieAcceptDomains == NULL ? ""
                    : LYCookieAcceptDomains));
***************
*** 912,920 ****
  
      fprintf(fp, gettext("\
  # cookie_loose_invalid_domains, cookie_strict_invalid_domains, and\n\
! # cookie_query_invalid_domains control checking incoming cookies'\n\
! # conformance to RFCNNNN.\n\
! # XXX FIXME\n"));
      fprintf(fp, "cookie_loose_invalid_domains=%s\n",
            (LYCookieLooseCheckDomains == NULL) ? ""
                    : LYCookieLooseCheckDomains);
--- 911,922 ----
  
      fprintf(fp, gettext("\
  # cookie_loose_invalid_domains, cookie_strict_invalid_domains, and\n\
! # cookie_query_invalid_domains are comma-delimited lists of which domains\n\
! # should be subjected to varying degrees of validity checking.  If a\n\
! # domain is set to strict checking, strict conformance to RFC2109 will\n\
! # be applied.  A domain with loose checking will be allowed to set cookies\n\
! # with an invalid path or domain attribute.  All domains will default to\n\
! # querying the user for an invalid path or domain.\n"));
      fprintf(fp, "cookie_loose_invalid_domains=%s\n",
            (LYCookieLooseCheckDomains == NULL) ? ""
                    : LYCookieLooseCheckDomains);

-- 
WANTED: Dead or Alive -- Schrodeinger's Cat