Z80 Assembly IDE
User Manual

Editor written by Donald Straney,
assembler by Spencer Putt,
app signer by James Montelongo and Spencer Putt
A product of Revolution Software - visit us at www.revsoft.org


1. Introduction

Z80 Assembly IDE is a complete IDE for TI's Z80-based graphing calculators. Features include a tabbed interface, syntax coloring, search-by-label, export formats for every major Z80 calculator (82 and 85 have not been tested), a code counter, powerful macro support, and more. This project started out as an attempt to create a copy of Jeremy Goetsch's Assembly Studio in Linux, but it already has some original features, and the next major version will have more.


2. System Requirements/Installing

See INSTALL for details and installation instructions.

3. Coding features

Assembling a program, creating a symbol table or code listing, or viewing code statistics:

Click the gear icon near the right side of the toolbar to assemble, or open the "Assemble" menu for the other commands (you will have to save the file first if it has unsaved changes).

Jumping to a label:

Select "Go to label" from the "Edit" menu, and enter the name of the label.

Setting the location(s) of include files:

Select "Assembler" from the "Settings" menu. You can specify up to 3 include directories - in
each one, type the directory in the text box or press the browse button.

Configuring the syntax coloring or auto-indent:

Select "Editor" from the "Settings" menu.

Checking the size and execution time of a section of code:

Click the wrench icon on the right side of the toolbar or select "Code counter" from the
"Assemble" menu.

Choosing the type of program to build (83+, 86, etc.):

Select "Output format" from the "Settings" menu. All the major Z80 calculators are supported,
as well as an unprocessed binary output for compression with Lite86 or a similar program, but
the 82 and 85 formats have not been tested.


4. New features

See NEWS for new features in this version, or this thread for planned features in the next version.


5. Known problems

If you replace selected text by typing or pasting, it'll register as two
separate actions and you'll have to press Undo twice to undo it.

If there are missing labels or bad instructions in your program, it will still
show "assembly successful", so make sure to check the output for errors.

Large files (>15000 lines?) may crash the assembler.

Lines that are not macro calls with a parenthesis at the end might not work right:
you can replace "label equ 1+(2*3)" with "label = 1+(2*3)" to work around this.

6. Feedback

If you find any new bugs or have comments/suggestions, please post on the forum for this project at www.revsoft.org.
You can also e-mail me at burntfuse@gmail.com, and I'm sometimes on AIM as burntfuse2 or #revsoft/#tcpa as burntfuse.
Anything about the assembler or Wabbitsign should be posted in the sections for those projects in the forum at www.revsoft.org,
since I'm only responsible for the editor. If you want to report a bug, make sure you give all the information I'll need - bug reports like
"ur program doesn't work u suk" waste my time, since there's no real information to go on, and your time, since you'll have to
answer all my questions in detail. Please give your version of GTK, Linux distribution, glibc version, the exact text of any
error messages, and exactly what you did before the crash/glitch/whatever - for example, "I was editing this file [file attached],
I deleted the first character in line 3, and the program closed." Also, make sure it
isn't one of the known bugs (yeah, this sounds obvious, but some people...).


Anyways, I hope this program is useful to you! See the README for a list of credits.

Donald Straney (burntfuse)