home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / ASMUTL / 8088D.ZIP / HELP.DOC < prev    next >
Encoding:
Text File  |  1987-01-05  |  23.2 KB  |  375 lines

  1. ╔════════════════════════════════════════════════════════╗
  2. ║ MicroCom Systems, copyright 1986, all rights reserved. ║
  3. ╠════════════════════════════════════════════════════════╩════════════════════╗
  4. ║ LANGUAGE-3a,b  A86 8088/8086 ver 2.18 advanced macro assembler and debugger.║
  5. ╠═════════════════════════════════════════════════════════════════════════════╣
  6. ║                      LANG-3a:  A86 assembler, disk 1 of 2.                  ║
  7. ║                                                                             ║
  8. ║ A86      COM  14848  Fabulous 8086/8088 macro assembler.                    ║
  9. ║ EXMAC    COM   3130    Macro expansion program for macro debugging.         ║
  10. ║ XREF     COM   4897    Cross reference program, creates from symbol table.  ║
  11. ║ ERDEMO   BAT     39    Demo of what happens when A86 encounters an error.   ║
  12. ║ LISTDOCS BAT    520    Prints all documentation.                            ║
  13. ║ MAKREV   BAT     21    Assembles the REV.8 and linked ZLINES.8 programs.    ║
  14. ║ MTCOLS   BAT     34    Assemble TCOLS.8 and use XREF to create a cross ref. ║
  15. ║ AREAD_ME DOC  12278    A86 introduction, overview, and what to read next.   ║
  16. ║ COMPAT   DOC   9474    Discussion of compatibility issues.                  ║
  17. ║ COND     DOC   8747    Description of conditional assembly features.        ║
  18. ║ CONTENTS DOC   3826    Description of the A86 macro assembler doc files.    ║
  19. ║ DEMO     DOC   5067    Demo documentation of A86, XREF, and EXMAC.          ║
  20. ║ D_INIT   DOC   4745    Description of data allocation directives.           ║
  21. ║ EFFADDR  DOC  12600    Documentation of assembly lang. effective addresses. ║
  22. ║ EQU      DOC   4866    Description of the NIL prefix and EQU directive.     ║
  23. ║ EXCLUSIV DOC   7283    Documentation of unique A86 features.                ║
  24. ║ EXMAC    DOC   1612    Description of EXMAC macro expansion tool.           ║
  25. ║ EXPR     DOC  16456    Overview of expressions permitted by A86.            ║
  26. ║ FLOAT    DOC  14706    Description of floating point support.               ║
  27. ║ FWD_REF  DOC   2127    Description of forward reference handling.           ║
  28. ║ INSTR    DOC  24653    Summary of 8086/8088 instruction set.                ║
  29. ║ INVOKE   DOC   5703    Documentation on invoking the A86 program.           ║
  30. ║ LIST     DOC   4083    Description of listings using A86.                   ║
  31. ║ MACRO    DOC  17017    Description of the A86 Macro programming features.   ║
  32. ║ ORG      DOC   2883    Description of the ORG and EVEN assembly directives. ║
  33. ║ PRIMER   DOC  10337    Documentation on A86 and macro assembly language.    ║
  34. ║ PROC_LAB DOC   3561    Description of PROC, ENDP, and LABEL directives.     ║
  35. ║ REQUIRE  DOC   1066    Description of system requirements for A86.          ║
  36. ║ RESERVED DOC   9180    Summary of reserved symbols in A86. assembly lang.   ║
  37. ║ SEGMENTS DOC   2442    Documentation of segments in A86 and 8086/8088.      ║
  38. ║ STRUC    DOC   1318    Description of the STRUC directive.                  ║
  39. ║ XREF     DOC   4787    Description of XREF cross reference facility.        ║
  40. ║ PAGE     OLD    871    Old version of the following program.                ║
  41. ║ PAGE     8      901    Sample program writes page eject to PRN.             ║
  42. ║ REV      8     3789    Sample program reverses standard input strings.      ║
  43. ║ TCOLS    8    18299    Sample program formats single column input.          ║
  44. ║ ZLINES   8     3968    Sample program buffers lines and write them out.     ║
  45. ╠═════════════════════════════════════════════════════════════════════════════╣                                                                      ║
  46. ║                      LANG-3b:  D86 debugger, disk 2 of 2.                   ║
  47. ║                                                                             ║
  48. ║ D86      COM  10029  Preliminary test copy of the impressive D86 debugger.  ║
  49. ║ D86CHECK COM    650    Program to check certain DOS parameters in effect.   ║
  50. ║ HEXOUT   COM     83    A86 assembled HEXOUT.8 program.                      ║
  51. ║ A86      COM  14848    A copy of the assembler for this disk.               ║
  52. ║ D86LIST  BAT    173    Print all D86 documentation files.                   ║
  53. ║ AREAD_ME DOC  13214    D86 introduction, overview, and what to read next.   ║
  54. ║ COMMANDS DOC   6185    Summary of the D86 command language.                 ║
  55. ║ CONTENTS DOC   1156    Description of the D86 debugger documentation files. ║
  56. ║ DEMO     DOC  11822    Demonstration of a D86 seesion using the HEXOUT prog.║
  57. ║ MAIN     DOC  10780    Documentation on invoking the D86 debugger.          ║
  58. ║ MEMORY   DOC  16753    Description of D86 memory window display features.   ║
  59. ║ REQUIRE  DOC    773    Documentation of the system requirements for D86.    ║
  60. ║ TROUBLE  DOC   5797    What to do if D86 does not work on your system.      ║
  61. ║ HEXOUT   8     3513    Sample program converts hexidecimal to binary.       ║
  62. ╚═════════════════════════════════════════════════════════════════════════════╝
  63.  
  64. ┌──────────────┬──────────────┐
  65. │ A86      COM │ COMPAT   DOC ├──────────────┬──────────────┬──────────────┐
  66. │ EXMAC    COM │ COND     DOC │ EXMAC    DOC │ MACRO    DOC │ STRUC    DOC │
  67. │ XREF     COM │ CONTENTS DOC │ EXPR     DOC │ ORG      DOC │ XREF     DOC │
  68. │ ERDEMO   BAT │ DEMO     DOC │ FLOAT    DOC │ PRIMER   DOC │ PAGE     OLD │
  69. │ LISTDOCS BAT │ D_INIT   DOC │ FWD_REF  DOC │ PROC_LAB DOC │ PAGE     8   │
  70. │ MAKREV   BAT │ EFFADDR  DOC │ INSTR    DOC │ REQUIRE  DOC │ REV      8   │
  71. │ MTCOLS   BAT │ EQU      DOC │ INVOKE   DOC │ RESERVED DOC │ TCOLS    8   │
  72. │ AREAD_ME DOC │ EXCLUSIV DOC │ LIST     DOC │ SEGMENTS DOC │ ZLINES   8   │
  73. ├──────────────┴──────────────┴──────────────┴──────────────┴──────────────┴──┐
  74. │ Hardware:  No special requirements.                                         │
  75. │ Software:  Dos 2.0 or later.                                                │
  76. │ To start:  Enter "A86" followed by the name of a file to be executed.       │
  77. │ To end:    Hit <Ctrl>C to interupt prematurely.                             │
  78. │ For help:  Read all .DOC files.                                             │
  79. │ Author:    Eric Isaacson, 416 E. University Street, Bloomington, IN 47401.  │
  80. │ Reg. fee:  $40.                                                             │
  81. ├─────────────────────────────────────────────────────────────────────────────┤
  82. │     A86 is the finest assembler, user-supported or not, available for the   │
  83. │ PC--paraphrasal of the author's own words.  While this may sound perhaps a  │
  84. │ little ambitious, after a short period of time learning this program, you   │
  85. │ will at the very least be very impressed with its features and its speed.   │
  86. │     A86 accepts assembly-language source files, and transforms them         │
  87. │ directly into either: (1) .COM files executable under MS-DOS, starting at   │
  88. │ offset 0100 within a code segment; or (2) object files starting at offset   │
  89. │ 0, suitable for copying to ROMs.  A86 is a full-featured,                   │
  90. │ professional-quality program.  A86 was designed to be close to the          │
  91. │ Intel/IBM assembly language standard except where language enhancements     │
  92. │ were made.                                                                  │
  93. │     Some of A86's unique features are: Its speed (several hundred lines per │
  94. │ second), its simplicity (because a linker is not necessary, A86 directly    │
  95. │ produces an executable .COM file), its ability to assemble large programs   │
  96. │ (the symbol table has room for 1500 entries and there is room for 8000      │
  97. │ bytes of compressed macro definitions), language extensions (PUSH, POP,     │
  98. │ conditional returns, and more), a very sophisticated macro facility, direct │
  99. │ insertion of error messages into the source file, support for some of the   │
  100. │ 80186, 80286, and NEC processor instructions, and the support of the D86    │
  101. │ symbolic debugger.                                                          │
  102. │     With its newest release, A86 has added support for floating point       │
  103. │ instructions, support for some of the extended instructions available on    │
  104. │ the 80186, 80286, and NEC processors.                                       │
  105. │     On the flip side, some of A86's enhancements which are not yet          │
  106. │ implemented are: support for the protected operating system instructions of │
  107. │ the 80286 processor, creation of .OBJ files which can to programs written   │
  108. │ in other languages.                                                         │
  109. └─────────────────────────────────────────────────────────────────────────────┘
  110.  
  111. ┌──────────────┬──────────────┬──────────────┐
  112. │ D86      COM │ D86LIST  BAT │ CONTENTS DOC ├──────────────┬──────────────┐
  113. │ D86CHECK COM │ AREAD_ME DOC │ DEMO     DOC │ MEMORY   DOC │ TROUBLE  DOC │
  114. │ HEXOUT   COM │ COMMANDS DOC │ MAIN     DOC │ REQUIRE  DOC │ HEXOUT   8   │
  115. ├──────────────┴──────────────┴──────────────┴──────────────┴──────────────┴──┐
  116. │ Hardware:  No special requirements.                                         │
  117. │ Software:  Dos 2.0 or later, and the A86 macro assembler.                   │
  118. │ To start:  Enter "D86" followed by the name of an object file.              │
  119. │ To end:    Hit "Q" or <Esc>.                                                │
  120. │ For help:  Read all *.DOC files.                                            │
  121. │ Author:    Eric Isaacson, 416 E. University Street, Bloomington, IN 47401.  │
  122. │ Reg. fee:  $40.                                                             │
  123. ├─────────────────────────────────────────────────────────────────────────────┤
  124. │     D86 is a preliminary test copy release of a debugger.  It is a symbolic │
  125. │ debugger and will work with the symbolic output of the A86 assembler.  As   │
  126. │ you would expect from a symbolic debugger, you can refer to variables and   │
  127. │ memory locations by the names you assigned them in your original A86        │
  128. │ assembly language program.                                                  │
  129. │     D86 is a powerful debugger with such features as: registers and flags   │
  130. │ are automatically shown on the screen, a symbolic disassembly of the        │
  131. │ current instructions around the location which you stop at, a display of    │
  132. │ the top elements of the machine stack is shown automatically, windows in    │
  133. │ memory can be set showing you the current values at the specified locations │
  134. │ constantly, on-line help explaining the debugger commands, easy stepping    │
  135. │ one instruction forward at a time, immediate execution of A86 assembly      │
  136. │ language instructions, and much more!                                       │
  137. │     On the flip side of D86 is the fact that this is a very preliminary     │
  138. │ release of this program and some of the planned features which are not yet  │
  139. │ implemented are: thorough testing of the full-screen interface on many      │
  140. │ different machines, allowing for A86 to be in another directory, operating  │
  141. │ on .EXE files (currently D86 only works with .COM files), display of the    │
  142. │ floating-point stack, improved status and error reporting, recording and    │
  143. │ playback of keyboard scripts, complex memory searches, invoking a secondary │
  144. │ command processor, improved stepping and trapping abilities and more.       │
  145. └─────────────────────────────────────────────────────────────────────────────┘
  146.  
  147. ╔════════════════╗
  148. ║MICROCOM SYSTEMS║
  149. ╚════════════════╝
  150. MicroCom Systems distributes Public Domain and User-Supported (PD&US) software
  151. for the IBM PC/XT/AT and compatible computers.  Our software charter specifies
  152. that we search for the best available PD&US software and distribute it for a
  153. nominal charge.  We understand that there are literally hundreds of megabytes
  154. of PD&US software in existence and it is our goal to distribute only the best,
  155. which constitutes only a small fraction of all PD&US software.  Our prices are
  156. also a reflection of the fact that we are a service oriented group.
  157.  
  158. In addition to offering only the best of what is available, we DO NOT offer
  159. lots of redundant programs, which other public domain software groups tend to
  160. do.  We try to provide the service of distributing only the best program
  161. available for a particular need, rather than every program on the market that
  162. meets that need.  For example, we sell only ONE variable size ram-disk (the
  163. best one) whereas some of the other groups sell more than TEN of them!
  164.  
  165. ╔════════════════════════════════════════╗
  166. ║CURRENT OFFERINGS AS OF NOVEMBER 2, 1986║
  167. ╚════════════════════════════════════════╝
  168.  BUSINESS 1 ..... EZ-Forms form generation, completion and printing program.
  169.  CAD 1 .......... Object oriented 4-color drawing prog, many features! Clr Rqd.
  170.  CAD 2 .......... Dancad3d, advanced 3d/2d drafting program.  Color required.
  171.  COMM 1a,1b ..... The ever-popular QMODEM 2.3 windowing modem program.
  172.                   (Two disks.  The cost is double that of a single disk!)
  173.  COMM 2a,2b ..... PROCOMM 2.42, an outstanding modem prog w/terminal emulation.
  174.                   (Two disks.  The cost is double that of a single disk!)
  175.  COMM 3 ......... Compression/decompression, archival utils for communications.
  176.  COMM 4abcde .... RBBS 14.1d bulletin board system for the sysops among us.
  177.                   (Five disks.  The cost is 5 times that of a single disk!)
  178.  DATABASE 1a,1b . PC File III, version 4 user friendly database system.
  179.                   (Two disks.  The cost is double that of a single disk!)
  180.  DATABASE 3 ..... pBASE, a powerful relational db manager with query language.
  181.  EDUCATION 1 .... Interactive DOS tutorial.  Makes learning DOS painless.
  182.  FINANCE 1a,1b .. The powerful PC-Accountant, and a nice checkbook balancer.
  183.                   (Two disks.  The cost is double that of a single disk!)
  184.  FINANCE 3 ...... PC spreadsheet program, much like VisiCalc!
  185.  FINANCE 4 ...... Accutax 86, includes schedules/forms for 1985 Federal taxes.
  186.  GAMES 1 ........ Chess, 3-D packman, Flightmare, Kong and more!  Color req.
  187.  GAMES 2 ........ Monopoly, Qubert, Pango, Centipede, and more!  Color req.
  188.  GAMES 3 ........ Blackjack, Arm-chair Quarterback, Empire, and more!
  189.  GAMES 4 ........ Startrek, the original colossal caves Adventure, and Castle!
  190.  GAMES 5 ........ The amazing HACK adventure from the universities.  Large!
  191.  GAMES 6 ........ Packman, Othello, Pinball, Dragons and more!  Color req.
  192.  INFO 1a,1b ..... PC-Recipe cooking database with keyword retrieval.
  193.                   (Two disks.  The cost is double that of a single disk!)
  194.  LANGUAGE 1 ..... PDProlog 1.91a, 5th generation lang for Artificial Intellig.
  195.  LANGUAGE 2 ..... A small C language compiler and interpreter!
  196.  LANGUAGE 3 ..... A86, a full featured 8086/8088 macro assembler and debugger.
  197.  LANGUAGE 4 ..... 370 assembly language assembler, linker and 370 emulator.
  198.  LANGUAGE 5 ..... Turbo Pascal utilities including interactive debugger.
  199.  LANGUAGE 6 ..... Complete 17 lesson Turbo Pascal tutorial w/sample programs.
  200.  LANGUAGE 7 ..... Visible Pascal, pascal compiler and interpreter!
  201.  LANGUAGE 8 ..... Xlisp 1.7, the standard for Artificial Intelligence langs.
  202.  LANGUAGE 9 ..... The ICON string and structure oriented programming language.
  203.  MUSIC 1 ........ Many clever tunes, and an exc. color graphics music editor.
  204.  MUSIC 2a,2b .... PianoMan 3.0 polyphonic music recording and playback program.
  205.  ORGANIZER 1 .... Sidekick-like DESKMATE and JUDY, your personal PC secretary.
  206.  ORGANIZER 2 .... Complete project manager utilizing the critical path method.
  207.  ORGANIZER 3 .... Full resident outline editor includes level hiding!
  208.  ORGANIZER 4 .... Disk cataloger, for keeping track of all your programs.
  209.  PICTURES 1 ..... From Darth Vader to Snoopy, printer and screen graphics.
  210.  PICTURES 2 ..... High res digitized graphics and pictures.  Color required.
  211.  PINUP 1 ........ Provocative printer-graphics pinups for your computer room.
  212.  PINUP 2 ........ Provocative high res. digitized pictures.  Color required.
  213.  PRINTER 1 ...... The complete printer kit:  spooler, banner, and much more!
  214.  PRINTER 2 ...... Near Letter Quality print for your Epson compatible printer.
  215.  SHELL 1 ........ Still River Shell, the best all-around DOS shell program.
  216.  SHELL 2 ........ Unix-type programs, includes a C-Shell, EMACS, WC and more.
  217.  SHELL 3 ........ CP/M 2.2 emulator, includes full Zilog Z80 emulator.
  218.  SIMULATION 1 ... The best LIFE bacteria simul., mazes, stars.  Color required.
  219.  SIMULATION 2 ... Spectacular MandelBrot set graphics images.  Color required.
  220.  UTILITIES 1 .... Absolute best general purpose utils.  An absolute must!
  221.  UTILITIES 2 .... More of the best general purpose utils.  More musts!
  222.  UTILITIES 3 .... Debugging utils for memory resident programs, checkout etc.
  223.  UTILITIES 4 .... The Ultra-File utilities for tooling around your disks.
  224.  UTILITIES 5 .... Sophisticated hard disk utilities.
  225.  WORD 1a,1b ..... The acclaimed PC-WRITE word processor, built-in mail merge!
  226.                   (Two disks.  The cost is double that of a single disk!)
  227.  WORD 2 ......... SCRIPT, the popular text formatter comes to the PC!
  228.  WORD 3 ......... PC-STYLE analyzes your writing style to help you improve it.
  229.  WORD 4 ......... The Speller spell-checker.  Included customizable dictionary.
  230.  
  231. The content and availability of the above disks is subject to change without
  232. notice.  For a current listing and order form, please send us a self-addressed
  233. stamped envelope to the address on the following order form.
  234.  
  235. ╔═════════════╗
  236. ║COMPATIBILITY║
  237. ╚═════════════╝
  238. The programs we distribute generally require PC-DOS versions 2.0 or later
  239. (including 2.1, 3.0, 3.1, and 3.2)  A few programs may not work on some
  240. compatibles. The basic programs distributed require IBM BASIC or BASICA, but
  241. in most cases are compatible with GWBASIC, and Compaq's BASICA.
  242.  
  243. ╔════════════════╗
  244. ║BEFORE YOU BEGIN║
  245. ╚════════════════╝
  246. This distribution diskette may or may not have been physically write protected.
  247. In any case, files should be copied to a work disk before use.  In some cases,
  248. it may not be possible to successfully execute programs without copying the
  249. relevant files to a non-write protected work disk with sufficient space.
  250.  
  251. ╔══════════════╗
  252. ║USING PROGRAMS║
  253. ╚══════════════╝
  254. For a summary of the programs on a diskette, read the file HELP.DOC.
  255. HELP.DOC contains a one line summary section for all programs on the disk.
  256. Many programs will come with a separate documentation file with extension
  257. ".DOC".  These documentation files should prove quite helpful in learning how
  258. to use the programs.  To execute a program with the specified extension:
  259.  
  260.      EXTENSION        COMMAND
  261.      ─────────        ───────
  262.      EXE              Type the program name leaving off the extension.
  263.      COM              Type the program name leaving off the extension.
  264.      BAS              Type BASICA followed by the program name.
  265.  
  266. The programs distributed may be in subdirectories.  To access a program in a
  267. subdirectory, execute the DOS command "CHDIR (directory name)".  This will then
  268. make the specified directory the current one and the programs in it will be
  269. directly accessible.
  270.  
  271. ╔═══════════════════╗
  272. ║RESTRICTIONS ON USE║
  273. ╚═══════════════════╝
  274. Except for the following files, all files contained on this disk are either in
  275. the public domain or are user-supported software.  User-supported software is
  276. copyrighted and subject to restricted use as per author specifications.  Some
  277. user-supported software may require non-voluntary contributions.  Please
  278. remember that the abundance of good useful user supported software is due to
  279. talented programmers spending alot of their free time writing software and that
  280. any contribution you make helps promote the writing of more such software.  To
  281. the best of our knowledge we distribute only programs for which distribution is
  282. permitted or for which we have received explicit permission from the author or
  283. copyright holder.
  284.  
  285. This file is copyrighted and permission is granted to make copies only for
  286. personal use (this precludes distribution in any form, including placing on
  287. bulletin boards, selling, et cetera).  Additionally the arrangement of programs
  288. on this disk, and the naming/numbering and compilation organization of the
  289. MicroCom Collection (TM) is copyrighted.
  290.  
  291. ╔════════╗
  292. ║ORDERING║
  293. ╚════════╝
  294. Print out this file and use the following order form:
  295.                                 THE VERY BEST
  296.                   PUBLIC DOMAIN AND USER SUPPORTED SOFTWARE
  297.                                MICROCOM SYSTEMS
  298.                           IBM-PC SOFTWARE ORDER FORM
  299.  
  300.  
  301. Please specify the disk names in the spaces provided below.  If more than 15
  302. disks are desired please specify on a separate sheet of paper.
  303.  
  304.  (1) ____________________  (6) ____________________ (11) ____________________
  305.  
  306.  (2) ____________________  (7) ____________________ (12) ____________________
  307.  
  308.  (3) ____________________  (8) ____________________ (13) ____________________
  309.  
  310.  (4) ____________________  (9) ____________________ (14) ____________________
  311.  
  312.  (5) ____________________ (10) ____________________ (15) ____________________
  313.  
  314. Prices:
  315.   Disks $3.50 each, less than 10
  316.         $3.00 each, 10 or more
  317.   For 3.5" format, add $1.00 per disk.
  318.  
  319. Number of disks       _____
  320.  
  321.   times cost/disk   x _____
  322.  
  323. Total disk cost               _______
  324.  
  325. If catalog desired, $2.00     _______
  326.                                           Shipping address:
  327. California residents add 7%
  328.   sales tax.                  _______     _____________________________________
  329.  
  330. Ship/handling $1.00 domestic, _______     _____________________________________
  331.               $5.00 foreign
  332.               (always reqd.)              _____________________________________
  333. TOTAL                         _______
  334.   make checks payable                     _____________________________________
  335.   to:  MicroCom Systems
  336.  
  337. Visa/MasterCard orders:
  338.  
  339. Card Number ______-______-______-______   Expiration date ___/___
  340.  
  341. Phone Number (_____) _____-______    Authorized Signature _____________________
  342.  
  343.  
  344.                        Please send this order form to:
  345.  
  346.                             Public Domain Software
  347.                                MicroCom Systems
  348.                                 P.O.Box 51657
  349.                              Palo Alto, CA 94303
  350.                                (415) 325-6500
  351. ╔════════╗
  352. ║WARRANTY║
  353. ╚════════╝
  354. All disks are warranted to be readable.  MicroCom Systems hereby disclaims all
  355. other express and implied warranties for this software, including the
  356. warranties of merchantability and fitness for a particular purpose.  The
  357. program index is not warranted to be completely accurate.  In no event will
  358. MicroCom Systems be liable for any damages, including any lost profits, lost
  359. savings or other incidental or consequential damages arising out of the use of
  360. or inability to use such software.  Should any of your disks be unreadable,
  361. please return the suspect disk(s) to us and we will send a new copy of the disk.
  362.  
  363. ╔═══════════════════════════════════╗
  364. ║SOFWARE SUBMISSION/USER SUGGESTIONS║
  365. ╚═══════════════════════════════════╝
  366. While we are always trying to distribute the latest releases of programs we
  367. welcome the submission of new releases of programs and of programs which we do
  368. not carry for our evaluation.  Also reviews of programs which you have tried
  369. or suggestions as to how we can better serve you in the future would be very
  370. much appreciated.  Thank you.
  371.  
  372. MicroCom Systems, Copyright 1986.  All rights reserved.
  373.