[Emacs-diffs] master 51cf2eb: Document batch-byte-compile directory behavior

[Lars Ingebrigtsen]

branch: master
commit 51cf2eb5c981b7e05a3329564753bcb61e4d5b07
Author: Lars Ingebrigtsen <address@hidden>
Commit: Lars Ingebrigtsen <address@hidden>

    Document batch-byte-compile directory behavior
    
    * lisp/emacs-lisp/bytecomp.el (batch-byte-compile): Document the
    behaviour with directories (bug#20867).
---
 lisp/emacs-lisp/bytecomp.el | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/lisp/emacs-lisp/bytecomp.el b/lisp/emacs-lisp/bytecomp.el
index 6dcd4c6..40b4e2f 100644
--- a/lisp/emacs-lisp/bytecomp.el
+++ b/lisp/emacs-lisp/bytecomp.el
@@ -5091,8 +5091,15 @@ it won't work in an interactive Emacs."
   "Run `byte-compile-file' on the files remaining on the command line.
 Use this from the command line, with `-batch';
 it won't work in an interactive Emacs.
-Each file is processed even if an error occurred previously.
+
+Each file is processed even if an error occurred previously.  If
+a file name denotes a directory, all Emacs Lisp source files in
+that directory (that have previously been compiled) will be
+recompiled if newer than the compiled files.  In this case,
+NOFORCE is ignored.
+
 For example, invoke \"emacs -batch -f batch-byte-compile $emacs/ ~/*.el\".
+
 If NOFORCE is non-nil, don't recompile a file that seems to be
 already up-to-date."
   ;; command-line-args-left is what is left of the command line, from