                              TARGETD64
AN UNIVERSAL C64 ARCHIVE RELATED CONVERTER TOOL AND EMULATOR FRONTEND

TargetD64 homepage:
http://skyscraper.fortunecity.com/quadra/251/targetd64.html
Author: Karlheinz Langguth mailto:klangguth@netscape.net

~/README: TargetD64 source distribution
-------------------------------------------

After untaring the distribution package you will find a directory tree like
this:

targetd64_xxx
|
+- distribution - files that are not generated but needed for distribution
+- obj_dbg      - change to here to make debug version of TargetD64
+- obj_rel      - change to here to make trace version of TargetD64
+- obj_trc      - change to here to make trace version of TargetD64
+- src          - C++ sources originally written for TargetD64 (core)
+- src_foreign
   |
   +- lha       - "open source" of lha package
   +- zlib      - "open source" of zlib package
   +- VICE      - "open source" of VICE package

Sources under src_foreign are not written by the TargetD64 author. As TargetD64
they are "open source". See the Copyright section for details.

All further information is only for use with Linux. For a Win32 generation read
the README.WIN32 file.

Attention:
The tar archive of this source distribution includes symbolic links.
If your OS does not support symbolic links replace them by copies.
To see what is linked use a "tar tvfz ...". This is NOT needed for
Win32 generation.

Configure
---------

There is no ./configure. Instead there are three generation directories
(obj_...) one for each TargetD64 configuration. The makefile includes a file
which contains the configuration dependent variable definitions.

The makefile is tested with SuSE linux 6.0, GNU make 3.76.1 and compiler
gcc version egcs-2.90.23 980102 (egcs-1.0.1 release)

Mind that you will need a C++ compiler with rather new features like RTTI and
exception handling. Also the STL headers are expected to be installed.

All sources are compiled and linked without warnings with the above mentioned
configuration.

Compile
-------

Choose one of the following configurations:

Debug - the configuration for developing
Debug info, trace facility, assertion testing

Trace - the configuration to produce beta binary releases
No debug info, optimized compilation, trace facility, assertion testing

Release - the configuration to produce final binary releases
No debug info, optimized compilation, no trace facility, no assertion testing

For debug:   cd ~/obj_dbg; make
For trace:   cd ~/obj_trc; make
For release: cd ~/obj_rel; make

Install
-------

After successful compilation you will find the executable targetd64 in the
generation directory. Place this executable somewhere onto the execution path.
Copy .targetd64rc from the distribution directory to your home directory
($HOME) and edit this file if needed. That's all. There are no man pages
(builtin by option -h) or libraries.

Feedback
--------

If you have fixed a bug or extended TargetD64 please pass the changed
sources to me (mailto:klangguth@netscape.net). Please let me know if
you did any kind of configuration (e.g. using the generic archive
interface or adaption to an emulator). I will collect those
configurations and make them available to the public.
A bug report form is available at
http://skyscraper.fortunecity.com/quadra/251/td64bugreport.html.
Feel free to sign my guestbook at
http://skyscraper.fortunecity.com/quadra/251/td64guestbook.html

Copyright notice
----------------

- TargetD64 (c) 1998, 1999 Karlheinz Langguth

- Unlynx, C64zip from VICE

    Copyright  1993-1994, 1997-1999 Teemu Rantanen
    Copyright  1997-1999 Daniel Sladic
    Copyright  1998-1999 Andreas Boose
    Copyright  1998-1999 Tibor Biczo
    Copyright  1993-1996 Jouko Valta
    Copyright  1993-1994 Jarkko Sonninen

VICE homepage: http://www.cs.cmu.edu/~dsladic/vice/vice.html

- Unzip, Gunzip from Zlib

 (C) 1995-1998 Jean-loup Gailly and Mark Adler
 Minizip contribution (c) by Gilles Vollant

Zlib homepage: http://www.cdrom.com/pub/infozip/zlib/zlib.html

- Unlha from Lha(rc) for UNIX
LHarc    for UNIX  V 1.02  Copyright(C) 1989  Y.Tagawa
LHa      for UNIX  V 1.00  Copyright(C) 1992  Masaru Oki

No homepage for LHA

This program 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 program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
