Add notes

kgryte · kgryte · commit db933509b6a8 · 2018-04-27T12:23:45.000-07:00
diff --git a/tools/make/lib/lint/javascript/Makefile b/tools/make/lib/lint/javascript/Makefile
@@ -27,6 +27,11 @@ include $(TOOLS_MAKE_LIB_DIR)/lint/javascript/eslint.mk
 #/
 # Lints JavaScript files.
 #
+# ## Notes
+#
+# -   This rule supports the environment variables supported by each context-specific (`lint-javascript-<context>`) prerequisite.
+# -   This rule is useful when wanting to glob for files, irrespective of context, for a particular package in order to lint all contained JavaScript files.
+#
 # @param {string} [SOURCES_FILTER] - file path pattern (e.g., `.*/blas/base/dasum/.*`)
 # @param {string} [TESTS_FILTER] - file path pattern (e.g., `.*/blas/base/dasum/.*`)
 # @param {string} [EXAMPLES_FILTER] - file path pattern (e.g., `.*/blas/base/dasum/.*`)
diff --git a/tools/make/lib/lint/julia/Makefile b/tools/make/lib/lint/julia/Makefile
@@ -30,6 +30,11 @@ JULIA_LINTER_FLAGS ?=
 #/
 # Lints Julia files.
 #
+# ## Notes
+#
+# -   This rule supports the environment variables supported by each context-specific (`lint-julia-<context>`) prerequisite.
+# -   This rule is useful when wanting to glob for files, irrespective of context, for a particular package in order to lint all contained Julia files.
+#
 # @param {string} [JULIA_SOURCES_FILTER] - file path pattern (e.g., `.*/blas/base/dasum/.*`)
 # @param {string} [JULIA_TESTS_FIXTURES_FILTER] - file path pattern (e.g., `.*/blas/base/dasum/.*`)
 # @param {string} [JULIA_EXAMPLES_FILTER] - file path pattern (e.g., `.*/blas/base/dasum/.*`)
