Bowling scorekeeper v1.0
========================
Released for the TI app-development contest 2003

Author: 
Andreas Finne
afinne@saunalahti.fi



Introduction:
-------------

This program is intended as an alternative to the printouts you get at bowling
alleys. You type in the results as they come, and when you're done, you have 
the possibility to save the scores. Each player has a file of his own, where 
that player's score gets saved.

You can also view some statistics on the results. Due to other deadlines, 
the statistics part of this version is not that extensive. You can expect more 
from version 2.0. The player files will be compatible between versions, so you 
can still keep your old scores.

Hopefully the interface is easy to use without explanations. It uses softkeys
in several places, and at other places it says on the screen which buttons do
what. Otherwise it uses normal arrow keys and ENTER. The application can be
exited at any point in the program by pressing 2nd QUIT.

The application is run from the 'APPS' menu on the calculator. It uses no 
direct access to I/O ports; instead it uses proper entry points. APD
(Automatic Power Down) is enabled to maintain low battery power.



Controls:
---------

Menus:
    UP/DOWN  Move marker
    ENTER    Confirm

In game:
    LEFT/RIGHT  Move marker
    Numbers
    Softkeys
    On-screen instructions

Any time:
    2nd QUIT    Homescreen



File management:
----------------

If the player's file is archived, and the player joins a game, or views his
statistics, the file is unarchived. Unused files can be kept archived, the
application still finds them, and unarchives them when they are needed.



File format:
------------

A players data is stored in an AppVar. The structure of the AppVar is as
follows:

BWL			; 3 bytes
"Player name",0		; 17 bytes, zero padded
Number of plays		; 2 bytes
-----------------------------------------------
    Size of play	; 2 bytes      
    Date of play	; 3 bytes YMD  Several
    Average		; 2 bytes      of these
    Frames in play	; 1 byte
-----------------------------------------------
	Squares		; 21 bytes     Several 
        Total		; 2 bytes      of these
-----------------------------------------------



Future versions:
----------------

One thing that could be interesting is to show the number of strikes, spares,
and so on for each game. Perhaps some kind of graph that shows the improvement
of a player, or a comparison between two players.




(c)2003 Andreas Finne
andreas@calc.org
afinne@saunalahti.fi
