Clarify .multi option

#593

Author: hadley

R/req-body.R

@@ -137,7 +137,8 @@ req_body_json_modify <- function(req, ...) {
 #'   data in the body.
 #'
 #'   * For `req_body_form()`, the values must be strings (or things easily
-#'     coerced to strings);
+#'     coerced to strings). Vectors are convertd to strings using the
+#'     value of `.multi`.
 #'   * For `req_body_multipart()` the values must be strings or objects
 #'     produced by [curl::form_file()]/[curl::form_data()].
 #'   * For `req_body_json_modify()`, any simple data made from atomic vectors

R/req-url.R

@@ -55,10 +55,11 @@ req_url <- function(req, url) {
 #'   * `"error"`, the default, throws an error.
 #'   * `"comma"`, separates values with a `,`, e.g. `?x=1,2`.
 #'   * `"pipe"`, separates values with a `|`, e.g. `?x=1|2`.
-#'   * `"explode"`, turns each element into its own parameter, e.g. `?x=1&x=2`.
+#'   * `"explode"`, turns each element into its own parameter, e.g. `?x=1&x=2`
 #'
-#'   If none of these functions work, you can alternatively supply a function
-#'   that takes a character vector and returns a string.
+#'   If none of these options work for your needs, you can instead supply a
+#'   function that takes a character vector of argument values and returns a
+#'   a single string.
 req_url_query <- function(.req,
                           ...,
                           .multi = c("error", "comma", "pipe", "explode")) {