diff --git a/artistic.txt b/artistic.txt new file mode 100644 index 0000000..cd17757 --- /dev/null +++ b/artistic.txt @@ -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 diff --git a/doc/xasm.htm b/doc/xasm.htm index bdf1eed..602708e 100644 --- a/doc/xasm.htm +++ b/doc/xasm.htm @@ -2,7 +2,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -xasm 2.6.1 +xasm 3.0.0 @@ -14,9 +14,9 @@

xasm is a cross-assembler which generates code for the 6502 processor.

source is the name of the source file. If no filename extension -is given, .ASX is appended. The default action (when invoked without +is given, .asx is appended. The default action (when invoked without options) is to assembly source, writing the result to a file with -the .OBX extension.

+the .obx extension.

OPTIONS

/c
@@ -29,14 +29,6 @@ Lines skipped due to a false condition are not listed by default. to labels defined in the source file). You may use several /d options to define many labels from the command line. -
/e
-
Enable setting environment variables pointing at the error location. -With this option, xasm sets two environment variables: -ERRFILE and ERRLINE. -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.
/i
Disable listing included sources. Only main source file will be listed.
@@ -50,7 +42,8 @@ You may use the null device (/o:nul) to generate no object file.
/p
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.
+location only if the full path is given. +This option works only on Windows and is silently ignored on Linux.
/q
Suppress info messages. Prevents xasm from printing its name and the summary (how many lines @@ -63,17 +56,17 @@ to the listing.
Warn of unused labels. A warning message will be issued for each label, whose value is never used.
+

Alternatively, you may use Unix-style options, for example:

+
xasm -i -d DEBUG=1 -l listing.lst source.asx
+

SYNTAX

-

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. xasm is not case-sensitive, so you can mix upper- -and lower-case for labels and instructions.

+

Source files should be plain ASCII files. Supported are LF, CR, CR/LF +and Atari line terminators. xasm is not case-sensitive, so you can mix +upper- and lower-case for labels and instructions.

xasm is backward compatible with Quick Assembler. -If you want to assembly QA sources with xasm, simply convert the text -file to CR/LF terminators and replace ATASCII specific characters with their -integer representation. You also have to change all OPT directives, -but usually you only need to remove them.

+If you want to assembly QA sources with xasm, simply replace ATASCII +specific characters with their integer representation. You also have to change +all OPT directives, but usually you only need to remove them.

A label 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 EQU directive, @@ -345,12 +338,15 @@ Examples of DTA:

Specifies another file to be included in the assembly as if the contents of the referenced file appeared in place of the ICL statement. The included file may contain other ICL statements. -The .ASX extension is added if none given.
+The .asx extension is added if none given.
Examples: 
  icl 'macros.asx'
- icl 'c:\atari\xasm\fileio'
-
+ icl 'lib/fileio' + +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.
END - end assembling file
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

CHANGES

+

Version 3.0.0 (2005-05-22)

+

Version 2.6.1 (2005-05-21)