# HG changeset patch
# User Steve Losh <steve@stevelosh.com>
# Date 1575592958 18000
# Node ID 18da0214d5a9c7e27a8116ee9ea6368c3a973f99
# Parent  1745fd2d70d6f8a4c9b24300f7c7f3f7bf22f0e4
Update documentation

diff -r 1745fd2d70d6 -r 18da0214d5a9 DOCUMENTATION.markdown
--- a/DOCUMENTATION.markdown	Thu Dec 05 19:42:14 2019 -0500
+++ b/DOCUMENTATION.markdown	Thu Dec 05 19:42:38 2019 -0500
@@ -1888,7 +1888,7 @@
 
 ### `EXTREMA` (function)
 
-    (EXTREMA PREDICATE SEQUENCE)
+    (EXTREMA PREDICATE SEQUENCE &KEY (KEY #'IDENTITY))
 
 Return the smallest and largest elements of `sequence` according to `predicate`.
 
@@ -2123,7 +2123,7 @@
 
 ### `SH` (function)
 
-    (SH COMMAND &KEY INPUT OUTPUT (WAIT T))
+    (SH COMMAND &KEY INPUT (WAIT T) (RESULT-TYPE 'NULL))
 
 Run `command`, piping `input` to it, optionally returning its output.
 
@@ -2137,8 +2137,15 @@
   `input` must be a character input stream, a string, or `nil`.  If non-`nil`
   its contents will be sent to the program as its standard input.
 
-  `output` must be one of `:string`, `:stream`, or `nil`.  `:string` cannot be
-  used if `:wait` is `nil`.
+  `result-type` must be one of:
+
+  * `null`: output will be sent to `/dev/null` and `nil` returned.
+  * `stream`: output will be returned as a character stream.
+  * `string`: all output will be gathered up and returned as a single string.
+  * `list`: all output will be gathered up and returned as a list of lines.
+
+  If `wait` is `nil`, the only acceptable values for `result-type` are `null`
+  and `stream`.