summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authordefanor <defanor@uberspace.net>2019-02-13 07:29:31 +0300
committerdefanor <defanor@uberspace.net>2019-02-13 07:29:31 +0300
commit1f812ab812fe835d30ccddbbfb10917335fc4882 (patch)
tree03005edee75e8fd1e3fd4e5d1a3774d28b2dc633
parent1f3580e9e7c6216aa116e105d00548780f6a78cd (diff)
Update the "Querying" README.md section
-rw-r--r--README.md13
1 files changed, 9 insertions, 4 deletions
diff --git a/README.md b/README.md
index 6138ee5..d0ee97e 100644
--- a/README.md
+++ b/README.md
@@ -49,10 +49,12 @@ parameter, with added `xsl` extension.
SQL queries provided in the `q` URL query parameter get executed, with
some substitutions to handle HTML forms:
-- `f:<name>` for POST parameters
-- `q:<name>` for GET parameters
-- `:fields` for POST parameter names
-- `:values` for POST parameter values (in the same order as the names)
+- `f:<name>` for "POST" (serialised form data in message body)
+ parameters
+- `q:<name>` for "GET" (serialised form data in URI query) parameters
+- `:fields` for "POST" parameter names
+- `:values` for "POST" parameter values (in the same order as the
+ names)
`:fields` and `:values` are unnecessary, but are provided for
convenience of insert/upsert operations.
@@ -60,6 +62,9 @@ convenience of insert/upsert operations.
SQL queries get tokenized by splitting into words and reassembled
afterwards, hence some whitespace separation is needed.
+HTTP methods (and corresponding conventions) are currently ignored,
+since they are of little use with HTML 5 forms.
+
### Authentication
Presence of `auth=on` in the URL query requires HTTP basic