Collection of Hack-Phreak Scene Programs/cleanhpvac.zip/cleanhpvac/SOURCE.ZIP/A86V402.ZIP/A01.DOC

Text File | 1995-09-24 | 17KB | 344 lines

CHAPTER 1   INTRODUCTION AND LEGAL TERMS


Introduction

A86 is the finest assembler available, at any cost under any
terms, for the 86-family of microprocessors (IBM-PC, compatibles,
and not-so-compatibles).  In contrast to software firms who
attempt to restrict the distribution of their products via
protection-schemes, I encourage free distribution, and trust that
those who use my products will pay for them.

Please keep in mind the fundamental good spirit of
free-distribution software as you endure the following barrage of
legalities.  Then evaluate the outstanding value that the A86
package offers you.  I assure you that you will not be
disappointed.


Legal Terms and Conditions

This package is provided to you under the following conditions:

1. You may copy the A86Vxxx.ZIP and D86Vxxx.ZIP files, and give
   them to anyone who accepts these terms.  The copies you
   distribute must be complete and unmodified.  You do not have
   to be registered to distribute this package.

2. Even if you have not yet obtained full execution rights, you
   may execute the programs in this package, in order to evaluate
   them.  If you decide that A86 is of use to you, you must
   become a registered user by sending $50 US, ($52 if you are
   outside North America) to:

      Eric Isaacson
      416 E. University Ave.
      Bloomington, IN 47401-4739

   For your convenience, I now accept Visa, MasterCard and
   American Express, by telephone or mail.  My voice number is
   1-812-339-1811.  My fax number is 1-812-335-1611.

   For the convenience of users in Great Britain, I have
   authorized the firm Atlantic Coast Plc to collect
   registrations for me.  We'll try to keep the prices about the
   same whether you register through me or through them; it's
   your choice.  Their address is The Shareware Village, Colyton,
   Devon EX13 6HA, telephone [phone].  They'll send me a
   list of registered users at the end of every month, and I'll
   send an acknowledgement to each user when I get the list.  So
   if you haven't heard from me by the end of the month following
   your registration with them, please let me know.
                                                              1-2

   Your registration includes the latest diskette (3.5 inch, or
   high-density 5.25 inch), that also includes the A86LIB tool
   available to registered users only.  You may order further
   updates for $10 US, or $12 US if you are overseas.  Once you
   register for this package, you are registered for all future
   versions -- you have permanent rights to execute A86 on one
   computer.  As long as I'm in business, you can get the latest
   version for just the update fee.

   I have a combination offer for the A86 and D86 packages.
   Instead of $50 + $50 = $100, I charge $80 ($82 overseas) for
   both (without the printed manual).  The A86+D86 registered
   disk also includes a preliminary version of A386 and D386.

   I also offer a printed version of this manual, covering both
   A86 and D86. The manual is printed on sheets 8.5 inches high
   and 7 inches wide, with a plastic ring-style binding so the
   book can lay flat.  If you order with your registration the
   manual is an extra $10 to the U.S., $15 overseas. If you've
   already registered and now want the manual, add another $10
   ($12 overseas) for the update disk that the manual is bundled
   with.  There is a limit of one manual per computer registered
   (except you may reorder when there is a substantial revision
   to the manual).

   Indiana residents need to add sales tax.  At the current rate
   of 5%, the prices for Indiana residents are $52.50 for one
   product, $63 one product with manual, $84 both products,
   $94.50 both products with manual, $21 manual if already
   registered.

   Educational institutions and training facilities MUST be
   registered in order to use A86 in courses.  Contact me for
   special terms.

   Companies and government agencies MUST be registered in order
   to use A86 for their work.  Again, contact me for special
   terms.

3. This package may not be sold to anyone.  If the package is
   distributed on a diskette, any fees collected must be
   specified as materials/handling, and may not exceed $10 for
   the diskette.

4. The user is completely responsible for determining the fitness
   or usability of this package.  I will not be liable for any
   damages, of any kind, arising from any failure of any programs
   in this package to perform as expected.
                                                              1-3

5. Only permanent registered users can sell or distribute any
   programs that you have written or modified using this
   assembler.  If you do sell or distribute such programs, you
   must insure that your registered name (company or individual)
   will always be distributed with the program, so that I can
   verify your registration.  Any individual or company found to
   be violating these terms will be liable for triple
   registration fees for every machine they own capable of
   running my assembler (plus any legal and court costs).

   NOTE that the only computers that need to be registered are
   those executing the program A86.COM.  The programs produced by
   A86 are entirely yours-- there are no "run-time royalties".

6. A86 takes advantage of situations in which more than one set
   of opcodes can be generated for the same instruction.  (For
   example, MOV AX,BX can be generated using either an 89 or 8B
   opcode, by reversing fields in the following effective address
   byte.  Both forms are absolutely identical in functionality
   and execution speed.)  A86 adopts an unusual mix of choices in
   such situations.  This creates a code-generation "footprint"
   that occupies no space in your program file, but will enable
   me to tell, and to demonstrate in a court of law, if a
   non-trivial object file has been produced by A86. The
   specification for this "footprint" is sufficiently obscure and
   complicated that it would be impossible to duplicate by
   accident.  I claim exclusive rights to the particular
   "footprint" I have chosen, and prohibit anyone from
   duplicating it.  This has at least two specific implications:

   a. Any assembler that duplicates the "footprint" is mine.  If
      it is not identified as mine and issued under these terms,
      then those who sell or distribute the assembler will be
      subject to prosecution.

   b. Any program marked with the "footprint" has been produced
      by my assembler.  It is subject to condition 5 above.


Registration Benefits

Thank you for enduring the legalities.  They are there to protect
me, and also to convince you that this is my business, from which
I make my living.  I'll now return to a softer sell, to try to
make you want to register for my products.

There is a certain amount of ambiguity about when you're still
evaluating A86, and when you're really using A86 and should
register for it.  Some cases are clear (e.g., you're a school
using A86 to teach a course); but many are not.  In practical
reality, it's up to you to decide: you are "on your honor". Also
in practical reality, most users who ought to register haven't,
yet. For most, it's not dishonesty but merely procrastination.
So I have provided some incentives, to prod you into registering.
                                                              1-4

One incentive is the printed manual, which only registered users
can purchase. I haven't left anything out of the disk version of
the manual, but the printed version is formatted and bound much
more nicely than if you print it yourself.

Another incentive, included if you register both A86 and D86, is
a preliminary test version of A386 and D386.  At this writing,
all instructions though the Pentium are implemented, except
assembly to a 32-bit protected-mode segment (in which you need
override bytes for 16-bit operands instead of 32-bit operands).

Another incentive is the tool A86LIB.COM, that lets you create
libraries of source files, to be automatically searched by A86
whenever your program has undefined symbols.  This means you can
effectively add procedures of arbitrary power and complexity to
A86's language.

Also, when you register you're on my mailing list.  I'll
occasionally send you notices about what I've added to A86 and
D86 since the last notice.  When I bring out new products, you'll
hear about them.

Finally, there are the intangible incentives.  You know you've
done the right thing.  You're letting me know that you appreciate
what I've done.  You're letting the world know that quality
software can succeed when distributed as shareware.


Overview of A86

A86 accepts assembly language source files, and transforms them
directly into either: (1) .COM files executable under MS-DOS,
starting at offset 0100 within a code segment; (2) .OBJ files
suitable for feeding to a linker; or (3) object files starting at
offset 0, suitable for copying to ROMs.  A86 is a full featured,
professional-quality program. I designed A86 to be as closely
compatible to the standard Intel/IBM assembly language as
possible, given that I insisted upon making design and language
enhancements necessary to make A86 the best possible assembler.
Some of A86's most notable features are:

* A86 is blazingly fast-- 4 times as fast as MASM V5.1.  On a
  typical modern computer (486/33 with source files already
  disk-cached) A86 assembles at a rate of over ten thousand lines
  per second.  That's per second.  NOT per minute, per second.
                                                              1-5

* A86 is simple to use.  You can feed it a program containing
  just machine instructions, without the red tape (NAME, ASSUME,
  SEGMENT PARA PUBLIC, PROC, ENDP, END, PUBLIC, EXTRN, etc. etc.)
  necessary with other assemblers.  The output of A86 can be a
  .COM file, ready to execute immediately.  You don't have to go
  through a linker.  Or, if you want to go through a linker, A86
  will produce a correct .OBJ file even if no red tape directives
  are given-- the default settings are compatible with most
  high-level languages.  (If you have programs written for
  another assembler containing the red tape directives, you may
  leave them in: A86 knows about them, and is programmed to act
  upon them when assembling .OBJ files, and ignore them if
  assembling .COM files.)

* In spite of its simplicity, A86 encourages modular programming,
  even in its .COM mode, with separately-developed source files.
  This is because A86 assembles multiple source files in its
  invocation line; and because A86 assembles source files faster
  than other people's linkers can link their object files.  You
  get all the advantages of relocation/linkage systems (building
  up libraries of reliable program modules that you can piece
  together), without the disadvantages (excessive,
  time-and-source-code-wasting, confusing red tape).

* A86 has ample capacity for really large programming projects.
  Its symbol table capacity is approximately 3000 10-letter
  symbols, plus room for 15K bytes of compressed macro definition
  text.  (10 letters is an average symbol length; A86 recognizes
  up to 127 letters in a symbol.) Plus, A86's generic local label
  facility effectively doubles your symbol table capacity.

* A86 has language extension features that, once you start using,
  you'll never want to do without.  These include multiple
  operands to PUSH and POP; conditional returns; MOV from one
  segment register to another; assembly time assertion checking;
  based structures; and IF (flag) (statement).

* A86's macro processor is the best, achieving an optimal balance
  between ease of use and raw power.  Its looping and text
  concatenation abilities let you define sophisticated macros,
  whose calls look just like the machine instructions that
  surround them; without the clumsy invocation syntax required by
  other macro processors of A86's power.

* A86 provides clear, English error messages, given right at the
  point in the source code where A86 detected the error.  The
  messages are actually inserted into your source file, where you
  can read them and correct your code at the same time.  You can
  remove the messages yourself, or A86 will remove them for you
  when it reassembles the file.  (Fear not: your original source
  is preserved in x.OLD if you want it.  Or you can disable this
  feature and send error messages to a .ERR file.)
                                                              1-6

* A86 provides a full complement of assembly time expression
  arithmetic operators, compatible with Intel/IBM assemblers. A86
  also provides 4-function floating point arithmetic in assembly
  time expressions used for floating point initializations (an
  A86-exclusive feature).

* A86 assembles the floating point instruction set of the
  8087/287/387/IIT coprocessors, and the extended instruction set
  of the 186/286/NEC series, including the NEC-unique
  instructions.  The 386 version, A386, assembles all the new
  386/486/Pentium instructions.

* A86 has a built-in source file library feature.  Any undefined
  procedures or macros in your program are automatically searched
  for in a special library file A86.LIB, and the associated
  source files are automatically assembled.  This makes access to
  library routines as effortless as it is in the "C" programming
  language.  A sample A86.LIB file is included in the shareware
  version of the package.  Only registered users should have the
  tool A86LIB, with which you can create your own library files.

* A86 has a powerful listing facility, allowing you complete
  flexibility over the format of your listings, and including an
  extremely sophisticated algorithm for automatically generating
  page breaks at sensible places.

* A86 works with an associated symbolic debugger, D86, to make
  the finest development environment available for the PC.  See
  the D86 package for the details of its features.


About the Author

I am a full-time shareware author.  I have worked with Intel
microprocessors since the early days of the 8080.  As an employee
of Intel, I was a part of the two-man team that implemented the
first ASM86 assembler. Having worked with all the processors of
the 86 family from the beginning, I know as much as anyone about
their machine-language architecture.

A86 and D86 themselves are extremely mature, solid programs.
They have been in existence since 1984, running first under my
own, proprietary operating system; then later under the Xenix
operating system on Altos computers, used by myself and my
clients.  I have been making a decent living from my products for
some time now, and with your much-appreciated support, I will
continue to improve my products, and enhance them with new,
related offerings.
                                                              1-7

How to Contact Me

I have no plans to move from my present location at least through
the millennium.  So you can write to:

    Eric Isaacson Software
    416 East University Ave.
    Bloomington, IN 47401-4739

or call 1-812-339-1811 voice, or 1-812-335-1611 fax.

Sorry, I can't guarantee to return everybody's long distance
calls.  If you'd like to be SURE I'll get back to you, please
invite me to call you back collect, or tell me to charge the cost
of the call to your credit card.

I also have a section on Compuserve: just type GO ZIPKEY to any !
prompt.  (ZIPKEY is the name of my other product line, a pop-up
zipcode directory.)  My Internet address is
[e-mail].

If you have extraordinary difficulty contacting me, write the ASP
Ombudsman, 545 Grover Road, Muskegon, MI 49442-9427.  He'll also
try to mediate any business problems people might have with
shareware authors or distributors.

PLEASE contact me if you find bugs in my programs; I'll fix them!
I accept bug reports from anyone, registered or non-registered,
no questions asked.  It's very frustrating to hear about people
telling each other about bugs, and not telling me.  I still await
Greg Wettstein's bug list.