                         libcasefix Programmer's Reference Guide

		FUNCTION: prepsentences
		
		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 prepsentences(FILE * inputstream, FILE * outputstream,char * delimiterstring)
			
		APROPOS USES: Sentences in which there are no proper nouns or the pronoun "I" except as the first word of a sentence, and in preparation of other sentences.
		
		DESCRIPTION:
			
			Upon reaching the 1st alphanumeric character after a "sentence delimiter" or the start of the stream pointed to by FILE * inputstream, prepsentences capitalizes the first character of the alphanumeric block (or word) if it is an alphabetic character; there after, it lower cases all alphabetic characters until it reaches a "sentence delimiter", where the process is repeated and outputs every character in the order received to a stream pointed at by FILE * outputstream; only the case of alphabetic characters having been changed. Sentence delimiting characters can be specified by placing them in a string pointed to by char * delimiterstring. If delimiterstring points to an empty string, prepsentences uses its default sentence delimiters. The default sentence delimiters are: . - periods, ? - question marks, and ! - exclamation points.
;	
	

		RETURN VALUES: 0 = no errors encountered; all other values are error codes.
		
		OTHER NOTES:

			This function is called prepsentences because it doesn't "casefix" them; it runs over proper nouns, only capitalizing the 1st alphanumeric character of each sentence and lower casing all others. It may still be useful to the end user because it might be easier to "prepsrntences" and then run the casefix tool again in nominate mode, casefixing the proper nouns, rather than retyping the sentences another way.
			