Add implementation notes

kgryte · kgryte · commit d998926c97de · 2016-10-27T20:58:44.000-07:00
diff --git a/tools/make/lib/help/Makefile b/tools/make/lib/help/Makefile
@@ -28,6 +28,8 @@ help:
 # List Makefile targets.
 #
 # This target lists all Makefile targets.
+#
+# Note: the list of targets is NOT exhaustive, as it does not include targets which have been explicitly declared PHONY targets and does not include targets declared via variables. These targets could be included by dumping the Makefile database `make -qp`, but not seen as necessary due to predominant use of PHONY.
 
 list-targets:
 	$(QUIET) find $(TOOLS_MAKE_DIR) $(FIND_MAKEFILES_FLAGS) \
@@ -41,6 +43,8 @@ list-targets:
 # List Makefile stats targets.
 #
 # This target lists all Makefile targets for computing statistics.
+#
+# Note: the list of targets is NOT exhaustive, as it does not include targets which have been explicitly declared PHONY targets and does not include targets declared via variables. These targets could be included by dumping the Makefile database `make -qp`, but not seen as necessary due to predominant use of PHONY.
 
 list-stats-targets:
 	$(QUIET) find $(TOOLS_MAKE_DIR) $(FIND_MAKEFILES_FLAGS) \
