home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / ASMUTL / A86_D86.ZIP / READ.ME < prev    next >
Encoding:
Text File  |  1988-08-03  |  5.2 KB  |  117 lines
  1. This entire diskette is Copyright 1986,1987,1988 Eric Isaacson.
  2. All rights reserved.
  3. See the individual packages for permissions/restrictions.
  4.  
  5. This diskette contains new releases for the A86 assembler and 
  6. D86 debugger.  Everything except the file REG_ONLY.ARC (if you 
  7. have it) can be copied and distributed.  Please upload the other 
  8. ARC files to bulletin boards, and give them to user groups, 
  9. computer departments in schools, and anyone else you think might 
  10. be interested in an assembler or a debugger package for the IBM-
  11. PC. 
  12.  
  13. REG_ONLY.ARC is the file containing materials available only to 
  14. registered users.  If you don't see it on this disk, you need to 
  15. register to get it.  If you do see it, it is for your use only.  
  16. You may NOT distribute it.  Please support my products by 
  17. honoring this restriction. 
  18.  
  19.  
  20. What's New
  21.  
  22. Versions 3.19, 3.18, and 3.17 of A86 have minor bug and
  23. compatibility fixes.
  24.  
  25. Version 3.15 of A86 adds the generation of multiple-instruction 
  26. sequences for MOV or XCHG with two memory-word operands, and 
  27. XCHG of a segment register with another segment register, a 
  28. general word register, or a memory word.  Also A86 now accepts 
  29. an up-arrow symbol in place of an equals sign in invocation 
  30. equates-- this allows such equates to be placed into the A86 
  31. environment variable. 
  32.  
  33. Version 3.14 of A86 and D86 contain bug fixes.
  34.  
  35. Version 3.13 of A86 has more flexible memory management, so it 
  36. can run with less memory (at a reduced capacity in such 
  37. systems).  I also introduced a small compatibility feature for 
  38. Turbo C: forward references with segment overrides are assumed 
  39. to be variables, not immediate constants.  This eliminated the 
  40. need for the EXTRN embedded-blanks kluge offered in V3.12, so I 
  41. eliminated that kluge.  There was also a bug in FAKE that caused 
  42. A86 to fail to find its A86 environment variable: I fixed that. 
  43.  
  44. Version 3.12 of the A86 assembler has numerous bug fixes, and
  45. enhancements to the macro/conditional assembly facility, to
  46. subsume all of MASM's capabilities.  A86 now allows an arbitrary 
  47. expression to appear in a conditional assembly (#IF) directive.
  48. There are also the new macro operands #V value, #S size, #N 
  49. number, #EX exit, string comparisons, and large operand numbers.
  50.  
  51. Version 3.18 of the D86 debugger adds, for registered users
  52. only, a MAPD86 tool to convert the linker's MAP files into
  53. SYM files for D86.  This allows high-level-language debugging.
  54.  
  55. Version 3.17 D86 adds support for the Z-100 series of computers,
  56. and cleans up some problems with tiny-memory systems.  A86/D86
  57. has been successfully run on a 128K system!
  58.  
  59. Version 3.15 introduces the first "extra" for D86 registered 
  60. users only: D86 sees if it happens to be running on a 386; if 
  61. it is, then D86 provides the ability to set data breakpoints, 
  62. trapping if a specified memory location is accessed.  This 
  63. feature is generally available only on hardware-assisted 
  64. debuggers, but the 386 has on-chip facilities for its 
  65. implementation in software.  NOTE: this doesn't mean that D86 
  66. has support for 386 development (32-bit registers, etc.)-- I'm 
  67. working on D386, that will do all that. 
  68.  
  69.  
  70. How to Get Everything
  71.  
  72. The packages consist of many files, packed tightly into a few 
  73. files with the ARC (for archive) extension.  I have provided 
  74. three batch files for unpacking:
  75.  
  76. HXA86.BAT extracts all the files from the A86 package, assuming you 
  77. have a hard disk.  You should copy the contents of this disk onto 
  78. a hard-disk subdirectory, set your current directory to that 
  79. subdirectory, and type HXA86 to invoke the file.  All the files 
  80. of three A86 archives will be unpacked and placed into the 
  81. directory.
  82.  
  83. FXA86.BAT extracts only the non-DOC files from the A86 package.  
  84. Use it if you have floppies only.  You'll want to copy 
  85. the A86*.ARC, F*.BAT, and ARCE.COM files to an empty floppy 
  86. before unpacking. 
  87.  
  88. XD86.BAT unpacks all files of the D86 package.  There are few 
  89. enough to fit on a floppy, so there's only one batch file for 
  90. both floppy and hard-disk.  Again, copy the D86*.ARC, batch 
  91. files, and ARCE.COM to a clean floppy or subdirectory before 
  92. unpacking. 
  93.  
  94.  
  95. Among the files unpacked are batch files for copying the 
  96. documentation to the printer.  They are as follows:
  97.  
  98. HLISTA86.BAT copies all the DOC files to the printer.  The files 
  99. have been narrowed so that you can print at 10 characters per 
  100. inch with margins; except for the file 06TABLE.DOC, which I 
  101. couldn't figure out how to narrow.  I have inserted the commands 
  102. SET12 and SET10 around that file.  If you make a SET12 program or 
  103. batch file that sets your printer to 12 characters per inch, and 
  104. SET10 to set it back to 10, you'll avoid wraparound in the 
  105. instruction table of Chapter 6.  If you don't, the files will 
  106. come out anyway; Chapter 6 will be ugly but usable. 
  107.  
  108. FLISTA86.BAT unpacks each A86 DOC file one at a time, prints it, then 
  109. deletes it (it's still in the ARC file after this process).  That 
  110. way, you won't overflow your floppy disk.  The same caveat as 
  111. HLIST.BAT applies for Chapter 6, SET12, and SET10. 
  112.  
  113. LISTD86.BAT prints the D86 documentation files.  All the files 
  114. have been narrowed to fit in 10 characters per inch, with 
  115. margins. 
  116.  
  117.