mirror of https://github.com/pfusik/xasm.git
xasm 3.0.0 release.
This commit is contained in:
Piotr Fusik
parent
7c81897091
commit
66501ef2fd
|
|
@ -0,0 +1,117 @@
|
|||
|
||||
|
||||
|
||||
|
||||
The "Artistic License"
|
||||
|
||||
Preamble
|
||||
|
||||
The intent of this document is to state the conditions under which a
|
||||
Package may be copied, such that the Copyright Holder maintains some
|
||||
semblance of artistic control over the development of the package,
|
||||
while giving the users of the package the right to use and distribute
|
||||
the Package in a more-or-less customary fashion, plus the right to make
|
||||
reasonable modifications.
|
||||
|
||||
Definitions:
|
||||
|
||||
"Package" refers to the collection of files distributed by the
|
||||
Copyright Holder, and derivatives of that collection of files
|
||||
created through textual modification.
|
||||
|
||||
"Standard Version" refers to such a Package if it has not been
|
||||
modified, or has been modified in accordance with the wishes
|
||||
of the Copyright Holder as specified below.
|
||||
|
||||
"Copyright Holder" is whoever is named in the copyright or
|
||||
copyrights for the package.
|
||||
|
||||
"You" is you, if you're thinking about copying or distributing
|
||||
this Package.
|
||||
|
||||
"Reasonable copying fee" is whatever you can justify on the
|
||||
basis of media cost, duplication charges, time of people involved,
|
||||
and so on. (You will not be required to justify it to the
|
||||
Copyright Holder, but only to the computing community at large
|
||||
as a market that must bear the fee.)
|
||||
|
||||
"Freely Available" means that no fee is charged for the item
|
||||
itself, though there may be fees involved in handling the item.
|
||||
It also means that recipients of the item may redistribute it
|
||||
under the same conditions they received it.
|
||||
|
||||
1. You may make and give away verbatim copies of the source form of the
|
||||
Standard Version of this Package without restriction, provided that you
|
||||
duplicate all of the original copyright notices and associated disclaimers.
|
||||
|
||||
2. You may apply bug fixes, portability fixes and other modifications
|
||||
derived from the Public Domain or from the Copyright Holder. A Package
|
||||
modified in such a way shall still be considered the Standard Version.
|
||||
|
||||
3. You may otherwise modify your copy of this Package in any way, provided
|
||||
that you insert a prominent notice in each changed file stating how and
|
||||
when you changed that file, and provided that you do at least ONE of the
|
||||
following:
|
||||
|
||||
a) place your modifications in the Public Domain or otherwise make them
|
||||
Freely Available, such as by posting said modifications to Usenet or
|
||||
an equivalent medium, or placing the modifications on a major archive
|
||||
site such as uunet.uu.net, or by allowing the Copyright Holder to include
|
||||
your modifications in the Standard Version of the Package.
|
||||
|
||||
b) use the modified Package only within your corporation or organization.
|
||||
|
||||
c) rename any non-standard executables so the names do not conflict
|
||||
with standard executables, which must also be provided, and provide
|
||||
a separate manual page for each non-standard executable that clearly
|
||||
documents how it differs from the Standard Version.
|
||||
|
||||
d) make other distribution arrangements with the Copyright Holder.
|
||||
|
||||
4. You may distribute the programs of this Package in object code or
|
||||
executable form, provided that you do at least ONE of the following:
|
||||
|
||||
a) distribute a Standard Version of the executables and library files,
|
||||
together with instructions (in the manual page or equivalent) on where
|
||||
to get the Standard Version.
|
||||
|
||||
b) accompany the distribution with the machine-readable source of
|
||||
the Package with your modifications.
|
||||
|
||||
c) give non-standard executables non-standard names, and clearly
|
||||
document the differences in manual pages (or equivalent), together
|
||||
with instructions on where to get the Standard Version.
|
||||
|
||||
d) make other distribution arrangements with the Copyright Holder.
|
||||
|
||||
5. You may charge a reasonable copying fee for any distribution of this
|
||||
Package. You may charge any fee you choose for support of this
|
||||
Package. You may not charge a fee for this Package itself. However,
|
||||
you may distribute this Package in aggregate with other (possibly
|
||||
commercial) programs as part of a larger (possibly commercial) software
|
||||
distribution provided that you do not advertise this Package as a
|
||||
product of your own. You may embed this Package's interpreter within
|
||||
an executable of yours (by linking); this shall be construed as a mere
|
||||
form of aggregation, provided that the complete Standard Version of the
|
||||
interpreter is so embedded.
|
||||
|
||||
6. The source code and object code supplied as input to or produced as
|
||||
output from the programs of this Package do not automatically fall
|
||||
under the copyright of this Package, but belong to whoever generated
|
||||
them, and may be sold commercially, and may be aggregated with this
|
||||
Package.
|
||||
|
||||
7. Aggregation of this Package with a commercial distribution is always
|
||||
permitted provided that the use of this Package is embedded; that is,
|
||||
when no overt attempt is made to make this Package's interfaces visible
|
||||
to the end user of the commercial distribution. Such use shall not be
|
||||
construed as a distribution of this Package.
|
||||
|
||||
8. The name of the Copyright Holder may not be used to endorse or promote
|
||||
products derived from this software without specific prior written permission.
|
||||
|
||||
9. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
|
||||
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
|
||||
WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
||||
|
||||
The End
|
||||
60
doc/xasm.htm
60
doc/xasm.htm
|
|
@ -2,7 +2,7 @@
|
|||
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
||||
<head>
|
||||
<title>xasm 2.6.1</title>
|
||||
<title>xasm 3.0.0</title>
|
||||
<meta name="Author" content="Piotr Fusik"/>
|
||||
</head>
|
||||
<body>
|
||||
|
|
@ -14,9 +14,9 @@
|
|||
<p><b>xasm</b> is a cross-assembler which generates code for the 6502
|
||||
processor.</p>
|
||||
<p><tt>source</tt> is the name of the source file. If no filename extension
|
||||
is given, <tt>.ASX</tt> is appended. The default action (when invoked without
|
||||
is given, <tt>.asx</tt> is appended. The default action (when invoked without
|
||||
options) is to assembly <tt>source</tt>, writing the result to a file with
|
||||
the <tt>.OBX</tt> extension.</p>
|
||||
the <tt>.obx</tt> extension.</p>
|
||||
<h2>OPTIONS</h2>
|
||||
<dl>
|
||||
<dt><tt>/c</tt></dt>
|
||||
|
|
@ -29,14 +29,6 @@ Lines skipped due to a false condition are not listed by default.</dd>
|
|||
to labels defined in the source file).
|
||||
You may use several <tt>/d</tt> options to define many labels
|
||||
from the command line.</dd>
|
||||
<dt><a name="new_environment"/><tt>/e</tt></dt>
|
||||
<dd>Enable setting environment variables pointing at the error location.
|
||||
With this option, <b>xasm</b> sets two environment variables:
|
||||
<tt>ERRFILE</tt> and <tt>ERRLINE</tt>.
|
||||
They may be used in a batch file to locate the error and set editor's
|
||||
insertion point on it. If there was no error, the variables point at the last
|
||||
issued warning. If no warning occured, they are removed from
|
||||
the environment.</dd>
|
||||
<dt><tt>/i</tt></dt>
|
||||
<dd>Disable listing included sources. Only main source file will be
|
||||
listed.</dd>
|
||||
|
|
@ -50,7 +42,8 @@ You may use the null device (<tt>/o:nul</tt>) to generate no object file.</dd>
|
|||
<dt><a name="new_fullpaths"/><tt>/p</tt></dt>
|
||||
<dd>Print fully qualified file names in listing and error messages.
|
||||
This option is useful for the Code-Genie editor, which can jump to the error
|
||||
location only if the full path is given.</dd>
|
||||
location only if the full path is given.
|
||||
This option works only on Windows and is silently ignored on Linux.</dd>
|
||||
<dt><a name="new_quiet"/><tt>/q</tt></dt>
|
||||
<dd>Suppress info messages.
|
||||
Prevents <b>xasm</b> from printing its name and the summary (how many lines
|
||||
|
|
@ -63,17 +56,17 @@ to the listing.</dd>
|
|||
<dd>Warn of unused labels. A warning message will be issued for each label,
|
||||
whose value is never used.</dd>
|
||||
</dl>
|
||||
<p>Alternatively, you may use Unix-style options, for example:</p>
|
||||
<pre>xasm -i -d DEBUG=1 -l listing.lst source.asx
|
||||
</pre>
|
||||
<h2>SYNTAX</h2>
|
||||
<p>Source files should be plain ASCII files. Although different line
|
||||
terminators are supported, CR/LF is recommended because it is the standard
|
||||
in the DOS/Windows environment. Lines must be no longer than 256
|
||||
characters. <b>xasm</b> is not case-sensitive, so you can mix upper-
|
||||
and lower-case for labels and instructions.</p>
|
||||
<p>Source files should be plain ASCII files. Supported are LF, CR, CR/LF
|
||||
and Atari line terminators. <b>xasm</b> is not case-sensitive, so you can mix
|
||||
upper- and lower-case for labels and instructions.</p>
|
||||
<p><b>xasm</b> is backward compatible with Quick Assembler.
|
||||
If you want to assembly QA sources with <b>xasm</b>, simply convert the text
|
||||
file to CR/LF terminators and replace ATASCII specific characters with their
|
||||
integer representation. You also have to change all <tt>OPT</tt> directives,
|
||||
but usually you only need to remove them.</p>
|
||||
If you want to assembly QA sources with <b>xasm</b>, simply replace ATASCII
|
||||
specific characters with their integer representation. You also have to change
|
||||
all <tt>OPT</tt> directives, but usually you only need to remove them.</p>
|
||||
<p>A <i>label</i> is a symbol that represents a 32-bit signed integer.
|
||||
You can define a label by putting its name at the beginning of a line
|
||||
(with no spaces before). If you do not use the <tt>EQU</tt> directive,
|
||||
|
|
@ -345,12 +338,15 @@ Examples of <tt>DTA</tt>:
|
|||
<dd>Specifies another file to be included in the assembly as if the contents
|
||||
of the referenced file appeared in place of the <tt>ICL</tt> statement.
|
||||
The included file may contain other <tt>ICL</tt> statements.
|
||||
The <tt>.ASX</tt> extension is added if none given.<br/>
|
||||
The <tt>.asx</tt> extension is added if none given.<br/>
|
||||
Examples:
|
||||
<pre>
|
||||
icl 'macros.asx'
|
||||
icl 'c:\atari\xasm\fileio'
|
||||
</pre></dd>
|
||||
icl 'lib/fileio'
|
||||
</pre>
|
||||
Note: for portability, you should use only relative paths and slash
|
||||
as the separator. This guarantees that your sources will compile under Windows
|
||||
and Linux.</dd>
|
||||
<dt><tt><b>END</b></tt> - end assembling file</dt>
|
||||
<dd>Remaining part of the file is not assembled. If this statement does
|
||||
not occur, the assembler stops assembling when it encounters the end
|
||||
|
|
@ -560,6 +556,19 @@ in all 6502 commands and pseudo-commands, except for
|
|||
cmd (z),0- = ldy #0 : cmd (z),y : dey
|
||||
</pre>
|
||||
<h2>CHANGES</h2>
|
||||
<h3>Version 3.0.0 (2005-05-22)</h3>
|
||||
<ul>
|
||||
<li>rewritten from the x86 assembly language to the
|
||||
<a href="http://www.digitalmars.com/d">D programming language</a>
|
||||
- Linux version is now available and plain DOS is no longer supported</li>
|
||||
<li>no limits for the line length, number of <tt>ICL</tt>s, <tt>ORG</tt>s,
|
||||
<tt>IFT</tt>s and labels</li>
|
||||
<li>Unix-style command-line options are supported:
|
||||
<pre>xasm -i -d DEBUG=1 -l listing.lst source.asx
|
||||
</pre></li>
|
||||
<li><tt>/e</tt> option is no longer supported</li>
|
||||
<li>the label table is now sorted alphabetically</li>
|
||||
</ul>
|
||||
<h3>Version 2.6.1 (2005-05-21)</h3>
|
||||
<ul>
|
||||
<li>no more "Arithmetic overflow" and "Division by zero" errors when correctly
|
||||
|
|
@ -668,8 +677,7 @@ for generating smaller code</a></li>
|
|||
<li>origin setting not required until it is used</li>
|
||||
<li>Unix ($0a), Macintosh ($0d) and Atari ($9b) EOLs allowed in the source</li>
|
||||
<li>value of 'true' changed to 1</li>
|
||||
<li><a href="#new_environment">setting environment variables on error
|
||||
option</a></li>
|
||||
<li>setting environment variables on error option</li>
|
||||
<li>assembling only if source newer than object option</li>
|
||||
<li><a href="#new_opcode">op-code extracting</a></li>
|
||||
<li><a href="#new_linerep">line repeating</a></li>
|
||||
|
|
|
|||
|
|
@ -3,31 +3,30 @@
|
|||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
||||
<head>
|
||||
<title>xasm</title>
|
||||
<meta name="Description" content="xasm is a 6502 cross-assembler for DOS/Windows."/>
|
||||
<meta name="Description" content="xasm is a 6502 cross-assembler for DOS/Windows/Linux."/>
|
||||
<meta name="Keywords" content="xasm,6502,cross-assembler,atari"/>
|
||||
<meta name="Author" content="Piotr Fusik"/>
|
||||
<style type="text/css">
|
||||
body { background-color: #c0f0c0; color: #000000; font-family: Verdana, Arial, Helvetica, sans-serif; }
|
||||
h1 { background-color: #008080; color: #ffffff; padding-left: 10px; }
|
||||
h3 { background-color: #008080; color: #ffffff; padding-left: 10px; }
|
||||
th { background-color: #008080; color: #ffffff; }
|
||||
table { margin-bottom: 12px; }
|
||||
td { background-color: #40a090; color: #ffffff; text-align: left; padding-left: 10px; padding-right: 10px; }
|
||||
td a { color: #ffffff; }
|
||||
hr { color: #008080; height: 5px; }
|
||||
</style>
|
||||
</head>
|
||||
<body style="background-color: #c0ffc0">
|
||||
<body>
|
||||
<h1>xasm.atari.org</h1>
|
||||
<p><b>xasm</b> is a 6502 cross-assembler for DOS/Windows.
|
||||
<p><b>xasm</b> is a 6502 cross-assembler.
|
||||
It is mainly targeted at Atari 8-bit computers,
|
||||
but it can be also used for programming
|
||||
Atari 2600/5200/Lynx, Commodore C64, Apple ][ and others.
|
||||
<b>xasm</b> is freeware.</p>
|
||||
<p><a href="xasm260.zip">Download version 2.6.0
|
||||
(22 KB, includes full documentation)</a></p>
|
||||
<p><b>xasm</b> no longer includes the tools X-BOOT, X-LOAD and X-HEAD.
|
||||
If you really need them,
|
||||
<a href="xasm252.zip">download version 2.5.2 (38 KB)</a>.</p>
|
||||
<h3>Target audience</h3>
|
||||
<p><b>xasm</b> is for people who are fluent in the 6502 assembly language.
|
||||
There is no sample code for beginners, no easy-to-use libraries.
|
||||
You are warned that programming 8-bit machines in the assembly language
|
||||
is a tedious work.</p>
|
||||
<p>There are several 6502 cross-assemblers to choose from and new ones
|
||||
still appear. Just search the web. Make sure to not overlook
|
||||
the <a href="http://www.cc65.org">cc65</a> compiler which includes
|
||||
a cross-assembler, portable across many host and target platforms.</p>
|
||||
<p>Version 3.0.0 is a complete rewrite from the x86 assembly language
|
||||
to the <a href="http://www.digitalmars.com/d">D programming language</a>.
|
||||
<b>xasm</b> is now available for Linux.</p>
|
||||
<h3>Features</h3>
|
||||
<p>Although <b>xasm</b> does not support user-defined macros, it has a rich
|
||||
set of built-in facilities.</p>
|
||||
|
|
@ -71,8 +70,32 @@ do_line
|
|||
<p>Although <b>xasm</b> comes with no editor, the documentation
|
||||
describes integration (syntax highlighting and single-keystroke compilation)
|
||||
with a few general-purpose text editors. Here is a screenshot
|
||||
of the <a href="http://www.code-genie.com">Code-Genie</a> editor:</p>
|
||||
of the Code-Genie editor:</p>
|
||||
<p><img src="cgenie.gif" alt="6502 code in Code-Genie"/></p>
|
||||
<h3>Download</h3>
|
||||
<div style="text-align: center">
|
||||
<table>
|
||||
<tr><th>File</th><th>Size</th><th>Description</th></tr>
|
||||
<tr><td><a href="xasm-3.0.0-win32.zip">xasm-3.0.0-win32.zip</a></td>
|
||||
<td style="text-align: right">98 KB</td><td>xasm 3.0.0 for Windows</td></tr>
|
||||
<tr><td><a href="xasm-3.0.0-linux.tar.gz">xasm-3.0.0-linux.tar.gz</a></td>
|
||||
<td style="text-align: right">128 KB</td><td>xasm 3.0.0 for Linux</td></tr>
|
||||
<tr><td><a href="xasm-3.0.0-src.zip">xasm-3.0.0-src.zip</a></td>
|
||||
<td style="text-align: right">16 KB</td><td>xasm 3.0.0 source code</td></tr>
|
||||
<tr><td><a href="xasm261.zip">xasm261.zip</a></td>
|
||||
<td style="text-align: right">25 KB</td><td>xasm 2.6.1 for DOS/Windows</td></tr>
|
||||
<tr><td><a href="xasm252.zip">xasm252.zip</a></td>
|
||||
<td style="text-align: right">38 KB</td><td>xasm 2.5.2 for DOS/Windows (includes
|
||||
X-BOOT, X-LOAD and X-HEAD)</td></tr>
|
||||
</table>
|
||||
</div>
|
||||
<h3>Links</h3>
|
||||
<ul>
|
||||
<li><a href="http://www.cc65.org">cc65</a></li>
|
||||
<li><a href="http://g2f.atari8.info/mads/">Mad-Assembler</a></li>
|
||||
<li><a href="http://www.npsnet.com/danf/cbm/cross-development.html">6502
|
||||
Cross-Development Languages and Tools List</a></li>
|
||||
</ul>
|
||||
<hr/>
|
||||
<p><i>Hosted by <a href="http://atariarea.histeria.pl">Atari Area</a></i></p>
|
||||
</body>
|
||||
|
|
|
|||
Loading…
Reference in New Issue