; * lisp/simple.el (async-shell-command): Add commentary about 3rd arg.

diff --git a/lisp/simple.el b/lisp/simple.el
index 0138556787b35bee158ca9c53853d4457e72bcd1..3f88fcb8d03d0595a20bece120f091eee8cff843 100644 (file)
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -4454,6 +4454,10 @@ whose `car' is BUFFER."
                           '(nil (inhibit-switch-frame . t)))))
                 (set-window-point win pos)))))))))
 
+;; Implementation note: the next function intentionally tries to use
+;; the same signature as 'shell-command', although the 3rd arg is
+;; currently ignored, to allow us to implement support for specifying
+;; ERROR-BUFFER in the future.
 (defun async-shell-command (command &optional output-buffer error-buffer)
   "Execute string COMMAND asynchronously in background.