# HG changeset patch
# User Glenn Morris <rgm@gnu.org>
# Date 1215285260 0
# Node ID b6c89c6c537ad0c76d757b56b0ee9cfea51ab5d0
# Parent  d620ef3acfdc01577807f53dec73353adafe697e
Comments.

diff -r d620ef3acfdc -r b6c89c6c537a lisp/Makefile.in
--- a/lisp/Makefile.in	Sat Jul 05 18:42:07 2008 +0000
+++ b/lisp/Makefile.in	Sat Jul 05 19:14:20 2008 +0000
@@ -1333,9 +1333,17 @@
 
 # Recompile all Lisp files which are newer than their .elc files and compile
 # new ones.
-# FIXME this could use the 'compile' target now, and let make figure out
-# what needs to be done.  That would be parallelizable, but would not
-# pick up new files not in ELCFILES.
+# This has the same effect as compile-main (followed up with compile-last,
+# if ELCFILES is out of date).  recompile has some advantages:
+# i) It is faster (on a single processor), since it only has to start
+# Emacs once.  It was 33% faster on a test with a random 10% of the .el
+# files needing recompilation.
+# ii) The explicit cc-mode dependency.
+# recompile's disadvantages are:
+# i) Not parallelizable.
+# ii) Compiling multiple files in the same instance of Emacs is wrong,
+# since the environment of later files is affected by definitions in
+# earlier ones.
 recompile: doit $(LOADDEFS) $(lisp)/progmodes/cc-mode.elc
 	$(emacs) --eval "(batch-byte-recompile-directory 0)" $(lisp)