From 8582bf7a23c4afb7f1f3138aa11b5d5df25cd990 Mon Sep 17 00:00:00 2001
From: Rejean Loyer <rejean.loyer@gmail.com>
Date: Sat, 15 Aug 2020 01:47:11 -0400
Subject: [PATCH] tarball: add help targets.

---
 crossplatform.mk | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/crossplatform.mk b/crossplatform.mk
index 66fdadf440..5fd60f9684 100644
--- a/crossplatform.mk
+++ b/crossplatform.mk
@@ -448,6 +448,38 @@ ifdef WINDOWS_TARGET
  endif
 endif
 
+.PHONY: help
+.NOTPARALLEL: help
+help:
+	@$(call echo,Ecere SDK Make Help)
+	@$(call echo,"")
+	@$(call echo,"help consists of command examples. try them!")
+	@$(call echo,"")
+	@$(call echo,help command examples:)
+	@$(call echo,"")
+	@$(call echo,   $(MAKE_COMMAND) help                                          -- this target)
+	@$(call echo,   $(MAKE_COMMAND) help-troubleshoot                             -- show command examples for troubleshooting)
+	@$(call echo,"")
+	@$(call echo,linux only command examples:)
+	@$(call echo,"")
+	@$(call echo,   time sh -c '$(MAKE_COMMAND) wipeclean all c_bindings cxx_bindings_gen -j9 && echo && make RENAME_B32=1 ARCH=x32 all -j9')
+
+.PHONY: help-troubleshoot
+.NOTPARALLEL: help-troubleshoot
+help-troubleshoot:
+	@$(call echo,troubleshooting command examples:)
+	@$(call echo,"")
+	@$(call echo,   $(MAKE_COMMAND) troubleshoot-example                          -- print the definition for this prepackaged list of variables)
+	@$(call echo,   $(MAKE_COMMAND) print-all-vars-info                           -- print the definition for all variables)
+	@$(call echo,   $(MAKE_COMMAND) print-all-vars-stat                           -- print the definition, origin and flavor for all variables)
+	@$(call echo,   $(MAKE_COMMAND) print-var-info-PLATFORM                       -- print the definition for the PLATFORM variable)
+	@$(call echo,   $(MAKE_COMMAND) print-substr-vars-full-DIR                    -- print all information for all variables containing the DIR string)
+	@$(call echo,"")
+	@$(call echo,available modes for print-var-<mode>-<name> and print-substr-vars-<mode>-<substring> targets:)
+	@$(call echo,   info (definition only)$(comma) eval (value only)$(comma) both (definition and value)$(comma))
+	@$(call echo,   stat (definition$(comma) origin and flavor) and full (definition$(comma) value$(comma) origin and flavor))
+	@$(call echo,"")
+
 var_info = $(if $(value $1),$1 = $(value $1),$1 is defined as an empty value)
 var_eval = $(if $(value $1),$(if $($1),$1 = $($1),$1 evaluates to an empty value),$1 is defined as an empty value)
 var_both = $(if $(value $1),$1 = $(value $1) $(if $($1),$(if $(call str_is,$($1),$(value $1)),(value equal to definition),= $($1)),= (empty value)),$1 is defined as an empty value)