
This is Readme.txt for ScoreSheet version 1.5

ScoreSheet is 1998-2000 by Roger Chaplin <foursquaredev@worldnet.att.net>
                            http://home.att.net/~foursquaredev/


----------------
| Introduction |
----------------

ScoreSheet is intended as a general purpose score keeping utility.
Features include:

    o Quick entry of players' names; just start writing
    o Accomodates positive and negative scores
    o Checkbox beside each player's name so you know whose score has
      been entered for this round and whose has not
    o Support for games that involve bidding
    o Undo a score, in case you made a mistake
    o View and edit a player's score history
    o Scores up to +/- 2,147,483,647 (32-bit accumulator) for those
      really long games
    o Optional automatic sorting of players by score at the end of each
      round, either highest to lowest or lowest to highest
    o Selectable font size -- tailor the display to suit your needs
    o Programmable reset score value, for games that begin with a score
      other than zero
    o Number of players limited only by your available memory
    o Up to 15 independent lists of players -- keep your family Scrabble game
      separate from your Saturday afternoon dominoes
    o Includes a "bone tracker" for playing dominoes -- check off the bones
      that have been led

Whenever you and your friends or family sit down to play a game, and you
need to go find a piece of paper on which to keep score, use ScoreSheet
instead.


-----------------
| Compatibility |
-----------------

ScoreSheet runs on any Palm Computing platform, using any version of Palm OS.
At the time of this writing, this includes the Pilot 1000 and 5000, PalmPilot
Personal and Professional, Palm III, Palm IIIe, Palm IIIx, Palm IIIxe,
Palm IIIc, Palm V, Palm Vx, Palm VII, IBM WorkPad (all models), Handspring
Visor (all models), and TRG Pro.


--------------
| QuickStart |
--------------

Step 1: Install the included scoresheet.prc on your Pilot.
Step 2: Start the program.

If you are upgrading from version 1.3, your player lists and preferences are
preserved. Also, if you have registered version 1.3, you will not have to
re-enter the registration code.


----------
| How To |
----------

Enter a new player:         tap the "New player" button, or just start writing
Enter a score for a player: tap on the player's name (while un-checked)
Undo a score:               tap on the player's name (while checked)
Control sorting:            use Menu->ScoreSheet->Preferences
Change display font:        use Menu->ScoreSheet->Preferences
View a player's history:    tap on the player's name, then hit "Details"
Edit a player's name:       tap on the player's name, then hit "Details"
Change a player's score:    tap on the player's name, then hit "Details"
Delete a player:            tap on the player's name, then hit "Details"
Delete all players:         use Menu->Player->Delete All
Use the bone tracker:       use Menu->ScoreSheet->Preferences


------------
| Features |
------------

Bidding
-------
If you are scoring a game that involves bidding, enable this feature on the
Preferences screen (Menu->ScoreSheet->Preferences from the main screen). Then
at the beginning of a round, tap the player name that holds the bid, enter the
bid value, then tap the Bid button. This causes the empty checkbox next to the
name to change to a diamond, indicating that this player holds the bid. If you
have made a mistake (selected the wrong player, or entered the wrong amount),
simply follow the procedure again give the bid to the correct player or enter
the correct bid amount.

At the end of the round, when you are entering players' scores, if the player
holding the bid has scored less than the bid amount, ScoreSheet subtracts the
bid amount from the player's total score, rather than adding the player's
score for the round.

Players' Score History:
-----------------------
You can view a player's entire score history. You can change any of the
scores, in case you didn't catch a scoring mistake until later in the game. To
view the history, bring up the player's Details screen (tap a player's name,
then hit the Details button). Once there, you can tap on any score in the
history list to edit it.

Programmable Reset Score:
-------------------------
You can program the score reset value (the value that all the scores get
returned to when you hit the "Reset scores" button). To use this feature, go
to the Preferences screen (Menu->ScoreSheet->Preferences from the main screen)
and enter the new reset value.

Bone Tracker:
-------------
Keeping track of players' scores is only one part of the task of a score
keeper when you're playing dominoes; you also have to keep track of which
bones have been led to begin a hand. To use ScoreSheet's Bone Tracker, go to
the Preferences screen and select the size of the domino set you are using. A
small domino button will appear at the bottom of the main screen, right next
to the "Reset scores" button. Tap this domino button to bring up the Bone
Tracker screen. You can check and un-check the boxes as you like.  When you
reset scores using the "Reset scores" button, ScoreSheet also unchecks all the
bone checkmarks for you.


---------------
| Registering |
---------------

ScoreSheet is shareware. A single user license costs $6.00. The unregistered
version limits you to two players. When you register you will receive a code
to unlock the program, which will remove the 2-player limitation. Registration
also entitles you to technical support. You may register ScoreSheet at either
PalmGear H.Q or PalmCentral.

PalmGear H.Q.:
    2500 East Randol Mill Road, Suite 117
    Arlington, TX 76017
    800.741.9070
    http://www2.viaweb.com/pilotgearsw/rogerchaplin.html

PalmCentral:
    http://www.palmcentral.com/

When you register at PalmGear H.Q. or PalmCentral, please include the RegCode
that appears on the ScoreSheet registration screen (Menu->ScoreSheet->About,
then tap the Unregistered Shareware button). Using this code will help to
ensure that you receive the correct unlock key.

If you wish to register more than one copy, enter the Pilot User Name and/or
RegCode for one of the devices on the online order form, and email the other
Pilot User Names and/or RegCodes directly to foursquaredev@att.net.


--------------------
| Revision History |
--------------------

February 25, 2000   v1.5
    o Fixes to make it run on Palm OS 3.5

January 2, 2000     v1.4
    o Added support for bidding games

May 6, 1999         v1.3
    o Added score history
    o Added support for multiple display fonts

March 22, 1999      v1.22
    o Minor change to category popup lists to eliminate potential problem for
      PalmOS 3.1 (PalmIIIx and PalmV) users

March 1, 1999       v1.21
    o Widened score column on main screen so as not to truncate large
      scores
    o Already scored message box now contains player's name and last
      entered score

February 26, 1999   v1.2
    o Added the Bone Tracker

February 22, 1999   v1.1
    o Added support for categories
    o Added programmable reset score
    o Added initial score for new player
    o Added edit player name and score

March 21, 1998      v1.0
    First public release
    o Added the New player button on the main screen
    o Shareware version with code to unlock

March 15, 1998      v0.03
    First limited public release for alpha testing


-----------
| Support |
-----------

If you have suggestions, comments, constructive criticism, or questions,
please let me know. I give priority on technical questions to registered
users, but I do try to answer all questions. And who knows? Your
suggestion may become the next new feature!

The most recent version of ScoreSheet has been thoroughly tested on
PalmOS 2.0.5, both on real hardware and under emulation, and on PalmOS 1.0
and PalmOS 3.0 under emulation. There are no known bugs.


---------------
| Limitations |
---------------

1.  On the New Player and Player Details forms, the program makes no attempt
    to ensure that you enter only decimal digits (0-9) and the minus sign (-)
    in the Score field. If you enter non-digit characters in this field the
    program will not crash, but neither will you get a reasonable number.


------------------------
| Planned Improvements |
------------------------

1.  Reduce the size of the prc. The app seems to be working fine; now
    it's time to optimize it a bit.
2.  Keeping track of bid, for games such as Rook (and others, I am
    sure).


-------------------------
| Ideas for Improvement |
-------------------------

1.  Display players' score histories (score each round).
