Merge pull request #1 from RenaissanceBug/rfc6265-cookies

Note the deprecation of this code and point to the new and better RFC6265-compliant net-cookies package.

net-doc/net/scribblings/cookie.scrbl

@@ -6,7 +6,17 @@
 @interaction-eval[#:eval cookie-eval (require net/cookie)]
 
 
-@title[#:tag "cookie"]{Cookie: HTTP Client Storage}
+@title[#:tag "cookie"]{Cookie: Legacy HTTP Client Storage}
+
+  @deprecated[@hyperlink["http://pkgs.racket-lang.org/#[net-cookies]"]{the
+               net-cookies package}]{
+    That package
+    (@hyperlink["https://github.com/RenaissanceBug/racket-cookies"]{source on
+               GitHub})
+    implements RFC 6265 @cite["RFC6265"] (which
+    supersedes RFC 2109) and supports creating cookies on the server
+    in an idiom more typical of Racket.
+  }
 
 @defmodule[net/cookie]{The @racketmodname[net/cookie] library provides
 utilities for using cookies as specified in RFC 2109 @cite["RFC2109"].}
@@ -180,7 +190,8 @@ won't have a cookie set then first arrive at your site.
 
 @margin-note{@racket[cookie@] and @racket[cookie^] are deprecated.
 They exist for backward-compatibility and will likely be removed in
-the future. New code should use the @racketmodname[net/cookie] module.}
+the future. New code should use the @racketmodname[net/cookies/server]
+or @racketmodname[net/cookies/user-agent] module.}
 
 @defmodule[net/cookie-unit]
 

net-doc/net/scribblings/net.scrbl

@@ -90,6 +90,12 @@
             #:url "http://www.ietf.org/rfc/rfc3986.txt"
             #:date "2005")
 
+ (bib-entry #:key "RFC6265"
+            #:title "HTTP State Management Mechanism"
+            #:author "A. Barth"
+            #:location "RFC"
+            #:url "http://tools.ietf.org/html/rfc6265.html"
+            #:date "2011")
 )
 
 @index-section[]