diff --git a/Makefile b/Makefile
index d01e74d..4763917 100644
--- a/Makefile
+++ b/Makefile
@@ -52,7 +52,8 @@ PGM=___PACKAGENAME___
 # will only produce 8-bit code.
 
 # Add any other directories where you are putting C or assembly source
-# files to this list:
+# files to this list.  Note that if you are generating source files into
+# $(GENDIR), you should add $(GENDIR) to SRCDIRS here:
 SRCDIRS+=
 
 # If you have a non-standard cc65 install, you may need to change
diff --git a/pkg/Templates/Apple II/Apple II Basic Project.xctemplate/Makefile b/pkg/Templates/Apple II/Apple II Basic Project.xctemplate/Makefile
index 879a895..219aaad 100644
--- a/pkg/Templates/Apple II/Apple II Basic Project.xctemplate/Makefile	
+++ b/pkg/Templates/Apple II/Apple II Basic Project.xctemplate/Makefile	
@@ -24,7 +24,8 @@ MACHINE = apple2-basic
 #    MACHINE = apple2-dos33-basic
 
 # Add any other directories where you are putting other BASIC files 
-# to this list:
+# to this list.  Note that if you are generating source files into
+# $(GENDIR), you should add $(GENDIR) to SRCDIRS here:
 SRCDIRS+=
 
 # If you want to add arguments to the BASIC tokenizer commandline,
@@ -70,6 +71,13 @@ COPYDIRS=
 # commands are called here, if any.  You can generate .c, .s or .h
 # files for example.  You can generate data files.  Whatever you
 # might need.
+#
+# You should generate these files in the $(GENDIR) directory or
+# within a subdirectory under $(GENDIR) which you create yourself.
+#
+# All of your commands associated with a rule _must_ start with a tab
+# character.  Xcode makes it a bit tough to type a tab character by
+# default.  Press option-tab within Xcode to insert a tab character.
 gen:
 
 # For any files you generated in the gen target above, you should
diff --git a/pkg/Templates/Apple II/Apple II Merlin Project.xctemplate/Makefile b/pkg/Templates/Apple II/Apple II Merlin Project.xctemplate/Makefile
index de7af12..951481d 100644
--- a/pkg/Templates/Apple II/Apple II Merlin Project.xctemplate/Makefile	
+++ b/pkg/Templates/Apple II/Apple II Merlin Project.xctemplate/Makefile	
@@ -41,7 +41,8 @@ MACHINE = apple2-merlin
 # files to this list.  Note that you must manually add all source files
 # to the linkscript.s file.  All this does is help the build system
 # see what files it should consider important to deciding whether to do
-# a re-build.
+# a re-build.  Note that if you are generating source files into
+# $(GENDIR), you should add $(GENDIR) to SRCDIRS here:
 SRCDIRS+=
 
 # If you want to add arguments to the BASIC tokenizer commandline,
@@ -87,6 +88,13 @@ COPYDIRS=
 # commands are called here, if any.  You can generate .c, .s or .h
 # files for example.  You can generate data files.  Whatever you
 # might need.
+#
+# You should generate these files in the $(GENDIR) directory or
+# within a subdirectory under $(GENDIR) which you create yourself.
+#
+# All of your commands associated with a rule _must_ start with a tab
+# character.  Xcode makes it a bit tough to type a tab character by
+# default.  Press option-tab within Xcode to insert a tab character.
 gen:
 
 # For any files you generated in the gen target above, you should