acme/contrib/toacme/docs/README
marcobaye fcbebf8343 ACME Release 0.95.7: Added pseudo opcodes to output big-endian values
(not really worth a separate release, but I wanted to get the changes
out of my system)
toacme Release 0.13: started work on converter for "Oliver Stiller's
Professional Assembler"


git-svn-id: https://svn.code.sf.net/p/acme-crossass/code-0/trunk@66 4df02467-bbd4-4a76-a152-e7ce94205b78
2016-02-16 23:11:04 +00:00

94 lines
2.9 KiB
Plaintext

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.