acme/contrib/toacme/docs/README

83 lines
2.4 KiB
Plaintext
Raw Normal View History

ToACME
...source code file converter for ACME
Copyright
---------
ToACME - a source code converter for the ACME crossassembler
Copyright (C) 1998-2015 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.
Use
---
ToACME can be invoked in two ways:
toacme
toacme <input 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
--------------------------------------------------
ab3 C64: AssBlaster 3.0 to 3.2 good
f8ab C64: Flash8-AssBlaster ok
giga C64: Giga-Assembler needs testing
hypra C64: Hypra-Assembler ok
object object code files poor
Contacting the author
---------------------
If you want to report a bug or make a suggestion, then simply send
an email to marco@baye.de