*******************************************************************************
           * README * 
*******************************************************************************

Name of program: myList
Author: David Bozarth
Started:  14 April 2004
Modified: 1 May 2004

-------------------------------------------------------------------------------

	Files
(new)

divInt.s	- integer division

doFir.s		- Finite Impulse Response filter (low-pass)

(old)

myList.s 	- main function source file

writeStr.s 	- function that writes a C-style string on the standard output
 
readStr.s 	- function that reads one line from the standard input
 
uDecToInt.s 	- function that converts an unsigned decimal number to an int
 
sDecToInt.s 	- function that converts a signed decimal number to an int
 
uIntToDec.s 	- function that converts an int to a text string that represents the int as an unsigned decimal number

sIntToDec.s 	- function that converts an int to a text string that represents the int as a signed decimal number

getDec.s 	- function that gets a signed decimal integer from keyboard 

putDec.s 	- function that displays a signed decimal integer on the screen 

getList.s 	- function that gets a list of signed integers from the keyboard 

showList.s 	- function that displays a list of integers on the screen 

sumList.s 	- function that sums a list of integers 

avgList.s 	- function that finds the mean value of a list of integers 

makefile 	- to create the program

README 		- this file

-----------------------------------------------------------------------------------

	Activity

This program will prompt the user to enter integers one at a time, storing each integer in an array. Input ends when the user responds to the prompt by simply pushing the return key. It then echoes the list for the user (in a column) and displays the sum and average of the integers. 

	Input requirements

The user will enter signed decimal integers such that the sum never exceeds a 32-bit signed integer. If the 32-bit limit is exceeded by some sum during the process, the result is not guaranteed to be correct, and no error message will display. 

If the user enters a numeral too large to represent as an signed int (before or after multiplication by 10), then an error message will display, followed by display of additional results that are not guaranteed to be correct. 

If the user enters a text string containing a sign character ('+' or '-') in any position other than the first position, then the output is not guaranteed to be correct. If the user enters a text string containing a non-numeric, non-sign character in any position, then the output is not guaranteed to be correct.

-----------------------------------------------------------------------------------

Testing

	_input data_		_required output_	_passed?_
...................................................................................
Set 1:	0 <Enter>
	-0 <Enter>
	2147483647 <Enter>
	-2147483648 <Enter>
	+1 <Enter>
	<Enter>			0
				0
				2147483647
				-2147483648
				1
				.. sum = 0
				.. avg = 0
..................................................................................
Set 2:	1 <Enter>
	2 <Enter>
	3 <Enter>
	4 <Enter>
	5 <Enter>
	6 <Enter>
	7 <Enter>
	8 <Enter>
	9 <Enter>
	-1 <Enter>		1
				2
				3
				4
				5
				6
				7
				8
				9
				-1
				.. sum = 44
				.. avg = 4 and 4/10

...................................................................................

	Results

All required features are implemented and work according to specification.

-----------------------------------------------------------------------------------


