                         libcasefix Programmer's Reference Guide

		FUNCTION: casenreplacestring
		
		DEPENDS ON: the c standard library

		SOURCE FILE: libcasefix.c

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

		PROTOTYPE:

			char * casenreplacestring(int mode,char * string, char * argstring)

		DESCRIPTION:
			
			casenreplacestring modifies the casing of alphanumeric character blocks (words) in a null terminated string according to the mode. int mode corresponds to one of the casefix streaming functions; Here is a list of the modes:
	
			1 - lowerall - lower cases all alphabetic characters 
			2 - nominate - capitalizes the first character and lower cases those following in each word
			3 - capall - capitalizes all alphabetic characters
			4 - reversecaseall - changes the case of all alphabetic characters
			5 - wackify - changes the case of alphabetic characters in a pseudo-random way
			6 - custom - case according to programmer or user supplied template
			7 - prepsentences - capitalizes the 1st alphanumeric character of each sentence, as indicated by the sentence delimiters list string and lower casing all others.

			char * argstring is ignored but is required in modes 1 through 5. Typically, a "" will work for this argument in modes 1 through 5.
	
			In mode 6, char * argstring is a pointer to a char string, which is a string that contains the casing template string. For each word, this function, for each character in the word, checks the character at the same position in the template string. The function uses the following code to indicate how each character should be cased:

			 	U or u - character should be upper case
			 	L or l - character should be lower case
		   		     = - leave character unchanged
 
			So a template string, say "Uu=lL" would, for every word, capitalize the 1st and 2nd charters and lower cases the 4th and 5th character, and leave the 3rd character unchanged. All characters in a word thats position is past the end of the template string, are left unchanged.
			
			In mode 7, char * argstring is a pointer to a char string, which is a string that contains "sentence delimiters". If delimiterstring points to an empty string, the function uses its default sentence delimiters. The default sentence delimiters are: . - periods, ? - question marks, ! - exclamation points and " - quotation marks.
			
			NOTICE: mode 7 runs over proper nouns, only capitalizing the 1st alphanumeric character of each sentence if it is alphabetic and lower casing all others. It may still be usefull to the end user because it might be easier to use mode 7 and running the casefix tool again in mode 2, casefixing the proper nouns, rather than retyping the sentence another way.

		RETURN VALUES: char * = char * output - no errors encountered; char * = null char * - error encountered.
		
		OTHER NOTES:
			For more information on the modes, see the page in this manual for their respective streaming functions.
