Add counsel to test changes to Makefile templatest with 'make -jN' fo…

…r N>1.
parrot · Mar 25, 2012 · 9dbe4f5 · 9dbe4f5
1 parent 003b2b8
commit 9dbe4f5
Show file tree

Hide file tree

Showing 2 changed files with 20 additions and 0 deletions.
diff --git a/config/gen/makefiles/root.in b/config/gen/makefiles/root.in
@@ -7,6 +7,9 @@
 # This makefile makes use of specific .dummy targets (rather than .PHONY
 # or .VIRTUAL targets) in an effort to work with various flavors of make.
 #
+# When revising this makefile template, please make sure to have changes
+# tested with both 'make' and 'make -jN' (where N > 1) on multi-core machines.
+#
 ###############################################################################
 
 ###############################################################################

diff --git a/docs/project/hacking_tips.pod b/docs/project/hacking_tips.pod
@@ -98,6 +98,23 @@ tools/dev/reconfigure.pl exists for that purpose:
 
   perl tools/dev/reconfigure.pl --step=gen::makefile
 
+When hacking on Makefile template files such as
+F<config/gen/makefiles/root.in>, please:
+
+=over 4
+
+=item *
+
+Pay attention to situations where F<make> rules require hard-tabs rather than
+wordspaces.
+
+=item *
+
+Make sure you test your code revisions with both F<make> and, on multi-core
+machines, F<make -jN> (where C<N E<gt> 1>).
+
+=back
+
 =cut
 
 __END__