[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/plz 278391562a 69/81: Docs: Tidy
From: |
ELPA Syncer |
Subject: |
[elpa] externals/plz 278391562a 69/81: Docs: Tidy |
Date: |
Wed, 11 May 2022 17:58:03 -0400 (EDT) |
branch: externals/plz
commit 278391562a7763f9f92ef54bab73aa7a5713c8a6
Author: Adam Porter <adam@alphapapa.net>
Commit: Adam Porter <adam@alphapapa.net>
Docs: Tidy
---
README.org | 36 ++++++++++++++++++------------------
1 file changed, 18 insertions(+), 18 deletions(-)
diff --git a/README.org b/README.org
index f96317c442..45cf09c95c 100644
--- a/README.org
+++ b/README.org
@@ -100,35 +100,35 @@ Synchronously download a JPEG file, then create an Emacs
image object from the d
** Functions
-+ ~plz~ :: /(method url &key headers body else finally noquery (as 'string)
(then 'sync) (body-type 'text) (decode t decode-s) (connect-timeout
plz-connect-timeout) (timeout plz-timeout))/
++ ~plz~ :: /(method url &key headers body else finally noquery (as 'string)
(then 'sync) (body-type 'text) (decode t decode-s) (connect-timeout
plz-connect-timeout) (timeout plz-timeout))/
- Request ~METHOD~ from ~URL~ with curl. Return the curl process object or,
for a synchronous request, the selected result.
+ Request ~METHOD~ from ~URL~ with curl. Return the curl process object or,
for a synchronous request, the selected result.
- ~HEADERS~ may be an alist of extra headers to send with the request.
+ ~HEADERS~ may be an alist of extra headers to send with the request.
- ~BODY-TYPE~ may be ~text~ to send ~BODY~ as text, or ~binary~ to send it as
binary.
+ ~BODY-TYPE~ may be ~text~ to send ~BODY~ as text, or ~binary~ to send it as
binary.
- ~AS~ selects the kind of result to pass to the callback function ~THEN~, or
the kind of result to return for synchronous requests. It may be:
+ ~AS~ selects the kind of result to pass to the callback function ~THEN~, or
the kind of result to return for synchronous requests. It may be:
- - ~buffer~ to pass the response buffer.
- - ~binary~ to pass the response body as an undecoded string.
- - ~string~ to pass the response body as a decoded string.
- - ~response~ to pass a ~plz-response~ struct.
- - A function, to pass its return value; it is called in the response
buffer, which is narrowed to the response body (suitable for, e.g. ~json-read~).
- - ~file~ to pass a temporary filename to which the response body has been
saved without decoding.
- - ~(file FILENAME)~ to pass ~FILENAME~ after having saved the response
body to it without decoding. ~FILENAME~ must be a non-existent file; if it
exists, it will not be overwritten, and an error will be signaled.
+ - ~buffer~ to pass the response buffer.
+ - ~binary~ to pass the response body as an undecoded string.
+ - ~string~ to pass the response body as a decoded string.
+ - ~response~ to pass a ~plz-response~ struct.
+ - A function, to pass its return value; it is called in the response
buffer, which is narrowed to the response body (suitable for, e.g. ~json-read~).
+ - ~file~ to pass a temporary filename to which the response body has been
saved without decoding.
+ - ~(file FILENAME)~ to pass ~FILENAME~ after having saved the response
body to it without decoding. ~FILENAME~ must be a non-existent file; if it
exists, it will not be overwritten, and an error will be signaled.
- If ~DECODE~ is non-nil, the response body is decoded automatically. For
binary content, it should be nil. When ~AS~ is ~binary~, ~DECODE~ is
automatically set to nil.
+ If ~DECODE~ is non-nil, the response body is decoded automatically. For
binary content, it should be nil. When ~AS~ is ~binary~, ~DECODE~ is
automatically set to nil.
- ~THEN~ is a callback function, whose sole argument is selected above with
~AS~. Or ~THEN~ may be ~sync~ to make a synchronous request, in which case the
result is returned directly.
+ ~THEN~ is a callback function, whose sole argument is selected above with
~AS~. Or ~THEN~ may be ~sync~ to make a synchronous request, in which case the
result is returned directly.
- ~ELSE~ is an optional callback function called when the request fails with
one argument, a ~plz-error~ struct. If ~ELSE~ is nil, an error is signaled
when the request fails, either ~plz-curl-error~ or ~plz-http-error~ as
appropriate, with a ~plz-error~ struct as the error data. For synchronous
requests, this argument is ignored.
+ ~ELSE~ is an optional callback function called when the request fails with
one argument, a ~plz-error~ struct. If ~ELSE~ is nil, an error is signaled
when the request fails, either ~plz-curl-error~ or ~plz-http-error~ as
appropriate, with a ~plz-error~ struct as the error data. For synchronous
requests, this argument is ignored.
- ~FINALLY~ is an optional function called without argument after ~THEN~ or
~ELSE~, as appropriate. For synchronous requests, this argument is ignored.
+ ~FINALLY~ is an optional function called without argument after ~THEN~ or
~ELSE~, as appropriate. For synchronous requests, this argument is ignored.
- ~CONNECT-TIMEOUT~ and ~TIMEOUT~ are a number of seconds that limit how long
it takes to connect to a host and to receive a response from a host,
respectively.
+ ~CONNECT-TIMEOUT~ and ~TIMEOUT~ are a number of seconds that limit how long
it takes to connect to a host and to receive a response from a host,
respectively.
- ~NOQUERY~ is passed to ~make-process~, which see.
+ ~NOQUERY~ is passed to ~make-process~, which see.
** Tips
:PROPERTIES:
- [elpa] externals/plz f34efa052c 48/81: Fix: set-buffer-multibyte nil for binary, (continued)
- [elpa] externals/plz f34efa052c 48/81: Fix: set-buffer-multibyte nil for binary, ELPA Syncer, 2022/05/11
- [elpa] externals/plz e977a046a3 50/81: Change: (plz-http-response-status-line-regexp) Match at BOL, ELPA Syncer, 2022/05/11
- [elpa] externals/plz f12f907719 52/81: Change/Fix: (plz--curl) Disable Expect header, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 701e79c3e8 55/81: Tidy: Remove obsolete functions, ELPA Syncer, 2022/05/11
- [elpa] externals/plz b412258c9d 56/81: Add: :timeout argument (curl's --max-time), ELPA Syncer, 2022/05/11
- [elpa] externals/plz 87007fc612 57/81: Add: FIXMEs, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 709a14740f 58/81: Tidy: Docstrings, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 93a2ccaaa8 59/81: Fix: Run curl in temporary-file-directory, ELPA Syncer, 2022/05/11
- [elpa] externals/plz f2176dc56c 60/81: Change/Fix: Avoid command-line arguments, ELPA Syncer, 2022/05/11
- [elpa] externals/plz ac5bc006f3 62/81: Docs: Add readme, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 278391562a 69/81: Docs: Tidy,
ELPA Syncer <=
- [elpa] externals/plz a5ccf48d80 70/81: Tests: Add check/error to a test, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 2f48423834 72/81: Docs: Add mascot, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 0b32c64f77 74/81: Notes: Rename file, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 7e456638a6 75/81: Meta: Move notes to orphan branch, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 69d5bf74f6 77/81: Fix: (plz--coding-system) Alist key, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 1d3efc036c 78/81: Add: (plz) DELETE method, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 9e308f1833 80/81: Meta: Tidy headers, etc. for ELPA, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 9156de9c59 81/81: Release: 0.1, ELPA Syncer, 2022/05/11
- [elpa] externals/plz bca0b3112b 20/81: Tidy, ELPA Syncer, 2022/05/11
- [elpa] externals/plz 2b51ecd6be 27/81: Meta: Add test.yml for GitHub Actions, ELPA Syncer, 2022/05/11