2004-02-24  Alan Miles  <alan.miles@ieee.org>

	* templates/generic-readme : Changed the runtime requirements string
	from "<other requirements, e.g., libintl1>" to:
	"<other Runtime requirements, e.g., libintl1>" allowing better text
	replacement using the values generated by depend() function. The generic
	build script will replace this string in its function "readmelist()".

	* templates/generic-readme : Changed the build requirements string
	from "<other requirements, e.g., gettext>" to:
	"<other Build requirements, e.g., gettext>" allowing better text
	replacement using values from the generic build script, which
	will replace this string in its function "readmelist()".

	* templates/generic-readme : Replaced the listed files under the
	"Files included" section with the string "<THEFILES>". The generic
	build script will replace the string "<THEFILES>" with a sorted list of
	files which will comprise the binary distribution. The generic build
	scripts "readmelist()" function does this.

	* templates/generic-readme : Changed the port notes string
	from "Other information" to:
	"<Other Port information>" allowing better text
	replacement using values from the generic build script, which
	will replace this string in its function "readmelist()".

	* templates/generic-readme : Changed the older release string
	from "<PKG>-<older VER>-1" to:
	"<PKG>-<older VER>-<older REL>" since the release number
	may not be 1. The generic build script will analyse the setup.hint file
	and set the values of "<older VER>" and "<older REL>", substituting these
	values. If the script cannot find the setup.hint file, these values
	become values of "<VER>" and "<REL>" respectively.Again the generic build
	script's "readmelist()" and "hintfiledata()" functions do the substitutions
	and extract the data from the setup.hint file.

	* templates/generic-build-script : Added defaults and instructions to Package
	maintainers regarding some new constants:
	export SHORTDESC="<short description, 2 or 3 lines>"
	export OTHERRUNTIME="  <other Runtime requirements, e.g., libintl1>"
	export OTHERBUILD="  <other Build requirements, e.g., gettext>"
	export OTHERPORT="<Other Port information>"
	export OLDERVER="${VER}" # Set the default to the "current" package's version number
	export OLDERREL="${REL}" # Set the default to the "current" package's release number
	export MAINTNAME="<Your Name Here>"
	export MAINTEMAIL="<your email here>"
	The "readmelist()" function substitutes these values into the binary package README.
	Note: Function "hintfiledata()" overrides the values of SHORTDESC, setting it to the
	setup.hint file's ldesc value, and obtains the OLDERVER, OLDERREL values from the
	setup.hint if it contains the "prev: " value

	* templates/generic-build-script : Added function "hintfiledata()" which parses
	and extracts the ldesc: value and prev: values, if the
	"${srcdir}/CYGWIN-PATCHES/setup.hint" file exists, altering the SHORTDESC, OLDERVER,
	OLDERREL values respectively.

	* templates/generic-build-script : Added function "readmelist()" which examines
	all the files in "${instdir}", sorting them and then replacing the "<THEFILES>" string
	with the lines. This replacement exploits sed's "e command", which allows one to pipe
	input from a shell command into pattern space. The command does the following replacements:
	(a) string "<PKG>" becomes the value of "${PKG}" 	
	(b) string "<VER>" becomes the value of "${VER}" 	
	(c) string "<REL>" becomes the value of "${REL}" 	
	(d) string "<package name>" becomes the value of "${PKG}" 	
	(e) string "<short description, 2 or 3 lines>" becomes the value of "${SHORTDESC}" 	
	(f) string "  <other Build requirements, e.g., gettext>" becomes the value of "${OTHERBUILD}" 	
	(g) string "<Other Port information>" becomes the value of "${OTHERPORT}" 	
	(h) string "<older VER>" becomes the value of "${OLDERVER}" 	
	(i) string "<older REL>" becomes the value of "${OLDERREL}" 	
	(j) string "<Your Name Here>" becomes the value of "${MAINTNAME}" 	
	(k) string "<your email here>" becomes the value of "${MAINTMAIL}" 	
	(l) string "  <other Runtime requirements, e.g., libintl1>" becomes the value of sorted
            "depends()" function.

	* templates/generic-build-script : Added the call to function "readmelist()" in the "all" list

	* templates/generic-build-script : Fixed a problem in the functions "strip()", "mkpatch()",
	and "depend()" when there are no dll's or exes (the find returns no files) - xargs would try to
	execute strip or cygcheck/cygpath with no arguments and these commands would complain about
	missing arguments. The fix is to add the -r parameter to xargs, which prevents xargs
	from executing its parameters if there is no input.

	* templates/generic-build-script : Altered references in install() from:
	"${instdir}${prefix}/share/doc/Cygwin/${BASEPKG}.README" to:
	"${PkgReadMe}" thus allowing only one definition of the README -  "readmelist()" uses
	"${PkgReadMe}"