# HG changeset patch
# User "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
# Date 1182097463 0
# Node ID 59676cfb4ada2024785926fbbdc8a65c18e96828
# Parent  043e44606e28a85cace26a954284273dc2281546
Rework the help system. For now, this is mostly a no-op (it only re-organise the help entries), but later, that may come in handy when we want ct-ng to be installable).

diff -r 043e44606e28 -r 59676cfb4ada Makefile
--- a/Makefile	Sun Jun 17 15:46:13 2007 +0000
+++ b/Makefile	Sun Jun 17 16:24:23 2007 +0000
@@ -17,32 +17,54 @@
 
 HOST_CC = gcc -funsigned-char
 
-help::
+# Help system
+help:: help-head help-config help-samples help-build help-distrib help-env help-tail
+
+help-head::
 	@echo  'Available make targets:'
+
+help-config::
 	@echo
+	@echo  'Configuration targets:'
+
+help-samples::
+	@echo
+	@echo  'Preconfigured targets:'
+
+help-build::
+	@echo
+	@echo  'Build targets:'
+
+help-distrib::
+	@echo
+	@echo  'Distribution targets:'
+
+help-env::
+	@echo
+	@echo  'Environement variables (see docs/overview.txt):'
+
+help-tail::
+	@echo
+	@echo  'Execute "make" or "make all" to build all targets marked with [*]'
+
+# End help system
+
+help-build::
+	@echo  '* build          - Build the toolchain'
+	@echo  '  clean          - Remove generated files'
+	@echo  '  distclean      - Remove generated files, configuration and build directories'
 
 include $(CT_TOP_DIR)/kconfig/Makefile
 include $(CT_TOP_DIR)/samples/Makefile
-
-help::
-	@echo  'Build targets:'
-	@echo  '* build          - Build the toolchain'
-	@echo  '  regtest        - Regtest-build all samples'
-	@echo  '  clean          - Remove generated files'
-	@echo  '  distclean      - Remove generated files, configuration and build directories'
-
 include $(CT_TOP_DIR)/tools/Makefile
 include $(CT_TOP_DIR)/Makefile.steps
 
-help::
-	@echo  'Distribution targets:'
+help-distrib::
 	@echo  '  tarball        - Build a tarball of the configured toolchain'
-	@echo  ''
-	@echo  'Environement variables (see docs/overview.txt):'
+
+help-env::
 	@echo  '  STOP           - Stop the build just after this step'
 	@echo  '  RESTART        - Restart the build just before this step'
-	@echo  ''
-	@echo  'Execute "make" or "make all" to build all targets marked with [*]'
 
 .config:
 	@echo "You must run either one of \"make config\" or \"make menuconfig\" first"
diff -r 043e44606e28 -r 59676cfb4ada kconfig/Makefile
--- a/kconfig/Makefile	Sun Jun 17 15:46:13 2007 +0000
+++ b/kconfig/Makefile	Sun Jun 17 16:24:23 2007 +0000
@@ -58,14 +58,10 @@
 	@yes "" |$< -s $(KCONFIG_TOP) >/dev/null
 
 # Help text used by make help
-help::
-	@echo  'General purpose configuration targets:'
+help-config::
 	@echo  '  config         - Update current config using a line-oriented program'
 	@echo  '  menuconfig     - Update current config using a menu based program'
 	@echo  '  oldconfig      - Update current config using a provided .config as base'
-	@# saveconfig is listed here for homogeneity, but implemented in samples/Makefile
-	@echo  '  saveconfig     - Save current config as a preconfigured target'
-	@echo  ''
 
 # Cheesy build
 
diff -r 043e44606e28 -r 59676cfb4ada samples/Makefile
--- a/samples/Makefile	Sun Jun 17 15:46:13 2007 +0000
+++ b/samples/Makefile	Sun Jun 17 16:24:23 2007 +0000
@@ -3,10 +3,14 @@
 # Build the list of available samples
 CT_SAMPLES = $(patsubst $(CT_TOP_DIR)/samples/%/crosstool.config,%,$(wildcard $(CT_TOP_DIR)/samples/*/crosstool.config))
 
-help::
-	@echo  'Preconfigured targets:'
+help-config::
+	@echo  '  saveconfig     - Save current config as a preconfigured target'
+
+help-samples::
 	@$(CT_TOP_DIR)/scripts/showSamples.sh $(CT_SAMPLES)
-	@echo  ''
+
+help-build::
+	@echo  '  regtest        - Regtest-build all samples'
 
 # How we do build one sample
 .PHONY: $(CT_SAMPLES)
diff -r 043e44606e28 -r 59676cfb4ada tools/Makefile
--- a/tools/Makefile	Sun Jun 17 15:46:13 2007 +0000
+++ b/tools/Makefile	Sun Jun 17 16:24:23 2007 +0000
@@ -7,6 +7,5 @@
 	@wget "$(CONFIG_SUB_SRC)" -O "$(CONFIG_SUB_DEST)"
 	@wget "$(CONFIG_GUESS_SRC)" -O "$(CONFIG_GUESS_DEST)"
 
-help::
+help-distrib::
 	@echo  '  updatetools    - Update the config tools'
-	@echo  ''