# HG changeset patch
# User "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
# Date 1212354720 0
# Node ID 6b15ef33e8f2dd14e83273cf63414f47e466a27b
# Parent  1df70ed4510d3685aabedec79119728a150b0e6f
Rework a little bit the steps and samples help entries.

 /trunk/docs/overview.txt  |    2     1     1     0 +-
 /trunk/steps.mk           |    7     5     2     0 +++++--
 /trunk/samples/samples.mk |    8     5     3     0 +++++---
 /trunk/ct-ng.in           |    5     3     2     0 +++--
 4 files changed, 14 insertions(+), 8 deletions(-)

diff -r 1df70ed4510d -r 6b15ef33e8f2 ct-ng.in
--- a/ct-ng.in	Sun Jun 01 20:36:36 2008 +0000
+++ b/ct-ng.in	Sun Jun 01 21:12:00 2008 +0000
@@ -27,6 +27,7 @@
 export CT_STOP:=$(STOP)
 export CT_RESTART:=$(RESTART)
 
+.FORCE:
 .PHONY: $(PHONY)
 PHONY += all
 all: help
@@ -36,8 +37,8 @@
 # Help system
 help:: help-head help-config help-samples help-build help-clean help-distrib help-env help-tail
 
-help-head::
-	@echo  'Available actions:'
+help-head:: version
+	@echo  'See below for a list of available actions, listed by category:'
 
 help-config::
 	@echo
diff -r 1df70ed4510d -r 6b15ef33e8f2 docs/overview.txt
--- a/docs/overview.txt	Sun Jun 01 20:36:36 2008 +0000
+++ b/docs/overview.txt	Sun Jun 01 21:12:00 2008 +0000
@@ -280,7 +280,7 @@
   ct-ng STOP=libc_headers    and:    ct-ng RESTART=libc_headers
 
 To obtain the list of acceptable steps, please call:
-  ct-ng liststeps
+  ct-ng list-steps
 
 Note that in order to restart a build, you'll have to say 'Y' to the config
 option CT_DEBUG_CT_SAVE_STEPS, and that the previous build effectively went
diff -r 1df70ed4510d -r 6b15ef33e8f2 samples/samples.mk
--- a/samples/samples.mk	Sun Jun 01 20:36:36 2008 +0000
+++ b/samples/samples.mk	Sun Jun 01 21:12:00 2008 +0000
@@ -10,8 +10,9 @@
 	@echo  '  saveconfig         - Save current config as a preconfigured target'
 
 help-samples::
-	@echo  '  samples            - prints the list of all samples (for scripting)'
-	@echo  '  show-<sample>      - show a brief overview of <sample>'
+	@echo  '  list-samples       - prints the list of all samples (for scripting)'
+	@echo  '  show-<sample>      - show a brief overview of <sample> (list below)'
+	@echo  '  <sample>           - preconfigure crosstool-NG with <sample> (list below)'
 	@$(CT_LIB_DIR)/scripts/showSamples.sh $(CT_SAMPLES)
 
 help-build::
@@ -22,7 +23,8 @@
 $(patsubst %,show-%,$(CT_SAMPLES)):
 	@$(CT_LIB_DIR)/scripts/showSamples.sh -v $(patsubst show-%,%,$(@))
 
-samples:
+PHONY += list-samples
+list-samples: .FORCE
 	@echo $(CT_SAMPLES) |sed -r -e 's/ /\n/g;' |sort
 
 # How we do build one sample
diff -r 1df70ed4510d -r 6b15ef33e8f2 steps.mk
--- a/steps.mk	Sun Jun 01 20:36:36 2008 +0000
+++ b/steps.mk	Sun Jun 01 21:12:00 2008 +0000
@@ -30,10 +30,13 @@
 	@$(CT_NG) RESTART=$(patsubst %+,%,$@) build
 
 help-build::
-	@echo  '  liststeps          - List all build steps'
+	@echo  '  list-steps         - List all build steps'
 
-liststeps:
+list-steps:
 	@echo  'Available build steps, in order:'
 	@for step in $(CT_STEPS); do    \
 	     echo "  - $${step}";       \
 	 done
+	@echo  'Use "$(CT_NG) <step>" to execute only that step.'
+	@echo  'Use "$(CT_NG) +<step>" to execute up to that step.'
+	@echo  'Use "$(CT_NG) <step>+" to execute from that step onward.'