acme/contrib/toacme/docs/README

                                ToACME

                ...source code file converter for ACME


Copyright
---------

ToACME - a source code converter for the ACME crossassembler
Copyright (C) 1998-2016 Marco Baye

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.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330,
Boston, MA  02111-1307  USA


Introduction
------------

ToACME is a file converter for the ACME crossassembler. It is meant to
be a helpful tool for people switching from using another assembler to
using ACME. In such cases, ToACME can be used to convert the source
code files to ACME format.


Syntax and use
--------------

./toacme  FORMAT_ID  INPUT_FILE  OUTPUT_FILE

Calling ToACME without any arguments will show a short message
containing copyright information and a list of all known input
formats.

If called with three arguments, ToACME will interpret the first one
as the format ID. It will then try to convert the input file,
writing the result to the output file.

Please keep in mind that this program cannot cope with *all*
features other assemblers may use. So after having converted your
sources, don't delete the original ones!

Make sure the conversion worked by assembling the new sources using
ACME and then comparing the resulting binaries with the ones your
previous assembler produced.


Known input formats
-------------------

Currently, ToACME supports these input file formats:

Format ID:  source file format             quality
--------------------------------------------------
object      object code files                 poor
hypra       C64: Hypra-Assembler                ok
giga        C64: Giga-Assembler                 ok
vis         C64: VisAss                   untested
ab3         C64: AssBlaster 3.0 to 3.2        good
f8ab        C64: Flash8-AssBlaster              ok
prof        C64: Professional Assembler       poor (work in progress)


Contacting the author
---------------------

The newest version can be found at the ACME homepage:
http://sourceforge.net/projects/acme-crossass/

If you want to report a bug or make a suggestion, then simply send
an email to marco@baye.de


Credits
-------

Thanks to Stefan Hübner for fixing the AssBlaster macro conversion code.
Thanks to Andreas Paul for helping with the Giga-Assembler mode.
Thanks to Arndt Dettke for helping with the Hypra-Assembler mode.
Thanks to Hoogo for helping with the Professional Assembler mode.