FoneHome v1.01

LICENSE:

This software is released under the terms of the GNU General Public License
(the GPL).  In essence, this license allows you to use this software for any
reason, redistribute it for any (or no) fee, and to obtain the source code and
make changes to it.  If you redistribute the software, with or without any
changes made by you, you may only do so if you make it available under the
same terms.  That means that you can distribute a changed version under the
GPL, or may include code from this software in another piece of software,
provided the whole is under the GPL.

The full text of the GPL is in the file COPYING, which should have been in the
archive with the software and this README.  If it *wasn't* provided, please
let me know at once where and when you got the software, so I can correct the
error.

Most PalmOS software is shareware or payware.  This is not - it is free
software.  For more information on the free software movement, see
http://www.fsf.org or get in touch with me.  If you feel that this software is
worth some money to you, please give it to your favourite charity - I don't
need it and the charity will almost certainly put it to better use than I
would.

This software is not covered by any warranty (or, at least, I, the author,
provide no warranty) and it is not guaranteed to work for you.  It works for
me, and I will try to fix any reported bugs (much more likely with a solid
test-case or better, a patch), but in the immortal words of some forgotten
free software author:  "If it breaks, you get to keep both pieces."

Usage:

It's pretty simple.  FoneHome is a dialler, using the advanced TRGPro sound
system.  It has four main functions:

1) Simple dialling - the keypad in the bottom left of the screen will dial the
   numbers and symbols on the buttons.

2) Custom numbers - you can set up to six custom names and numbers by using
   Command-U or the "Custom Numbers" menu item.  Hitting the relevent button
   at the top of the screen will then dial the number.

3) Clipboard dialling - The "Clip" button or Command-C will dial the number
   currently in the clipboard.  It doesn't (currently) do anything clever with
   the contents of the clipboard, so it will 'dial' any a,b,c,d,# or *
   characters in the clipboard.  You're best off making sure you have only
   copied the necessary number to the clipboard, with as little else as you
   can, although spaces and dashes (most common characters to write within a
   number) will be ignored.

4) Address book lookup - Write a name in the text field above the "Address
   lookup" button and hit the button.  If the text is enough to uniquely
   identify a name, the number will be dialled.  If not, a window will pop up
   to let you choose.  In this case, only numbers will be dialled, since the
   system gives me back the name *and* the number, and it is pretty easy to
   just pick the digits out of the return string.

When you're dialling a whole number (as opposed to a single digit/symbol from
the keypad), the system is locked while it dials.  This is a 'feature' of the
audio software provided by TRG - I can do something about it by dialling each
number individually, but it's much easier this way.  Get in touch if you
*really* want your TRGPro to response while dialling.

Release history:

22/02/00
1.0	First full release.
23/02/00 just after midnight GMT
1.01	Fixed a stupid bug in 1.0 - thanks to John Deters for the report.

The author:

I work as a Unix system developer during the day.  I bought a Palm III on
31/12/98 - upgraded it to a IIIx a few months later - won a TRGPro at
PalmSource London in December 1999.  I have written a couple of small pieces
of Linux software, but I enjoy programming for PalmOS more.  It is a nice
environment in which to code, Palm (and TRG) are very good to their
third-party developers, and the community is in most cases, a nice place to
be.  My programming background is in the Linux community, where the vast
majority of software is free (aka open source) software.  I am somewhat
suprised at the lack of free software authors working in the PalmOS world -
there are only a handful of us - and I'm proud that so many people (seem to)
have found my software, written in my spare time for fun or my own use,
useful.

The home of this software, and my other Palm software, is
http://www.vmlinuz.org/palmos and my contact e-mail address is
richard@vmlinuz.org .  Please get in touch with me if you have any problems
with this software, having checked for a new version or any news at the above
URL, or if you have any other questions which you think I can help you with.
I tend to be short with questions which are answered somewhere else easily
found, and friendly and helpful otherwise :-)

Cheers
Richard - 21/02/2000
