Clarify comments in Makefiles

git-svn-id: http://svn.inspircd.org/repository/trunk/inspircd@11990 e03df62e-2008-0410-955e-edbf42e46eb7

2 files changed, 14 insertions, 4 deletions

diff --git a/make/calcdep.pl b/make/calcdep.pl
index 2a0ea5d92..81a7759d3 100755
--- a/make/calcdep.pl
+++ b/make/calcdep.pl
@@ -29,10 +29,16 @@ sub run() {
 	chdir "$ENV{SOURCEPATH}/src";
 
 	print MAKE <<END;
-# DO NOT EDIT
-# Autogenerated by calcdep
+# DO NOT EDIT THIS FILE
+# It is autogenerated by make/calcdep.pl, and will be overwritten
+# every time you rerun make in the main directory
 VPATH = \$(SOURCEPATH)/src
 
+bad-target:
+	\@echo "This Makefile must be run by a sub-make from the source"
+	\@echo "in order to set the correct environment variables"
+	\@exit 1
+
 all: inspircd commands modules
 
 END
diff --git a/make/template/main.mk b/make/template/main.mk
index fa59f6519..666104d1b 100644
--- a/make/template/main.mk
+++ b/make/template/main.mk
@@ -2,8 +2,12 @@
 #
 #       (C) InspIRCd Development Team, 2002-2009
 # This file is automagically generated by configure, from
-#     .Makefile.inc. Any changes make will go away!
-#   Please do not edit unless you know what you're doing.
+# make/templates/main.mk. Any changes make to the generated
+#     files will go away whenever it is regenerated!
+#
+# Please do not edit unless you know what you're doing. This
+# needs to work in both GNU and BSD make; it is mangled for
+# them by configure.
 #
 
 CC = @CC@