From 488fda33e412015a8df22a87e545fcd90a2ae758 Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Thu, 19 Feb 2015 10:39:30 -0700 Subject: [PATCH] document new `options-put-port` and `options-impure-port` --- net-doc/net/scribblings/url.scrbl | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/net-doc/net/scribblings/url.scrbl b/net-doc/net/scribblings/url.scrbl index fbeb0740ca..be2408de5c 100644 --- a/net-doc/net/scribblings/url.scrbl +++ b/net-doc/net/scribblings/url.scrbl @@ -239,9 +239,12 @@ Internally, @racket['recommended] mode uses @defproc[(delete-pure-port [URL url?] [header (listof string?) null]) input-port?] +@defproc[(options-pure-port [URL url?] + [header (listof string?) null]) + input-port?] )]{ -Initiates a GET/HEAD/DELETE request for @racket[URL] and returns a +Initiates a GET/HEAD/DELETE/OPTIONS request for @racket[URL] and returns a @tech{pure port} corresponding to the body of the response. The optional list of strings can be used to send header lines to the server. @@ -269,7 +272,9 @@ in the context with @racket[ssl-set-verify!]. The @racket["file"] scheme for URLs is handled only by @racket[get-pure-port], which uses @racket[open-input-file], does not -handle exceptions, and ignores the optional strings.} +handle exceptions, and ignores the optional strings. + +@history[#:changed "6.1.1.8" @elem{Added @racket[options-pure-port].}]} @deftogether[( @defproc[(get-impure-port [URL url?] @@ -281,11 +286,16 @@ handle exceptions, and ignores the optional strings.} @defproc[(delete-impure-port [URL url?] [header (listof string?) null]) input-port?] +@defproc[(options-impure-port [URL url?] + [header (listof string?) null]) + input-port?] )]{ Like @racket[get-pure-port], etc., but the resulting @tech{impure port} contains both the returned headers and the body. The -@racket["file"] URL scheme is not handled by these functions.} +@racket["file"] URL scheme is not handled by these functions. + +@history[#:changed "6.1.1.8" @elem{Added @racket[options-impure-port].}]} @deftogether[( @defproc[(post-pure-port [URL url?]