From 08dcaf0bac2dc6739e045fc9ce64852c1019e6e4 Mon Sep 17 00:00:00 2001
From: "Paul W. Frields" <stickster@gmail.com>
Date: Wed, 21 Nov 2007 20:52:35 +0000
Subject: Improved help menu.  The next step will move the fully parsed list of
 locale-specific targets to a new "help-verbose" target.

---
 Makefile.common | 23 ++++++++++++++++-------
 1 file changed, 16 insertions(+), 7 deletions(-)

(limited to 'Makefile.common')

diff --git a/Makefile.common b/Makefile.common
index ed80cd4..c23129e 100644
--- a/Makefile.common
+++ b/Makefile.common
@@ -224,9 +224,21 @@ TARGETS=all clean distclean fdp-info html html-nochunks pdf po showvars \
 all::	html html-nochunks tarball # pdf
 
 help::
-	@printf ${TFMT} 'help' 'This help; try "make help|sort"'
+	@echo -e 'The following targets are available for use with the make(1)'
+	@echo -e 'command. To make a target for a specific locale only, append'
+	@echo -e 'the suffix "-xy" to the target name, as in "make html-ja".\n'
+	@printf ${TFMT} 'fdp-info' 'Produces all $${LANG}/fdp-info.xml'
+	@printf ${TFMT} 'all'	'Builds html, html-nochunks, and tarball'
+	@printf ${TFMT} 'html'	'Renders XML into chunked HTML'
+	@printf ${TFMT} 'html-nochunks'	'Renders XML into one big HTML file'
+	@printf ${TFMT} 'pdf'	'Renders XML into one PDF file'
+	@printf ${TFMT} 'po'	'Updates .PO files for all $${OTHERS} locales'
 	@printf ${TFMT} 'text' 'Same as "txt" target'
 	@printf ${TFMT} 'txt' 'Renders XML into ASCII text file'
+
+	@echo -e 'The following targets are not locale specific.  Do not use a'
+	@echo -e 'locale suffix with these targets.\n'
+	@printf ${TFMT} 'help' 'This help; try "make help|sort"'
 	@printf ${TFMT} 'src-tarball' 'FIXME'
 	@printf ${TFMT} 'package-post' 'FIXME'
 	@printf ${TFMT} 'package-prep' 'FIXME'
@@ -237,14 +249,11 @@ help::
 	@printf ${TFMT} 'tarball' 'Packages HTML files into tar(1) archive'
 	@printf ${TFMT} 'clean'	'Removes temporary files'
 	@printf ${TFMT} 'distclean' 'Removes product files and temporaries'
-	@printf ${TFMT} 'fdp-info' 'Produces all $${LANG}/fdp-info.xml'
-	@printf ${TFMT} 'all'	'Builds html, html-nochunks, and tarball'
-	@printf ${TFMT} 'html'	'Renders XML into chunked HTML'
-	@printf ${TFMT} 'html-nochunks'	'Renders XML into one big HTML file'
-	@printf ${TFMT} 'pdf'	'Renders XML into one PDF file'
-	@printf ${TFMT} 'po'	'Updates .PO files for all $${OTHERS} locales'
 	@printf ${TFMT} 'showvars'	'Displays convenient make(1) variables'
 
+	@echo -e '\nTo see a fully parsed list of locale-specific targets,'
+	@echo -e 'use the "make help-verbose" command.'
+
 ${TARGETS}::
 
 #########################################################################
-- 
cgit