Rework a little bit the steps and samples help entries.
author"Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
Sun Jun 01 21:12:00 2008 +0000 (2008-06-01)
changeset 5446b15ef33e8f2
parent 543 1df70ed4510d
child 545 a7782f2c0926
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(-)
ct-ng.in
docs/overview.txt
samples/samples.mk
steps.mk
     1.1 --- a/ct-ng.in	Sun Jun 01 20:36:36 2008 +0000
     1.2 +++ b/ct-ng.in	Sun Jun 01 21:12:00 2008 +0000
     1.3 @@ -27,6 +27,7 @@
     1.4  export CT_STOP:=$(STOP)
     1.5  export CT_RESTART:=$(RESTART)
     1.6  
     1.7 +.FORCE:
     1.8  .PHONY: $(PHONY)
     1.9  PHONY += all
    1.10  all: help
    1.11 @@ -36,8 +37,8 @@
    1.12  # Help system
    1.13  help:: help-head help-config help-samples help-build help-clean help-distrib help-env help-tail
    1.14  
    1.15 -help-head::
    1.16 -	@echo  'Available actions:'
    1.17 +help-head:: version
    1.18 +	@echo  'See below for a list of available actions, listed by category:'
    1.19  
    1.20  help-config::
    1.21  	@echo
     2.1 --- a/docs/overview.txt	Sun Jun 01 20:36:36 2008 +0000
     2.2 +++ b/docs/overview.txt	Sun Jun 01 21:12:00 2008 +0000
     2.3 @@ -280,7 +280,7 @@
     2.4    ct-ng STOP=libc_headers    and:    ct-ng RESTART=libc_headers
     2.5  
     2.6  To obtain the list of acceptable steps, please call:
     2.7 -  ct-ng liststeps
     2.8 +  ct-ng list-steps
     2.9  
    2.10  Note that in order to restart a build, you'll have to say 'Y' to the config
    2.11  option CT_DEBUG_CT_SAVE_STEPS, and that the previous build effectively went
     3.1 --- a/samples/samples.mk	Sun Jun 01 20:36:36 2008 +0000
     3.2 +++ b/samples/samples.mk	Sun Jun 01 21:12:00 2008 +0000
     3.3 @@ -10,8 +10,9 @@
     3.4  	@echo  '  saveconfig         - Save current config as a preconfigured target'
     3.5  
     3.6  help-samples::
     3.7 -	@echo  '  samples            - prints the list of all samples (for scripting)'
     3.8 -	@echo  '  show-<sample>      - show a brief overview of <sample>'
     3.9 +	@echo  '  list-samples       - prints the list of all samples (for scripting)'
    3.10 +	@echo  '  show-<sample>      - show a brief overview of <sample> (list below)'
    3.11 +	@echo  '  <sample>           - preconfigure crosstool-NG with <sample> (list below)'
    3.12  	@$(CT_LIB_DIR)/scripts/showSamples.sh $(CT_SAMPLES)
    3.13  
    3.14  help-build::
    3.15 @@ -22,7 +23,8 @@
    3.16  $(patsubst %,show-%,$(CT_SAMPLES)):
    3.17  	@$(CT_LIB_DIR)/scripts/showSamples.sh -v $(patsubst show-%,%,$(@))
    3.18  
    3.19 -samples:
    3.20 +PHONY += list-samples
    3.21 +list-samples: .FORCE
    3.22  	@echo $(CT_SAMPLES) |sed -r -e 's/ /\n/g;' |sort
    3.23  
    3.24  # How we do build one sample
     4.1 --- a/steps.mk	Sun Jun 01 20:36:36 2008 +0000
     4.2 +++ b/steps.mk	Sun Jun 01 21:12:00 2008 +0000
     4.3 @@ -30,10 +30,13 @@
     4.4  	@$(CT_NG) RESTART=$(patsubst %+,%,$@) build
     4.5  
     4.6  help-build::
     4.7 -	@echo  '  liststeps          - List all build steps'
     4.8 +	@echo  '  list-steps         - List all build steps'
     4.9  
    4.10 -liststeps:
    4.11 +list-steps:
    4.12  	@echo  'Available build steps, in order:'
    4.13  	@for step in $(CT_STEPS); do    \
    4.14  	     echo "  - $${step}";       \
    4.15  	 done
    4.16 +	@echo  'Use "$(CT_NG) <step>" to execute only that step.'
    4.17 +	@echo  'Use "$(CT_NG) +<step>" to execute up to that step.'
    4.18 +	@echo  'Use "$(CT_NG) <step>+" to execute from that step onward.'