Documentation for GOLF v1.0 for the Psion Siena
================================================

This game is shareware, so please share it with other Psion-owning
friends!

Note that people who have previously registered "Fairway 2.2" for the
Psion 3a can simply use the same registration code for Siena GOLF, as
they are identical. It also follows that you can go from Siena GOLF to
the 3a version equally easily. Fairway can be found as FAIR22.ZIP at most
good shareware outlets, or from my web site.

You can also use this game without further registration if you own the
original Psion Games Pack 3a. Just copy the FAIRWAY.REG file to GOLF.REG
in your \OPD directory.

http://ourworld.compuserve.com/homepages/slitchfield

Siena GOLF requires 62k of disk space and 65k of system memory when
running. These requirements are about half those of the equivalent
3a version.

Quick Installation:
-------------------
(Quickest) If you unzipped the distribution ZIP file with the "-d"
directory flag, or equivalent, you'll see that the correct files and
directories have been formed for you. All you need to do is to drag and
drop them over onto your Psion Siena. (Tip: hold the control key down
while you do this, to stop PsiWin trying to 'convert' everything!)

(Manual) Install by putting GOLF.OPA into an \APP directory and GOLF.PIC
and GOLF.RSC into a \GOLF subdirectory beneath it.

Thus \APP\GOLF.OPA
and  \APP\GOLF\GOLF.PIC
and  \APP\GOLF\GOLF.RSC

and then install the OPA in the normal time-honoured Psion manner ...
(Please note that the PIC file contains several pictures, several
people appear to be confused by this, but I assure you it's all optimised
as well as possible, and that this file *needs* to be the size it is!)

If you suspect that your copy of Siena GOLF has been 'hacked' or changed
in some way, then please call me to let me know where you obtained the game
from and to check the files sizes etc with me.  Thanks!

Copyright UK 1996, Steve Litchfield,
22 Grays Crescent
Woodley
Reading
RG5 3EN

Registration fee: 12
                  If you live outside the UK, convert to either
                  Sterling (or Eurocheque in Sterling),
                  US $, DM or french ff, and send cash.

Or register on-line on Compuserve with SWREG no. 6566

Released as shareware. The shareware version is fully functioning in
every way, with the only nuisance factor being the occasional
interruption of various nag screens, encouraging you to play fair, play
the game, and support authors like myself by sending in some money. I
will then issue you with a personalised key-code, which you can type
into Siena GOLF from the Psion-R screen, and which will disable all the
nag-screens and display your name every time the program is booted.
This will ease your guilt factor, and speed up the gameplay
considerably! I can e-mail you this code if necessary.

All temporary files, player stats files (*.FWS), menu settings
(GOLF.SET), and saved games (GOLF.SAV) are stored in small files in
your M:\OPD directory.

Gameplay
--------
GOLF takes you onto the professional tournament circuit, where you can
pit your skills against a variety of dubiously named computer
controlled opponents. You have 16 clubs (SupaDrive, 3 woods, 9 irons, 2
wedges and putter) and they are selected automatically, though you can
change the automatic selection with the up/down arrow keys, or even
turn automatic selection off altogether. The current club, and its
expected hitting distance (including rolling, and without 'overswing')
are shown inside the power bar.

There are three modes of play. Practice, where you play on your own
and where your performance isn't recorded in the statistics file,
1-Player, where you play in a tournament against the aforementioned 20
computer players, and finally 2-player, where you can play against a
friend within the tournament environment. It is not possible to change
mode half-way through a round/tournament, so you have to decide right
at the start of each game how you want to play!

Note that the playing order of the various opponents remains the same
throughout the game, with your good self taking up the rear, i.e.
playing last, so that you know exactly what you have to do! I hope this
doesn't disappoint fans of 'real' golf too much! In 2-player game, the
winner of each hole gets to shoot first on the following hole, just
like in the real game.

Each hole is randomly generated for this particular tournament, at the
time of playing, so you'll never play the same tournament course twice!
(The actual sequence of par ratings remains the same, but the hole
lengths and contents will always be different.)

Difficulty
----------
Because you are pitted against 20 computer opponents of varying (OK,
random!) skills, there is no need to have a changeable difficulty
setting for the game, as whatever your individual skill, you should
find yourself somewhere in the 'pack', and your challenge will be to
gradually move up the leaderboard, and eventually start winning. The
game is tuned such that you should find winning a tournament a real
challenge even when you've been playing Siena GOLF for a while,
especially as the computer players start playing better once you start
edging into the lead!

Hazards
-------
There are the usual golf hazards of trees (which can block your shot,
unless you squirt the ball out under them, or deliberately play with an
extravagant hook or slice to go round them) and light rough, rough,
long grass and bunkers (in all of which you'll need to hit harder than
normal, to varying degrees). Long grass and bunker shots also suffer
from a built-in random factor, as in real life! Also, there is normally
a wind blowing, with a special arrow showing its speed and direction
(and an extra digital readout of its speed). If you are putting at the
time, the arrow is used to show the break on the putt, i.e. the slope
of the green and its size. Note that if the arrow is so short that you
cannot distinguish its direction, then the wind/slope is probably not
sufficient for you to worry about! The edges of the green are 'rougher'
and will tend to slow your ball down, as with a real green.

Hitting the ball
----------------
The method used to hit the ball is the same as you've probably used
before on other computer golf games (e.g. FAIRWAY). There are
cross-hairs to aim your shot and a 'power bar' (along the bottom of the
screen when it's your turn to play) to control how hard you hit the
ball.

Using one of the 'action' keys (Tab, Delete, Space or Enter), use the
'3-click' method, whereby you tap the key once to start the 'power bar'
moving, once more to stop it rising and one last time to time your
shot, by stopping the bar as close as possible to the timing mark
shown. Timing your shot badly will result in hooking or slicing the
ball, or in imparting spin if you are putting. Note that hitting the
ball too hard when putting can cause the ball to jump over the hole,
and not drop in. So you can't just blast the putt at 50 mph straight at
the hole!

Note that Siena GOLF allows for 'overswing'. Notice the thick bar a
short distance from the left edge of the power bar. This is the 100%
mark, and stopping the power bar on this mark will assure you of 100%
power, to achieve the expected hitting distance for that club. If you
allow the power bar to rise beyond the 100% mark, you will achieve more
than 100% power, for extra distance, but at the expense of magnifying
any timing error in your shot. In other words, if you hit your shot
with 120% power, but manage to slice the ball as well, the slice will
turn out far more extravagant than if you had hit with 100% power.
Also, bear in mind that mistiming your shot also reduces the hitting
power available, so you can see that overswing should be used only when
absolutely necessary, and then with maximum precision on the timing
line!

Siena GOLF uses the laws of physics when it calculates ball motion, and
was designed to give some of the feel of the real game. This has
several effects. For example, when putting, notice that the markings on
the power bar are not evenly spaced, and that although hitting the ball
to half the maximum putting distance still needs the power bar to be
taken up to the fifth graduation (ten graduations = full scale), this
mark is nearer 75% of the on-screen maximum. This non-linearity is
designed to represent what happens on a real putting green, with
friction, inertia and so on.

Menu options
------------
The Menu key gives you access to the overhead and ball lie views, to
the scorecard so far, to the player statistics screen and to the setup
menu. And of course there is an Exit option, by which you can terminate
your game.

You can also turn off (or on) automatic showing of the overhead view
and the ball lie, and can also ask the computer whose shot it is and
which shot they're currently playing. The auto-showing of the
leaderboard and the auto-selection of clubs can also be customised.

The save game option will save your current game (as at the start of
the hole currently being played) to a specific file in the \OPD
directory of your internal disk. This can only be restored when Siena
GOLF is launched. This is designed to discourage people cheating by a
continual cycle of Save-play-restore on a 'difficult' hole.

Each menu option has its own hot key, by which you can go straight to
their function without going through the menus, e.g. Psion-X will take
you straight to the "Exit: save game? (Y/N)" screen.

Note that all the menu option settings will be retained from one game
to the next. GOLF uses a small file called GOLF.SET to do this.

Setup options
-------------
The setup menu will appear at the beginning of every game, and allows
you to control how the game should work. You can select the playing
mode (Practice, 1-player, 2-player), your name and that of your human
opponent (if any) and whether you want sound effects (On, Off). Notice
that if you are registered, your name will automatically appear in the
setup box when you play the game.

************************************************************************
Thankyou for playing Siena GOLF v1.0. Please play fair with shareware!
************************************************************************

Note to hackers: Please don't try to hack this game. Although everything
is possible, it really isn't worth it! Use your undoubted programming
skills to write something of your own instead and make a positive
contribution to the Psion software world!!

HAVE FUN!
