From 6f45f68a0f255bf89b2dbea69064915e37e29dc4 Mon Sep 17 00:00:00 2001
From: Max Horn
Date: Wed, 18 Nov 2009 23:34:40 +0000
Subject: Some comments

svn-id: r45982
---
 Makefile.common | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

(limited to 'Makefile.common')

diff --git a/Makefile.common b/Makefile.common
index 57bdd4e62e..5b8cca0804 100644
--- a/Makefile.common
+++ b/Makefile.common
@@ -116,16 +116,18 @@ else
 
 endif
 
-
+# Build rule for assembler files
 %.o: %.s
 	$(QUIET)$(MKDIR) $(*D)
 	$(QUIET_AS)$(AS) $(ASFLAGS) $(<) -o $*.o
 
+# Build rule for assembler files with preprocessing
 %.o: %.S
 	$(QUIET)$(MKDIR) $(*D)/$(DEPDIR)
 	$(QUIET_AS)$(CXX) $(CXX_UPDATE_DEP_FLAG) $(ASFLAGS) -c $(<) -o $*.o
 
 ifdef HAVE_NASM
+# Build rule for NASM assembler filesss
 %.o: %.asm
 	$(QUIET)$(MKDIR) $(*D)
 	$(QUIET_NASM)$(NASM) -O1 $(NASMFLAGS) -g -o $*.o $(<)
@@ -134,6 +136,9 @@ endif
 # Include the dependency tracking files.
 -include $(wildcard $(addsuffix /*.d,$(DEPDIRS)))
 
+# Mark *.d files and most *.mk files as PHONY. This stops make from trying to
+# recreate them (which it can't), and in particular from looking for potential
+# source files. This can save quite a bit of disk access time.
 .PHONY: $(wildcard $(addsuffix /*.d,$(DEPDIRS))) $(addprefix $(srcdir)/, $(addsuffix /module.mk,$(MODULES))) \
 	$(srcdir)/$(port_mk) $(srcdir)/rules.mk $(srcdir)/engines/engines.mk
 
-- 
cgit v1.2.3