bug#30154: [PATCH] web: Export http-request.

[ludo@gnu.org (Ludovic Courtès)]

[-- Attachment #1: Type: text/plain, Size: 406 bytes --]

Hello Arun,

Arun Isaac <arunisaac@systemreboot.net> skribis:

> * module/web/client.scm (request): Rename to http-request, add a
> docstring, and export it.
> (http-get, http-head, http-post, http-put, http-delete, http-trace,
> http-options): Update docstring.
> * doc/ref/web.texi (Web Client): Document http-request.

Awesome!  Applied with the tiny changes below.

Thank you,
Ludo’.


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: Type: text/x-patch, Size: 2391 bytes --]

diff --git a/doc/ref/web.texi b/doc/ref/web.texi
index e99907fe3..62b25d889 100644
--- a/doc/ref/web.texi
+++ b/doc/ref/web.texi
@@ -1,6 +1,6 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Guile Reference Manual.
-@c Copyright (C) 2010, 2011, 2012, 2013, 2015 Free Software Foundation, Inc.
+@c Copyright (C) 2010, 2011, 2012, 2013, 2015, 2018 Free Software Foundation, Inc.
 @c See the file guile.texi for copying conditions.
 
 @node Web
@@ -1467,7 +1467,7 @@ how to install the GnuTLS bindings for Guile,, gnutls-guile,
 GnuTLS-Guile}, for more information.
 @end deffn
 
-@anchor{http-request}@deffn {Scheme Procedure} http-request uri arg...
+@anchor{http-request}@deffn {Scheme Procedure} http-request @var{uri} @var{arg}@dots{}
 
 Connect to the server corresponding to @var{uri} and make a request over
 HTTP, using @var{method} (@code{GET}, @code{HEAD}, @code{POST}, etc.).
@@ -1516,22 +1516,21 @@ body as a string, bytevector, #f value, or as a port (if
 @var{streaming?} is true).
 @end deffn
 
-@deffn {Scheme Procedure} http-get uri arg...
-@deffnx {Scheme Procedure} http-head uri arg...
-@deffnx {Scheme Procedure} http-post uri arg...
-@deffnx {Scheme Procedure} http-put uri arg...
-@deffnx {Scheme Procedure} http-delete uri arg...
-@deffnx {Scheme Procedure} http-trace uri arg...
-@deffnx {Scheme Procedure} http-options uri arg...
-
+@deffn {Scheme Procedure} http-get @var{uri} @var{arg}@dots{}
+@deffnx {Scheme Procedure} http-head @var{uri} @var{arg}@dots{}
+@deffnx {Scheme Procedure} http-post @var{uri} @var{arg}@dots{}
+@deffnx {Scheme Procedure} http-put @var{uri} @var{arg}@dots{}
+@deffnx {Scheme Procedure} http-delete @var{uri} @var{arg}@dots{}
+@deffnx {Scheme Procedure} http-trace @var{uri} @var{arg}@dots{}
+@deffnx {Scheme Procedure} http-options @var{uri} @var{arg}@dots{}
 Connect to the server corresponding to @var{uri} and make a request over
 HTTP, using the appropriate method (@code{GET}, @code{HEAD},
 @code{POST}, etc.).
 
 These procedures are variants of @code{http-request} specialized with a
 specific @var{method} argument, and have the same prototype: a URI
-followed by an optional sequence of keyword arguments.  See
-@ref{http-request} for full documentation on the various keyword
+followed by an optional sequence of keyword arguments.
+@xref{http-request}, for full documentation on the various keyword
 arguments.
 
 @end deffn