
Welcome to a2dev -- The Apple 2 Development Suite!

This software is Copyright (c) 1995 by Archie L. Cobbs,
but is freely distributable under the terms of the GNU
public license -- see the file COPYING for details.
Support free software! You're using it!

WHAT IS THIS?

    This is a suite of programs for developing software
    targeted for 65c02 machines, like the Apple 2 series.
    These programs are included:

        a2asm     -- Assembler
        a2link    -- Linker
        a2load    -- Loader
        a2objx    -- Object file viewer

REQUIREMENTS:

    The GNU version of "make" is required. Also, "Make.defs"
    is setup to use GCC, which everyone should have anyway.
    However, I've tried to make things ANSI portable.

    If you want to change the assembler syntax or parsing,
    you'll need GNU's flex and/or bison, or maybe lex and
    yacc will work (haven't tried it). They are not needed
    for simple installation.

DOCUMENTATION:

    There are man pages, and the "doc" directory contains a
    manual for the assembler.

INSTALLATION:

    To install, just do this:

        1. Become root (if you can't do this, see below).
        2. Type "make install".
        3. Type "make verify".
        4. If the test files don't check out OK, let me know.

    The programs and man pages will go into /usr/local/bin and
    /usr/local/man/man1, respectively. If you want to change this,
    or anything else, change "Make.defs". No change to any of the
    other makefiles should be necessary, maybe on older systems...?

    If you cannot become root, modify Make.defs to change the
    installation directories to something you can write in,
    or else just type "make" instead of "make install".

Enjoy!

-Archie Cobbs (archie@cs.berkeley.edu)

