-# compile by looking in the current directory. This is complicated by
-# the fact that a .hsc file gives rise to a .hs file (which needs to
-# be automatically included in $(SRCS)), but the .hs file might
-# already be present in the current directory and we don't want to
-# compile it twice.
-
-# So we figure out the sources in three stages: first figure out
-# what's in the current directory (this is $(PRE_SRCS)). Then figure
-# out all the "derived" sources (eg. A.hsc generates A.hs and
-# A_hsc.c), and finally put all these together and remove duplicates
-# (GNU make's handy sort function does the duplicate removing).
-#
-# BOOT_SRCS: list of machine generated Haskell modules.
+# compile by looking in the current directory (and possibly other
+# directories which may be specified by setting the $(ALL_DIRS)
+# variable). This is complicated by the fact that some files are
+# derived from other files: eg. .hsc files give rise to -hsc.c and
+# -hsc.h files, .ly files give rise to .hs files, and .hs files give
+# rise to .hc files sometimes.
+
+# So we figure out the sources in three stages: first figure out what
+# sources we can find (this is $(ALL_SRCS)). Then figure out all the
+# "derived" sources (eg. A.hsc generates A.hs and A_hsc.c), and
+# finally put all these together and remove duplicates (GNU make's
+# handy sort function does the duplicate removing).
+