README file for Xofia Euro 3.0


Xofia Euro is a currency converter and calculator that 
performs operations with many different currency units. You 
can change the number of displays you want to work with by 
simply resizing the program window. For each display you can 
specify a different currency unit. You can configure any 
number of currencies in the application's currency table. 
The exchange rates for the configured currencies are updated 
from the Internet.

1. Features

- Easy to use, customizable user interface that let you work
  with any number of amounts expressed in different
  currencies.
- The currency table is configured by default with all the
  currencies whose daily exchange rates are published by the
  European Central Bank and the currencies that have a fixed
  rate and have been replaced by the euro.
- Daily exchange rates updated from the Internet.
- Support for a network installation with a centralized 
  access to the Internet (only one computer connects to
  the Internet and shares the downloaded data with all
  the others).

2. Requirements

Xofia Euro runs on Windows 95/98/Me/NT4/2000/XP.

Xofia Euro requires that "shfolder.dll" is installed on your 
system. This file is installed by default on recent versions 
of Windows (Windows 98SE/Me/2000/XP) and is usually 
installed on the older systems by other applications 
(Windows NT service packs, Internet Explorer etc.). However, 
if you get an error message like "Cannot find SHFOLDER.DLL" 
when you try to execute Xofia Euro then "shfolder.dll" is 
not installed on your system. If this is the case, go to the 
Xofia Euro download page at

http://www.xofia.com/euro/download.html

and download "shfolder.exe"; this is a little installation 
program provided by Microsoft that will install 
"shfolder.dll" on your system.

3. Installation

Run the Setup program, which will guide you step by step 
through the installation of Xofia Euro on your computer.

The Setup program accepts optional command line parameters. 
These can be useful to system administrators that want to
automate the installation of Xofia Euro on many computers:

/SILENT, /VERYSILENT - Instructs Setup to be silent or very 
silent. When Setup is silent the wizard is not displayed but 
the installation progress window is. When a setup is very 
silent this installation progress window is not displayed. 
Everything else is normal so for example error messages 
during installation are displayed.

/NOCANCEL - Prevents the user from cancelling during the 
installation process, by disabling the Cancel button and 
ignoring clicks on the close button. Useful along with 
/SILENT. 

/DIR="x:\path" - Overrides the default directory name 
displayed on the Select Destination Directory wizard page. 
You must specify a fully qualified pathname.

/GROUP="folder name" - Overrides the default folder name 
displayed on the Select Start Menu Folder wizard page.

You can also instruct the Setup program to automatically 
register and/or configure Xofia Euro during the installation 
process by creating the following files in the directory 
where the Setup program resides:

"license.ini" - Registration data. If this file exists, the 
program will be automatically registered during the 
installation process. The file contains the license data in 
the following format:

  [License]
  RegistrationName=<<registration name>>
  Users=<<number of licenses>>
  PurchaseYear=<<year of purchase>>
  PurchaseMonth=<<month of purchase (1-12)>>
  PurchaseDay=<<day of purchase>>
  ActivationKey=<<activation key>>

"config.ini" - Configuration. If this file exists, the 
program will use the given configuration as the default. You 
can create a configuration file from a working installation 
of Xofia Euro by selecting the "Save Configuration..." item 
from the "File" menu.

"currencies.xml" + "currencies.dat" - Currency Table. If 
these files exist, the program will use the given currency 
table as the default. To export a currency table from a 
working installation of Xofia Euro, select the "Options..." 
item from the "View" menu and then click on the "Save" 
button in the "Currency table" page.

4. Uninstallation

You can remove Xofia Euro from your computer in the standard 
way by using the Control Panel.

ATTENTION: Xofia Euro saves configuration and status info on 
the Windows registry for each user of the program in the 
following registry key:

  HKEY_CURRENT_USER\Software\Xofia\Euro\3.0

This data is not removed by the uninstallation procedure. 
You can remove this data manually by using the Windows 
"regedit" utility.

Xofia Euro saves a copy of the currency table in the 
application data folder for each user of the program. The 
path of this folder may vary on different versions of 
Windows. For example, on Windows 2000 the folder is usually
located in:

  C:\Documents and Settings\User\Application Data\Xofia\Euro\3.0

This data is not removed by the uninstallation procedure. 
You can remove this data manually by erasing the files in 
the folder.

5. Distribution

This program is distributed as Shareware. The program may be 
redistributed as long as all original contents and 
documentation are maintained intact without alteration and 
included with the package.

Read the License Agreement carefully before you distribute 
or install this program.

6. Registration

You can use this program for an evaluation period of 30
days. If you want to use the program after the evaluation
period, you must purchase a license and register your copy
of the program.

See "Registration" in the User Guide for information on how
to register your copy of this program.

7. History

v3.0 (May 2003)
- Completely rewritten.
- Name changed from "EURO Converter" to "Xofia Euro".
- Can show any number of displays.
- Perform calculations with values expressed in different 
  currencies.
- Currency table can be configured with any number of 
  currencies.
- Software available in english and italian.

v2.4 (December 2002)
- Internet update works with the new currency rates table
  published by the European Central Bank.

v2.3 (November 2001)
- All currencies are user-configurable.
- Input display is highlighted more clearly.

v2.2 (September 2001)
- Command line switch allows to automatically update
  currencies in batch mode.
- Silent installation and registration.

v2.1 (March 2001)
- User-defined currency rates updated from the Internet.
- User Guide in standard Windows Help format.

v2.0 (December 1999)
- Calculator capabilities.
- "Compact" and "Extended" view modes.
- "Stay On Top" button.
- Flag bitmaps for user-defined currencies.
- Configurable decimal separator character for values copied
  to the Clipboard.
- Fixed point and floating point input.
- Up to 6 user-defined currencies.
- 13-digits display.

v1.2 (June 1999)
- Display digits color changed for better readability.

v1.1 (April 1999)
- User-configurable currency buttons.
- Copy and paste support.
- Currency names are shown when you move the mouse pointer
  over the currency buttons.

v1.0 (March 1999)
- Initial release.

8. Contacts

You can find the latest release of Xofia Euro at:

  http://www.xofia.com/euro

Send suggestions or help requests to:

  euro-support@xofia.com


Copyright (C) 1999-2003 Michele Galante
