                         libcasefix Programmer's Reference Guide

		FUNCTION: nominate
		
		DEPENDS ON: the c standard lib

		SOURCE FILE: libcasefix.c

		LIBRARY FILES: libcasefix.so (shared library), libcasefix.a (static archive), or libcasefix.o (object file)
 
		HEADER FILE: libcasefix.h

		PROTOTYPE:

			int nominate(FILE * inputstream, FILE * outputstream)
			
		APROPOS USES: names of people and other proper nouns, words that begin sentences, first and significant words in titles, and the pronoun "I"

		DESCRIPTION:
	
			 nominate causes alphabetic characters received on the incoming stream, which is pointed to by FILE * inputstream, to be recased in the following way: the first character of every alphanumeric character group (word) is put into the upper case and all alphabetic characters following in the alphanumeric character group or word are placed in the lower case and outputs every character in the order received to a stream pointed at by FILE * outputstream. All non-alphanumeric characters act as word seperaters. The case of all alphabetic characters being changed to the proper form for names and other proper nouns.

		RETURN VALUES: 0 = no errors encountered; all other values are error codes.
		
		OTHER NOTES: The definition of nominate is "to name".
