*************
				*  TiEmu 3  *
				*************

List of text files:

- AUTHORS: list of authors
- COPYING: license
- LICENSES: list of program included
- README.linux: specific linux instructions
- README.win32: specific windows instructions
- RELEASE: what's changed in this release
- TODO: work to do or planned

Texas Instruments and TI are trademarks of  Texas Instruments Incorporated.
For more informations: <http://education.ti.com/educationportal/sites/US/nonProductSingle/global_trademarks.html>
This document has been written independantly of Texas Instruments.

				*****************
				*     TiEmu     *
				* Linux version *
				*****************



REQUIREMENTS
------------

 - A UNIX computer (Intel x86 or PPC) and C compiler (gcc)
 - X11 (X Window System)
 - GTK+ 2.6 from <http://www.gtk.org>
 - ticables2, tifiles2 and ticalcs2 libraries from the
	TiLP 2 project <http://tilp.info>


INSTALLATION
------------

At first, you must have the ticables and ticalcs libraries installed. See
the documentation of these libraries for the installation procedure.

Untar the tiemu-X.XX.tar.gz archive (tar -xvzf), change directory to
tiemu directory.

Go the tiemu directory and type './configure' in order to be sure
that all it is OK. If you want to use KDE file dialogs, run
'./configure --with-kde' instead.
Next, type 'make' to make a binary for your machine.

If you want does not want to use GDB as debugger or use the odl one (tiemu2),
run './configure --disable-gdb'.

If the compile suceeds without any errors, you can type 'make install' to
install the binary in /usr/local/bin. This will also copy some necessary
files to /usr/local/share/tiemu and will install the manpage and the
help.

If you already have some TiEmu images, you will have to manually copy them
to the /usr/locale/share/tiemu/images directory.


USAGE
-----

Type 'tiemu' for using it. TiEmu accepts some command line parameters.
Do 'tiemu --help' or read the manpage by 'man tiemu'.


AVAILABILITY
------------

  http://lpg.ticalc.org/prj_tiemu/index.html


COPYRIGHT
---------

TiEmu is Copyright (C) 2000-2009 by the TiEmu team <tiemu-users@lists.sf.net>

Copying is allowed under the terms of GNU General Public License (LGPL).
See the file COPYING for more details.


---------------------------------------------------------------------------
Please report any bugs, questions, ...  (please give us your platform, your
calculator type (with ROM version) and your link cable model).


The TiEmu team <tiemu-users@lists.sf.net>

				*****************
				*     TiEmu	*
				* Win32 version *
				*****************



REQUIREMENTS
------------

 - a PC with a 450MHz Pentium-class processor and 32MB of RAM
 - a Windows computer: Windows 95/98/Me or Windows NT4/2000/XP/Vista (better)
 - the GTK+ 2.6 libraries
    Location: <http://prdownloads.sourceforge.net/gladewin32/gtk-win32-2.6.8-rc1.exe?download>

Note: if you are using 'The GiMP', you may encounter DLL's problems...
		The GTK+ package (1) provided with the GiMP may not be fully compatible with one used by TiLP/TiEmu.
		On the other hand, the package (2) requested by TiLP/TiEmu is compatible with the GiMP.
		Thus, if you are using The GiMP, you are strongly encouraged to uninstall (1) and install (2).


NOTES
-----

1�) This setup may download & install some extra libraries (GTK+ 2.6).

The GTK+ package includes the Wimp (Windows IMPersonator) theme engine which gives
Windows look & feel (includes XP theming). Is also included the GTK theme selector.
You may need to use it on non-NT systems if you get a lot of warnings about a font.
Simply disable the WiMP theme for another one.

2�) If anyone is getting one of these:
- ** WARNING **: Couldn't load font "MS Sans Serif 8" falling back to "Sans 8"
- ** ERROR **: file shape.c line 75: assertion failed: (glyphs->num_glyphs > 0)
or any other warning or error message regarding fonts/glyphs, the fix is to
open your C:\Program Files\Shared Files\Gtk\2.0\etc\gtk-2.0\gtkrc and to add this:
	style "user-font"
	{
	font_name="Arial"
	}
	widget_class "*" style "user-font"
This forces GTK+ to use a compatible font (Arial) and reportedly fixes both
the aforementioned problems, and probably others too.

3�) If you are getting any errors with DLLs, such as "The procedure entry point
atk_relation_set_add_relation_by_type could not be located in the dynamic link
library libatk-1.0-0.dll", make sure you have one and only ONE version of the
GTK+ DLLs. If unsure, remove all GTK+ packages and install it again.

4�) This setup will:
- copy USB drivers into C:\Program Files\{Common Files}\LPG Shared\drivers\usb,
- and register them into the Plug&Play database.

Simply plug your link cable: Windows should detect a new device and automatically
install it.

Please note these drivers are not compatible with Ti-Connnect(tm).

5�) This setup will install the DhaHelper driver for Windows NT4/2000/XP machines.
This step may require an administrator account (at least for NT4).
You may need to REBOOT your machine after installation (if you plan to
use a parallel or serial link cable).

DhaHelper is copyrighted (c) 2004 Sascha Sommer and released under GPL license.
Source code is available from <http://svn.mplayerhq.hu/mplayer/trunk/vidix/dhahelperwin/>.

6�) The tiemu3-nogdb setup will install the GNU's 'wget' utility for download of GTK+
(http://xoomer.virgilio.it/hherold/).

7�) This setup will install/update the TiLP framework (libti* and drivers) which is
installed as shared components since TiLP v1.07, TiEmu v3.01 or GFM v1.00.
Any software using the TiLP framework will take advantage of this update.

USAGE
-----

The installer automatically creates program entries in the Windows Startup menu.


AVAILABILITY
------------

  http://lpg.ticalc.org/prj_tiemu


COPYRIGHT
---------

TiEmu is Copyright (C) 2000-2009 by the TiEmu team <gtktiemu-users@lists.sf.net>

Copying is allowed under the terms of GNU General Public License (LGPL).
See the file COPYING for more details.


---------------------------------------------------------------------------
Please report any bugs, questions, ...  (please give me your platform, your
calculator type (with ROM version) and your link cable model).


The TiEmu team.