Abroad! 5.8 (2001/03/18)
by Y.Kanai

Abroad! Won the Award in the Travel session of "ZDNet PDA 
SOFTWARE AWARD"

http://www.zdnet.com/downloads/pilotsoftware/awards/00/travel.html

CAUTION!!
AS ABROAD! SUPPORTED DUTCH FROM V5.2 AND THE LANGUAGE INDEX CHANGED,
IF YOU ARE REGISTERED USER AND UPDATED ABROAD! BY OVER-INSTALL, 
ENGLISH USER WILL FIND DUTCH IN THE TITLE AND SO ON. PLEASE 
RESELECT YOUR LANGUAGE IN THE PREF VIEW (MENU VIEW -> 
MENU COMMAND -> Options -> Prefs).

IF YOU ARE USING ABROAD! 4.5 OR LATER, YOU CAN OVER-INSTALL 
THIS VERSION. CURRENCY RATES WILL BE UPDATED AUTOMATICALLY.

<FOR REGISTERED USER ONLY>
IF YOU ARE USING ABROAD! 4.4 OR EARLIER, PLEASE DELETE THE OLD
ONE BEFORE INSTALL THIS VERSION.
IF YOU HAVE REGISTERED ONCE, YOUR REGISTRATION ID WORKS IN THIS 
AND FUTURE VERSIONS. SO, PLEASE KEEP IT WITH CARE. IF YOU LOST 
YOUR ID, PLEASE FEEL FREE TO CONTACT ME.

<Introduction>
 Abroad! is a suite of three applications: Currency Exchange, Unit 
Conversion and World Clock, and a powerful Country Information 
Database, designed to help you when you go "Abroad!". 

 Imagine you're travelling in Japan and you decide to have dinner 
at a sushi restaurant. Currency Exchange will tell you that your 
delicious "Tokujou Nigiri Set : 5,000 Yen" will set you back US$44, 
or the equivalent in many other currencies, and if you order 1 "gou" 
of sake Unit Conversion will tell you know what you're letting 
yourself in for in US pints, Imperial pints, litres or whatever. 
 And when should you call your family back home to wish them 
pleasant dreams?" No problem! World Clock will tell you the 
time wherever they are in the world. 

 In addition, the Country Information Database provides you with 
country specific information on over 260 countries and territories 
world-wide, just a stylus-tap away. It includes each country's 
location on the world map, the nation's capital city, official 
and common languages, currency (name, code and rate to US dollar), 
time (current time, time difference from home country, variation 
from GMT, DST period) and local telephone information (country code, 
area codes of major cities, international dialling prefix, ATT
access number). Naturally, you can search the information by keyword. 

 Have a nice trip!
   
Notice: All the settings will be initialized until you register and
several restrictions in function.

<Distribution>
This manual and all accompanying files may be distributed 
freely, provided that:
1. Neither text nor any other file is modified in any way. No
file may be omitted nor added in the distribution.
2. No money may be charged for the program nor for any 
accompanying files, other than the usual downloading time fees
charged by commercial BBSes and online services.
3. I want to know where my application will be distributed.
Please notify me if it will be included in printed matter, 
floppy, or CD-ROM before its publication. No matter what the
circumstance, I would strongly appreciate a copy of whatever
collection in which it is included.

<version history>
v.5.8 (01/03/18)
 - added view mode in showing the area code/AT&T access number [World Database]
 - can exit from popup form like "calc pad", "time converter" by tapping not only
   "CE" or "Done" buttons but also by tapping outside of the form [General]
 - fixed the alternative name of Greece, Hellenic, to Hellas
 - added icons to "Mode" and "Calc" button in World Clock [World Clock]
 - updated manual to 5.8
 - updated currency rates
v.5.7.1 (01/01/06)
 - fixed bug which introduced in v.5.6 (showing wrong time difference from 
   home city and GMT in World Database) [World Database]
v.5.7 (01/01/05)
 - added currency exchange function in World Database [World Database]
 - fixed bug which introduced in v.5.6 (not showing text in field if the
   text was equal to the old one) [World Database]
v.5.6 (00/12/29)
 - added time calc function in World Clock & in World Database 
   [World Clock, World Database]
 - can select destination currency with auto calculation by UP/DN botton 
   in Menu View [Menu]
 - can select new timezone by UP/DN botton in Change System Clock [Menu]
 - can select city in list by UP/DN botton in Set World Clock [World Clock]
 - color buttons [Currency Exchange, Unit Conversion, World Database]
 - improved code for better response
 - updated currency rates
v.5.5 (00/11/01)
 - can select destination city in Menu View [Menu]
 - reversed DST in Australia as Olympic Game finished [World Database]
 - added tips in Prefs [Prefs]
 - fixed terms in Spanish [General]
 - updated/fixed area codes [World Database]
 - fixed bugs
 - updated currency rates
v.5.4 (00/08/18)
 - updated DST in Australia specifically changed according to the 
   Olympic Game [World Database]
 - updated data in East Timor [World Database]
 - fixed terms in French [General]
 - fixed bug in World Clock Setting [World Clock]
v.5.3 (00/08/05)
 - fixed bug in changing System Clock 
 - added currency rate date in the Currency Exchange view, in addition 
   to the Set Currency Rate view [Currency Exchange]
v.5.2 (00/08/01)
 - can change Palm system clock [Menu]
 - improved up/dn button function in Currency Code List [Currency
   Exchange]
 - updated world database [World Database]
 - changed city classification in Australia, in respect to the Olympic
   Game [World Database]
 - localized to Dutch in addition to Danish, English, French, German, 
   Italian, Japanese, Norwegian, Portguese, Spanish and Swedish (for 
   details see localize.txt) [General]
 - added sizes in clothes to smaller side [Unit Conversion]
 - updated currency rates
v.5.1 (00/04/08)
 - improved map display in re-draw [World Database]
 - improved up/dn button function in World Database [World Database]
 - rewrote several rotuines (the handling of push button, popup, and 
   so on) along with the programming guideline for Palm OS to improve 
   stability of program [General]
 - changed color icons to see well using real device [General]
 - fixed minor data error [World Database]
 - fixed minor bug [Currency Exchange]
 - updated currency rates
v.5.0 (00/03/11)
 - used new PalmRez for MPW Shell, which allowed me to use color
   and small application icons (Thanx 3com for supporting MPW again.)
 - added color and small application icons [General]
 - supported additional 9 system-pref-defined countries from OS 3.5 at 
   initialization [General]
 - updated currency rates
v.4.9 (00/02/06)
 - compatible with Palm OS 3.5 (4.8 or earier has some trouble
   with Palm OS 3.5)
 - polished the code and compressed the data to diminish the program 
   size (-4.4k, which is less than that of  Abroad! 3.4) [General]
 - improved search engine in the World Database [World Database]
 - improved the display of truncated country name in PBN [World 
   Database]
 - fixed minor data error [World Database]
 - updated area codes in Canada and US [World Database]
 - updated currency rates
v.4.8 (99/12/12)
 - improved city search in using World Map by showing the list of
   cities [World Database]
 - updated some currency codes [Currency Exchange]
 - updated currency rates
v.4.7 (99/11/01)
 - improved search engine in the World Database [World Database]
 - improved interface [Unit Conversion, Calc Pad]
 - updated currency rates
v.4.6.1 (99/10/06)
 - check currency rate at calc to avoid div by 0, which can be occured
   by currency database update from the web [Currency Exchange]
   (If you select currencies which have no currency rate data, the
   rates are displayed '-')
 - fixed bug to start with memo view in some circumstance [Menu]
v.4.6 (99/10/02)
 - diminish program size to 100k (-8k), which is less than that of  
   Abroad! 3.4.
 - can select list items by Up/Dn button [Currency Exchange, Unit
   Conversion, World Clock (Map mode)]
 - improved search engine in the World Database [World Database]
 - limited the area code data to be less than 256 bytes for data
   search [World Database]
 - updated currency rates
 - can download the latest currency data at "http://sub.nu/~inferno/palm/"
   (Thank you Daniel, for your support! Please mail him to encourage
   him. Your mail will be his great pleasure and important for his
   continual updates.)
 - manual is partially updated
 - fixed small bug
v.4.5 (99/09/06)
 - changed icons in Menu to fit on Palm III / V and to diminish
   the program size [Menu]
 - polished the code (-8k) and removed "long" area codes 
   (-4k) to diminish the program size (total -12k)
 - fixed small bug
 - updated currency rates
v.4.4 (99/08/01)
 - completed the localization for Spanish and Norwegian in 
   addition to Danish, English, French, German, Japanese, 
   Portguese and Swedish
   (for details see localize.txt) [General]
 - polished the code to diminish the size (-1k)
 - fixed small bug
 - updated currency rates
v.4.3 (99/05/20)
 - completed the localization for French, Portguese and Swedish
   in addition to Danish, English, German and Japanese 
   (for details see localize.txt) [General]
 - updated currency rates
v.4.2 (99/04/18)
 - introduced icons to indicate "Value" and "Calc" [Currency
   Exchange, Unit Exchange] 
 - can select additional title and so on from Danish, English, 
   German and Japanese (for details see localize.txt) [General]
 - updated currency rates
v.4.1 (99/04/07)
 - optimized world clock icon [Menu]
 - improved time info display in World Database [World Clock]
 - introduced icons to indicate "Home" and "Destinations"
   [World Clock]
 - can jump to list by writing first character of currency code
   in addition to tapping push buttons [Currency Code List]
 - can select major title ("Currency Exchange", "Unit Conversion",
   "World Clock") from English, French, Germany, Italian, Japanese, 
   Portuguese and Spanish [General]
 - fixed bug in init "this" unit type [Unit Exchange]
 - fixed bug in day/night bar [World Clock]
 - fixed bbl(US) data [Unit Exchange]
 - updated area codes (Argentina, Italy, Liechtenstein, Spain and
   Uzbekistan) [Database]
 - updated currency rates [Database]
 - partially updated manual
v.4.0 (99/03/14)
 - automatic optimization in default map mode, world clock city set,
   currency exchange settings (code and calc mode) according 
   to the system country information supported in OS 2.0 or later.
   [Currency Exchange] (Note this auto settings are valid only in 
   the 24 countries appeared in the "Present to" list in the "Format" 
   section of the "Prefs" application. If your are living outside 
   these countries or using Palm OS 1.0, please set the settings and 
   tap "OK & init" button to optimize currency exchange settings.) 
 - improved interface to clarify each setting [Prefs]
 - added Day/Night bar in the world map [World Clock]
 - dynamic fitting of the list window width [Currency Exchange, 
   Unit Conversion, World Clock]
 - added update date information to the currency code list
   [Currency Exchange]
 - used float type in converting temperature [Unit Conversion]
 - optimized initial settings of Unit Conversion [Unit Conversion]
 - improved the response [Edit Currency Rate]
 - polished code intensively to diminish program size
 - updated currency rates [Database]
v.3.9 (99/02/01)
 - added list mode in the World Clock, which shows one home and
   8 destination times [World Clock]
 - can select 2 to 10 currencies [Currency Exchange]
 - can select "All" or "This (Unit Type)" in initializing unit data
   [Unit Conversion]
 - updated currency rates [Database]
v.3.8 (99/01/06)
 - improved the "Set World Clock" [World Clock]
 - added "barrel (UK/US)" [Unit Conversion]
 - updated currency rates [Database]
v.3.7 (98/12/18)
 - can edit currency rate of "World Database / Currency Code List" 
   in the Pref View [Database]
v.3.6 (98/12/02)
 - prepared currency code list, which user use in setting "currency
   exchange" database, in addition to world database [Currency Exchange]
 - updated currency rates [Database]
 - updated area code in Spain [Database]
v.3.5 (98/10/17)
 - updated currency rates [Database]
 - fixed minor bugs
v.3.4 (98/07/31)
 - added memo in the nemu view [Menu]
 - added size (clothes, shoes) to unit conversion [Unit Conversion]
v.3.3 (98/07/16)
 - changed icons
v.3.2.1 (98/07/16)
 - Fixed bug on older Pilot (v.3.2 was not compatible with
   1000, 5000, Personal, Professional)
v.3.2 (98/07/13)
 - expanded "area code" covering more than 1000 cities [Database]
 - added "AT&T access number" [Database]
 - updated currency rates [Database]
 - improved the response [Database]
 - fixed minor bugs
v.3.1.4 (98/04/04)
 - updated currency rates [Database]
v.3.1 (98/03/04)
 - can select home currency used in currency rate [Database]
 - updated currency rates [Database]
v.3.0 (98/02/19)
 - checked data (updated currency rates, added city info in
   area code, and so on.) [Database]
v.2.9 (98/02/10)
 - added language (official and common), currency rate information 
   and shows time difference from home country [Database]
   (Currency rates are at Nov, 1996)
 - checked and corrected wrong data [Database]
 - changed fee to US $20. (I also set special price of $10 if you 
   order Abroad! via PilotGear before 98/04/01.)
v.2.8 (97/12/27)
 - jump to the country by tapping on the world map [Database]
 - added several units [Unit Conversion]   
v.2.7 (97/12/21)
 - can show upper character in the case of "1.5x10^15" and such
 - fixed several bugs
v.2.6 (97/12/06)
 - expanded user ID
 - can select Currency code (Country name) / Currency name 
   in setting Currency Exchange via Country Database [Currency 
   Exchange, Database]
 - can jump to the country by writing the first character of
   the country name [Database]
 - corrected data [Database]
v.2.5 (97/12/02)
 - added note to Country Database [Database]
 - added graffity shift indicator
 - corrected data [Database]
 - can register via PilotGear homepage
v.2.4 (97/11/09)
 - can select country / capital name in setting World Clock via
   Country Database [World Clock, Database]
 - can normalize the currency rates according to the home currency 
   via "Std" button at currency rate setting [Currency Exchange]
 - fixed bug in DST calc routine [World Clock]
 - fixed date display bug in Menu [Menu]
 - made HTML format manual
v.2.3 (97/09/20)
 - improved the find command [Database] 
 - corrected data and fixed bugs [Database]
 - polished English in Manual (Thanks to Mr.Paul Rubens)
v.2.2 (97/09/13)
 - added find command [Database]
 - fixed wrong spelling / data [Database]
 - rewrote manual
v.2.1 (97/08/20)
 - added currency info of most cities [Database]
v.2.0 (97/08/17)
 - expanded city database (added capital, currency info) [Database]
 - optimized the code to response more quickly [General]
 - changed the icon array [Menu]
 - fixed bugs [World Clock]
v.1.9 (97/08/04)
 - can access to country database directly from menu view [Menu]
 - expanded city database (added info of Area code and internatinal prefix
   number) [Database]
 - fixed bugs and wrong data [World Clock, Database]
v.1.8 (97/07/27)
 - prepared country data list including countries all over the world
   [World Clock]
 - country code is added to city data [World Clock]
 - inproved the way to select city from city database [World Clock]
 - DST is set automatically [World Clock]
 - support (+, -, x, /) functions in neumeric key pad
 - handled city and currency exchage data as database. This allows 
   (1) user to add city data as many as he wants and (2) city/currency 
   data to be hotsynced [Currency Exchange, World Clock]
 - can select date of currency rate using 'select date of rates' dialog
   [Currency Exchange]
 - expanded time offset to support all time zone (e.g. Nepal (GST 5h 45min))
   [World Clock]
v.1.7 (97/05/05)
 - prepared graphic icon, by tapping which user can enter each view.
 - Subset function of "Currency Exchange" and "World Clock" is prepared
   in the "Menu" view
 - Simple "+" function is added in the numeric key pad [Currency Exchange]
v.1.6 (97/04/19)
 - can select "About Abroad!" view as the Startup View
 - added units to list (from 15-17 to 19-29) [Unit Conversion]
 - avoided the bug in Palm OS 2.0 (PalmPilot will show fatal error 
   when "FldSetFont" is called to change the preset font type of 
   tFLD. This bug is newly introduced in Palm OS 2.0, and to clarify 
   this I have to buy PalmPilot in addition to Pilot 5000.)
 - expanded the currency number from 9 to 10 [Currency Exchange]
 - cancel numeric keyboad by tapping "CE" when displayed number is
   "0" [Currency Exchange, Unit Conversion]
v.1.5 (97/03/19)
 - prepared "Abroad! Prefs", which user can call from "Menu" view
   by "Prefs" command.
   (1) can select startup view out of "Menu", "Currency Exchange", 
       "World Clock", "Unit Conversion" and "Last Launched"
   (2) can select currency caluculation mode, "US" or "Japanese" way.
        US mode: (rate A) x (Currency A) = (rate B) x (Currency B) = ...
        JPN mode: 1 x (Currency A) = (rate A) x (myCurrency) 
 - supported day light saving. Cities of DST mode are labelled with
   "*" mark in the city name [World Clock]
 - reduced initial city number to 8 to save the program size 
   [World Clock]
 - prepared manual and removed "help" from Abroad! application
   to reduce the program size [General]
 - fixed small bug in list display [Unit Conversion]
 - added mm (millimeter) [Unit Conversion]
v.1.4 (97/03/09)
 - can use numeric keyboard by tapping "Value" [Currency 
   Exchange, Unit Conversion]
 - "Temperature Conversion" is included in "Unit Conversion" 
   [Unit Conversion, Temperature Conversion]
 - can select 10 units out of 15 or more [Unit Conversion]
 - can move the position of unit by pushing Up/Dn button [Unit 
   Conversion] 
 - use system defined day/time format [World Clock]
 - improved and fixed small bug in "World Clock Setting" 
   [World Clock]
 - fixed spellings and wrong unit relative values in "ton"
   [Unit Conversion]
 - optimized the code and resource to reduce the memory requirement
v.1.3 (97/02/28)
 - can note the modified date in "Set Currency Rate" [Currency 
   Exchange]
 - can add/delete cities (minimum:2, max:30) [World Clock]
 - prepared time zone list in "World Clock Setting", supporting
   user to edit city data [World Clock]
 - can select map (Asia/Oceania or US/Europe types) in "World 
   Clock Setting" [World Clock]
 - added several units (stone for wool, quart) [Unit Conversion] 
v.1.2 (97/02/18)
 - rounds up fractions to avoid the computation error [Currency 
   Exchange, Unit Conversion] 
 - restricts input value to be more than 0, to avoid bug in
   floating point routine [Currency Exchange, Unit Conversion]
 - checks edit fields in "Set Currency Rate" at application, to
   avoid invalid input [Currency Exchange]
 - user can move currencies using Up/Dn buttons in "Set
   Currency Rate" [Currency Exchange]
 - user can select 9 units out of 15 [Unit Conversion]
v.1.1 (97/02/07)
 - for people outside US, all currencies are handled equally
   (user can set his currency as the base unit) [Currency Exchange]
 - expanded the currency number from 8 to 9 [Currency Exchange]
 - changed the standard time from Washington DC time to GST
   [World Clock]
 - improved the offset time input method to cover the every
   country [World Clock]
 - expanded the city/time number from 6 to 8 (I added my
   favorite cities for the initial data) [World Clock]
 - extended to display upto two-digit under decimal point (I
   used "Long" type in calculation to avoid the bug in floating
   point routine, especailly in subtraction.) [Temperature
   Conversion]
 - show selected unit and its value in bold font [Currency
   Exchange, Unit Conversion, Temperature Conversion]
 - avoid the possibility to show the different value from that
   of input in the selected field, due to the computation error
   [Currency Exchange, Unit Conversion]
 - improved battery performance
 - fixed bugs in spellings and unit name
v.1.0 (97/01/30)
 - initial version

<CopyRight>
Abroad! is SHAREWARE. This means that if you use this program
and decide to keep it, or in other terms, you have used it for
a couple of days and like it, you are required to send me a
small fee of US $20. If you send me the shareware fee once,
NO additional fee is required for the future version. I will
use the fee as a part of the annual updates of developing 
tools and new machine I bought for pilot application 
development last year.

<How to register>
There are two ways to register Abroad!

Register on Web Page (Pilot Gear / Palmcentral) or use kagi service 
using registration program.

(1) Register on Web Page (Pilot Gear)
Please visit my homepage.
http://www.geocities.com/SiliconValley/Peaks/9768 

(2) Register via E-mail, Fax or Postal Mail (Kagi service)
You can send me the fee through Kagi service using 
REGISTER.EXE (Windows) or Register (compressed as MACREG.SIT,
Mac user).
If you send me the fee directly, please do NOT send me US$20
with your checks. (More than $10 is charged for exchange a check 
to money in Japan!) Please send US$20 bill (or bank note of your
country of equal to or not less than US$20) to

Miki Kanai
3-4-7, Yanaka, Taito-ku, Tokyo, Japan, 110-0001

Paying for Abroad! is fairly simple. Open the Register program
that accompanies Abroad!. Enter your name, your email address,
and the number of single user licenses you desire for each 
program you wish to purchase). Save or Copy or Print the data
from the Register program and send the data and payment to 
Kagi. More specifics on the Register program to follow. Kagi
handles my payment processing.

If paying with Credit Card or First Virtual, you can email or
fax the data to Kagi. Their email address is sales@kagi.com
and their fax number is +1 510 652-6589. You can either Copy
the data from Register and paste into the body of an email 
message or you can Save the data to a file and you can attach
that file to an email message. There is no need to compress
the data file, it's already pretty small. If you have a fax
modem, just Print the data to the Kagi fax number.

Payments sent via email are processed within 3 to 4 days. You
will receive an email acknowledgement when it is processed.
Payments sent via fax take up to 10 days and if you provide
a correct internet email address you will receive an email
acknowledgement.

If you are paying with Cash or USD Check you should print the
data using the Register application and send it to the address
shown on the form, which is:

          Kagi
          1442-A Walnut Street #392-XA
          Berkeley, California 94709-1405
          USA

You can pay with a wide variety of cash from different 
countries but at present if you pay via check, it must be a
check drawn in US Dollars. Kagi cannot accept checks in other
currencies, the conversion rate for non-USD checks is around
USD 15 per check and that is just not practical.
If you have a purchasing department, you can enter all the 
data into the Register program and then select Invoice as your
payment method. Print three copies of the form and send it to
your accounts payable people. You might want to highlight the
line that mentions that they must include a copy of the form
with their payment.
Kagi can not invoice your company, you need to act on my 
behalf and generate the invoice and handle all the paperwork
on your end.

Please do not fax or email payment forms that indicate Cash,
Check or Invoice as the payment method. As far as we know, 
there is still no technology to transfer physical objects via
fax or email and without the payment, the form cannot be processed.
Payments send via postal mail take time to reach Kagi and then
up to 10 days for processing. Again, if you include a correct
email address, you will hear from Kagi when the form is processed.
When you pay, we tell you your registration ID with which you
can register your copy. If you do not have an email address,
please enter your complete postal address and please 
remember, we do not know what country you live in so please
enter that into the postal address also.

<Restrictions>
The author will not take responsibility for any damage or loss
that occurs using this program. If you have any bug-reports
or improvements you would like to see (including my poor 
English), please send them to me.

Y.Kanai (ykanai@kagi.com)