EURO support for DOS
====================

EURO is a tool to provide the support for the common European currency,
the Euro, within your DOS and DOS programs.

1.- Components, packages and versions
2.- Usage
3.- Limitations
4.- Future plans
5.- Error messages
6.- Contacting and reporting bugs
7.- Copyright


1.- COMPONENTS, PACKAGES AND VERSIONS
======================================

Each EURO package set must be distributed including the following files:
EURO.EXE    The EURO handler, capable of installing, uninstalling and
            checking the status
EUROTSR.EXE The EURO resident handler, which provides the low level service
EURO.TXT    This file, with ful information and documentation
EURO.LSM    The LSM descriptor for the package
EURO.PAS    Source of EURO.EXE
EUROTSR.PAS Source of EUROTSR.EXE
GPL.TXT     A copy of the GPL license

This package is labeled as:
     EURO 0.9 (beta1) English

This version is compilable under a 16-bit Pascal compiler fully compatible
with TurboPascal 7.0. It hasn't been tested under TurboPascal 5.5, although
the final release will be 100% compatible with TurboPascal 5.5.

In the moment of the release of this package, the complete list of available
packages is:
     EURO 0.9 (beta1) English
     EURO 0.9 (beta1) Espaol

If you want to know about the latest update of the program, please contact
the author as specified in (6).


2.- USAGE
=========

The installation is very simple. Ensure that both EURO.EXE and EUROTSR.EXE
are visible within the PATH var of your system. The COMSPEC variable MUST
have a value, indicating the path to the system command interpreter.

You can activate EURO by typing:

EURO

And deactivate with:

EURO /U

Use the following:

EURO /?

for a complete list of options.

Once EURO is active, the euro symbol will replace all the occurrences of the
French Franc symbol (code 159). You will be able to produce an euro character
using the combination AltGr+E (AltGr is an alternative label of the Right
Alt key).

EURO can be set in the AUTOEXEC.BAT file, so that you get euro support every
time you start your PC.


3.- LIMITATIONS
================

EURO has been designed to work under DOS. There are two further known
limitations:

1.-) EURO is incompatible with all those programs which use the 850 codepage
and REQUIERE EXPLICITLY the ussage of the French Franc symbol as different
from the Euro Symbol.

This limitation can be easily solved if you have access to a Pascal
(TurboPascal compatible) 16-bit compiler, by choosing the new code to be
replaced by the Euro symbol, and modifying EURO.PAS (line 12 of the
InstallEuroChar procedure) and EUROTSR.PAS (line 15 of both BackgroundInt
procedure and KeyboardInt procedure).

2.-) EURO requieres a VGA graphic card or better.

This limitation will be outcome in future releases.


4.- FUTURE PLANS
================

Current release is beta, and there are not known bugs.

Future releases will provide euro support for graphic cards other than
VGA (EGA and CGA).
Support for other languages is a desirable option too, specially for those
languages spoken in the member countries of the European Community. If you
speak an unsupported language, and would like to contribute, please contact
the author as specified in (6).


5.- ERROR MESSAGES
==================

There are 4 possible error messages:

ERROR 1:  Unable to uninstall EURO
CAUSE:    Some other TSR has been installed after EURO, and has hooked one
          of the interrupts hooked by EURO (9h, 12h, 28h).
SOLUTION: Try to uninstall (if possible) those other TSRs first. Otherwise,
          reboot your PC.

ERROR 2:  EURO is already installed
CAUSE:    You are trying to install EURO, which is already installed.
SOLUTION: You don't need to reinstall EURO, as it is already installed.

ERROR 3:  EURO support not found
CAUSE:    You are trying to uninstall EURO, which hasn't been found.
SOLUTION: If EURO is already uninstalled, you don't need to uninstall it.
          Otherwise, reboot your PC.

ERROR 4:  Unable to install EURO (COMSPEC SET?)
CAUSE:    EURO can't find the command shell and/or the resident handler.
SOLUTION: 1.- Ensure that the variable COMSPEC is SET (check help on SET)
          2.- Ensure that EUROTSR.EXE can be acceeded within your PATH
              (check help for PATH)


6.- CONTACTING AND REPORTING BUGS
=================================

You can contact the author via e-mail:
aitor.sm@teleline.es
please, place EURO somewhere in your subject line. Contacting the author will
help you:
- Know about latest release
- Try to solve your problems
- Get more information about EURO
- Get more information about other programs available

There are currently no known bugs. If you want to submit a bug, please check
that it is a real bug, and if it is, then submit a mail to the author
stating:
- Information about your system, specially DOS system and version
- How your EURO is installed
- A description of the problem as accurate as possible


7.- COPYRIGHT
=============

EURO is a tool to enable Euro support in your DOS'
Copyright (C) 2000 - Aitor Santamara

-------------------------------------------------------------
This utility is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This utility is distributed in the hope that it will be useful,
but WITHOUT ANY GUARANTEE; without even the implied guarantee of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details. (http://www.gnu.org)
-------------------------------------------------------------
