docs-common Makefile.common,1.177,1.178

[Paul W. Frields (pfrields)]

Author: pfrields

Update of /cvs/docs/docs-common
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv20837

Modified Files:
	Makefile.common 
Log Message:
Improved help menu.  The next step will move the fully parsed list of
locale-specific targets to a new "help-verbose" target.



Index: Makefile.common
===================================================================
RCS file: /cvs/docs/docs-common/Makefile.common,v
retrieving revision 1.177
retrieving revision 1.178
diff -u -r1.177 -r1.178
--- Makefile.common	15 Sep 2007 21:48:03 -0000	1.177
+++ Makefile.common	21 Nov 2007 20:52:35 -0000	1.178
@@ -224,9 +224,21 @@
 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 @@
 	@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}::
 
 #########################################################################