doc/changes.src

   1 \#
   2 \# NASM revision history in nasmdoc format
   3 \#
   4
   5 \H{cl-2.xx} NASM 2 Series
   6
   7 The NASM 2 series support x86-64, and is the production version of NASM
   8 since 2007.
   9
  10 \S{cl-2.08rc1} Version 2.08rc1
  11
  12 \b A number of enhancements/fixes in macros area.
  13
  14 \b Fuzzy operand size logic introduced.
  15
  16 \b Fix crashes with -fwin32 on file with many exports.
  17
  18 \b Fix stack overrun for too long [DEBUG id].
  19
  20 \b Append ending token for \c{.stabs} records in the ELF output format.
  21
  22 \b New NSIS script which uses ModernUI and MultiUser approach.
  23
  24 \b Visual Studio 2008 NASM integration (rules file).
  25
  26 \b Warn a user if a constant too long (and as a result will be stripped).
  27
  28 \S{cl-2.07} Version 2.07
  29
  30 \b NASM is now under the 2-clause BSD license.  See \k{legal}.
  31
  32 \b Fix the section type for the \c{.strtab} section in the \c{elf64}
  33   output format.
  34
  35 \b Fix the handling of \c{COMMON} directives in the \c{obj} output format.
  36
  37 \b New \c{ith} and \c{srec} output formats; these are variants of the
  38   \c{bin} output format which output Intel hex and Motorola S-records,
  39   respectively.  See \k{ithfmt} and \k{srecfmt}.
  40
  41 \b \c{rdf2ihx} replaced with an enhanced \c{rdf2bin}, which can output
  42   binary, COM, Intel hex or Motorola S-records.
  43
  44 \b The Windows installer now puts the NASM directory first in the
  45   \c{PATH} of the "NASM Shell".
  46
  47 \b Revert the early expansion behavior of \c{%+} to pre-2.06 behavior:
  48   \c{%+} is only expanded late.
  49
  50 \b Yet another Mach-O alignment fix.
  51
  52 \b Don't delete the list file on errors.  Also, include error and
  53   warning information in the list file.
  54
  55 \b Support for 64-bit Mach-O output, see \k{machofmt}.
  56
  57 \b Fix assert failure on certain operations that involve strings with
  58   high-bit bytes.
  59
  60
  61 \S{cl-2.06} Version 2.06
  62
  63 \b This release is dedicated to the memory of Charles A. Crayne, long
  64   time NASM developer as well as moderator of \c{comp.lang.asm.x86} and
  65   author of the book \e{Serious Assembler}.  We miss you, Chuck.
  66
  67 \b Support for indirect macro expansion (\c{%[...]}).  See \k{indmacro}.
  68
  69 \b \c{%pop} can now take an argument, see \k{pushpop}.
  70
  71 \b The argument to \c{%use} is no longer macro-expanded.  Use
  72   \c{%[...]} if macro expansion is desired.
  73
  74 \b Support for thread-local storage in ELF32 and ELF64.  See \k{elftls}.
  75
  76 \b Fix crash on \c{%ifmacro} without an argument.
  77
  78 \b Correct the arguments to the \c{POPCNT} instruction.
  79
  80 \b Fix section alignment in the Mach-O format.
  81
  82 \b Update AVX support to version 5 of the Intel specification.
  83
  84 \b Fix the handling of accesses to context-local macros from higher
  85   levels in the context stack.
  86
  87 \b Treat \c{WAIT} as a prefix rather than as an instruction, thereby
  88   allowing constructs like \c{O16 FSAVE} to work correctly.
  89
  90 \b Support for structures with a non-zero base offset. See \k{struc}.
  91
  92 \b Correctly handle preprocessor token concatenation (see \k{concat})
  93    involving floating-point numbers.
  94
  95 \b The \c{PINSR} series of instructions have been corrected and
  96    rationalized.
  97
  98 \b Removed AMD SSE5, replaced with the new XOP/FMA4/CVT16 (rev 3.03)
  99    spec.
 100
 101 \b The ELF backends no longer automatically generate a \c{.comment} section.
 102
 103 \b Add additional "well-known" ELF sections with default attributes.  See
 104    \k{elfsect}.
 105
 106
 107 \S{cl-2.05.01} Version 2.05.01
 108
 109 \b Fix the \c{-w}/\c{-W} option parsing, which was broken in NASM 2.05.
 110
 111
 112 \S{cl-2.05} Version 2.05
 113
 114 \b Fix redundant REX.W prefix on \c{JMP reg64}.
 115
 116 \b Make the behaviour of \c{-O0} match NASM 0.98 legacy behavior.
 117   See \k{opt-O}.
 118
 119 \b \c{-w-user} can be used to suppress the output of \c{%warning} directives.
 120   See \k{opt-w}.
 121
 122 \b Fix bug where \c{ALIGN} would issue a full alignment datum instead of
 123   zero bytes.
 124
 125 \b Fix offsets in list files.
 126
 127 \b Fix \c{%include} inside multi-line macros or loops.
 128
 129 \b Fix error where NASM would generate a spurious warning on valid
 130   optimizations of immediate values.
 131
 132 \b Fix arguments to a number of the \c{CVT} SSE instructions.
 133
 134 \b Fix RIP-relative offsets when the instruction carries an immediate.
 135
 136 \b Massive overhaul of the ELF64 backend for spec compliance.
 137
 138 \b Fix the Geode \c{PFRCPV} and \c{PFRSQRTV} instruction.
 139
 140 \b Fix the SSE 4.2 \c{CRC32} instruction.
 141
 142
 143 \S{cl-2.04} Version 2.04
 144
 145 \b Sanitize macro handing in the \c{%error} directive.
 146
 147 \b New \c{%warning} directive to issue user-controlled warnings.
 148
 149 \b \c{%error} directives are now deferred to the final assembly phase.
 150
 151 \b New \c{%fatal} directive to immediately terminate assembly.
 152
 153 \b New \c{%strcat} directive to join quoted strings together.
 154
 155 \b New \c{%use} macro directive to support standard macro directives.  See
 156   \k{use}.
 157
 158 \b Excess default parameters to \c{%macro} now issues a warning by default.
 159   See \k{mlmacro}.
 160
 161 \b Fix \c{%ifn} and \c{%elifn}.
 162
 163 \b Fix nested \c{%else} clauses.
 164
 165 \b Correct the handling of nested \c{%rep}s.
 166
 167 \b New \c{%unmacro} directive to undeclare a multi-line macro.
 168   See \k{unmacro}.
 169
 170 \b Builtin macro \c{__PASS__} which expands to the current assembly pass.
 171   See \k{pass_macro}.
 172
 173 \b \c{__utf16__} and \c{__utf32__} operators to generate UTF-16 and UTF-32
 174   strings.  See \k{unicode}.
 175
 176 \b Fix bug in case-insensitive matching when compiled on platforms that
 177   don't use the \c{configure} script.  Of the official release binaries,
 178   that only affected the OS/2 binary.
 179
 180 \b Support for x87 packed BCD constants.  See \k{bcdconst}.
 181
 182 \b Correct the \c{LTR} and \c{SLDT} instructions in 64-bit mode.
 183
 184 \b Fix unnecessary REX.W prefix on indirect jumps in 64-bit mode.
 185
 186 \b Add AVX versions of the AES instructions (\c{VAES}...).
 187
 188 \b Fix the 256-bit FMA instructions.
 189
 190 \b Add 256-bit AVX stores per the latest AVX spec.
 191
 192 \b VIA XCRYPT instructions can now be written either with or without
 193   \c{REP}, apparently different versions of the VIA spec wrote them
 194   differently.
 195
 196 \b Add missing 64-bit \c{MOVNTI} instruction.
 197
 198 \b Fix the operand size of \c{VMREAD} and \c{VMWRITE}.
 199
 200 \b Numerous bug fixes, especially to the AES, AVX and VTX instructions.
 201
 202 \b The optimizer now always runs until it converges.  It also runs even
 203   when disabled, but doesn't optimize.  This allows most forward references
 204   to be resolved properly.
 205
 206 \b \c{%push} no longer needs a context identifier; omitting the context
 207   identifier results in an anonymous context.
 208
 209
 210 \S{cl-2.03.01} Version 2.03.01
 211
 212 \b Fix buffer overflow in the listing module.
 213
 214 \b Fix the handling of hexadecimal escape codes in `...` strings.
 215
 216 \b The Postscript/PDF documentation has been reformatted.
 217
 218 \b The \c{-F} option now implies \c{-g}.
 219
 220
 221 \S{cl-2.03} Version 2.03
 222
 223 \b Add support for Intel AVX, CLMUL and FMA instructions,
 224 including YMM registers.
 225
 226 \b \c{dy}, \c{resy} and \c{yword} for 32-byte operands.
 227
 228 \b Fix some SSE5 instructions.
 229
 230 \b Intel \c{INVEPT}, \c{INVVPID} and \c{MOVBE} instructions.
 231
 232 \b Fix checking for critical expressions when the optimizer is enabled.
 233
 234 \b Support the DWARF debugging format for ELF targets.
 235
 236 \b Fix optimizations of signed bytes.
 237
 238 \b Fix operation on bigendian machines.
 239
 240 \b Fix buffer overflow in the preprocessor.
 241
 242 \b \c{SAFESEH} support for Win32, \c{IMAGEREL} for Win64 (SEH).
 243
 244 \b \c{%?} and \c{%??} to refer to the name of a macro itself.  In particular,
 245 \c{%idefine keyword $%?} can be used to make a keyword "disappear".
 246
 247 \b New options for dependency generation: \c{-MD}, \c{-MF},
 248 \c{-MP}, \c{-MT}, \c{-MQ}.
 249
 250 \b New preprocessor directives \c{%pathsearch} and \c{%depend}; INCBIN
 251 reimplemented as a macro.
 252
 253 \b \c{%include} now resolves macros in a sane manner.
 254
 255 \b \c{%substr} can now be used to get other than one-character substrings.
 256
 257 \b New type of character/string constants, using backquotes (\c{`...`}),
 258 which support C-style escape sequences.
 259
 260 \b \c{%defstr} and \c{%idefstr} to stringize macro definitions before
 261 creation.
 262
 263 \b Fix forward references used in \c{EQU} statements.
 264
 265
 266 \S{cl-2.02} Version 2.02
 267
 268 \b Additional fixes for MMX operands with explicit \c{qword}, as well as
 269   (hopefully) SSE operands with \c{oword}.
 270
 271 \b Fix handling of truncated strings with \c{DO}.
 272
 273 \b Fix segfaults due to memory overwrites when floating-point constants
 274   were used.
 275
 276 \b Fix segfaults due to missing include files.
 277
 278 \b Fix OpenWatcom Makefiles for DOS and OS/2.
 279
 280 \b Add autogenerated instruction list back into the documentation.
 281
 282 \b ELF: Fix segfault when generating stabs, and no symbols have been
 283   defined.
 284
 285 \b ELF: Experimental support for DWARF debugging information.
 286
 287 \b New compile date and time standard macros.
 288
 289 \b \c{%ifnum} now returns true for negative numbers.
 290
 291 \b New \c{%iftoken} test for a single token.
 292
 293 \b New \c{%ifempty} test for empty expansion.
 294
 295 \b Add support for the \c{XSAVE} instruction group.
 296
 297 \b Makefile for Netware/gcc.
 298
 299 \b Fix issue with some warnings getting emitted way too many times.
 300
 301 \b Autogenerated instruction list added to the documentation.
 302
 303
 304 \S{cl-2.01} Version 2.01
 305
 306 \b Fix the handling of MMX registers with explicit \c{qword} tags on
 307   memory (broken in 2.00 due to 64-bit changes.)
 308
 309 \b Fix the PREFETCH instructions.
 310
 311 \b Fix the documentation.
 312
 313 \b Fix debugging info when using \c{-f elf}
 314 (backwards compatibility alias for \c{-f elf32}).
 315
 316 \b Man pages for rdoff tools (from the Debian project.)
 317
 318 \b ELF: handle large numbers of sections.
 319
 320 \b Fix corrupt output when the optimizer runs out of passes.
 321
 322
 323 \S{cl-2.00} Version 2.00
 324
 325 \b Added c99 data-type compliance.
 326
 327 \b Added general x86-64 support.
 328
 329 \b Added win64 (x86-64 COFF) output format.
 330
 331 \b Added \c{__BITS__} standard macro.
 332
 333 \b Renamed the \c{elf} output format to \c{elf32} for clarity.
 334
 335 \b Added \c{elf64} and \c{macho} (MacOS X) output formats.
 336
 337 \b Added Numeric constants in \c{dq} directive.
 338
 339 \b Added \c{oword}, \c{do} and \c{reso} pseudo operands.
 340
 341 \b Allow underscores in numbers.
 342
 343 \b Added 8-, 16- and 128-bit floating-point formats.
 344
 345 \b Added binary, octal and hexadecimal floating-point.
 346
 347 \b Correct the generation of floating-point constants.
 348
 349 \b Added floating-point option control.
 350
 351 \b Added Infinity and NaN floating point support.
 352
 353 \b Added ELF Symbol Visibility support.
 354
 355 \b Added setting OSABI value in ELF header directive.
 356
 357 \b Added Generate Makefile Dependencies option.
 358
 359 \b Added Unlimited Optimization Passes option.
 360
 361 \b Added \c{%IFN} and \c{%ELIFN} support.
 362
 363 \b Added Logical Negation Operator.
 364
 365 \b Enhanced Stack Relative Preprocessor Directives.
 366
 367 \b Enhanced ELF Debug Formats.
 368
 369 \b Enhanced Send Errors to a File option.
 370
 371 \b Added SSSE3, SSE4.1, SSE4.2, SSE5 support.
 372
 373 \b Added a large number of additional instructions.
 374
 375 \b Significant performance improvements.
 376
 377 \b \c{-w+warning} and \c{-w-warning} can now be written as -Wwarning and
 378  -Wno-warning, respectively.  See \k{opt-w}.
 379
 380 \b Add \c{-w+error} to treat warnings as errors.  See \k{opt-w}.
 381
 382 \b Add \c{-w+all} and \c{-w-all} to enable or disable all suppressible
 383  warnings.  See \k{opt-w}.
 384
 385
 386 \H{cl-0.98.xx} NASM 0.98 Series
 387
 388 The 0.98 series was the production versions of NASM from 1999 to 2007.
 389
 390
 391 \S{cl-0.98.39} Version 0.98.39
 392
 393 \b fix buffer overflow
 394
 395 \b fix outas86's \c{.bss} handling
 396
 397 \b "make spotless" no longer deletes config.h.in.
 398
 399 \b \c{%(el)if(n)idn} insensitivity to string quotes difference (#809300).
 400
 401 \b (nasm.c)\c{__OUTPUT_FORMAT__} changed to string value instead of symbol.
 402
 403 \S{cl-0.98.38} Version 0.98.38
 404
 405
 406 \b Add Makefile for 16-bit DOS binaries under OpenWatcom, and modify
 407   \c{mkdep.pl} to be able to generate completely pathless dependencies, as
 408   required by OpenWatcom wmake (it supports path searches, but not
 409   explicit paths.)
 410
 411 \b Fix the \c{STR} instruction.
 412
 413 \b Fix the ELF output format, which was broken under certain
 414   circumstances due to the addition of stabs support.
 415
 416 \b Quick-fix Borland format debug-info for \c{-f obj}
 417
 418 \b Fix for \c{%rep} with no arguments (#560568)
 419
 420 \b Fix concatenation of preprocessor function call (#794686)
 421
 422 \b Fix long label causes coredump (#677841)
 423
 424 \b Use autoheader as well as autoconf to keep configure from generating
 425   ridiculously long command lines.
 426
 427 \b Make sure that all of the formats which support debugging output
 428   actually will suppress debugging output when \c{-g} not specified.
 429
 430 \S{cl-0.98.37} Version 0.98.37
 431
 432
 433 \b Paths given in \c{-I} switch searched for \c{incbin}-ed as
 434   well as \c{%include}-ed files.
 435
 436 \b Added stabs debugging for the ELF output format, patch from
 437   Martin Wawro.
 438
 439 \b Fix \c{output/outbin.c} to allow origin > 80000000h.
 440
 441 \b Make \c{-U} switch work.
 442
 443 \b Fix the use of relative offsets with explicit prefixes, e.g.
 444 \c{a32 loop foo}.
 445
 446 \b Remove \c{backslash()}.
 447
 448 \b Fix the \c{SMSW} and \c{SLDT} instructions.
 449
 450 \b \c{-O2} and \c{-O3} are no longer aliases for \c{-O10} and \c{-O15}.
 451 If you mean the latter, please say so! :)
 452
 453 \S{cl-0.98.36} Version 0.98.36
 454
 455
 456 \b Update rdoff - librarian/archiver - common rec - docs!
 457
 458 \b Fix signed/unsigned problems.
 459
 460 \b Fix \c{JMP FAR label} and \c{CALL FAR label}.
 461
 462 \b Add new multisection support - map files - fix align bug
 463
 464 \b Fix sysexit, movhps/movlps reg,reg bugs in insns.dat
 465
 466 \b \c{Q} or \c{O} suffixes indicate octal
 467
 468 \b Support Prescott new instructions (PNI).
 469
 470 \b Cyrix \c{XSTORE} instruction.
 471
 472
 473 \S{cl-0.98.35} Version 0.98.35
 474
 475 \b Fix build failure on 16-bit DOS (Makefile.bc3 workaround for compiler bug.)
 476
 477 \b Fix dependencies and compiler warnings.
 478
 479 \b Add "const" in a number of places.
 480
 481 \b Add -X option to specify error reporting format (use -Xvc to
 482   integrate with Microsoft Visual Studio.)
 483
 484 \b Minor changes for code legibility.
 485
 486 \b Drop use of tmpnam() in rdoff (security fix.)
 487
 488
 489 \S{cl-0.98.34} Version 0.98.34
 490
 491 \b Correct additional address-size vs. operand-size confusions.
 492
 493 \b Generate dependencies for all Makefiles automatically.
 494
 495 \b Add support for unimplemented (but theoretically available)
 496   registers such as tr0 and cr5.  Segment registers 6 and 7 are called
 497   segr6 and segr7 for the operations which they can be represented.
 498
 499 \b Correct some disassembler bugs related to redundant address-size prefixes.
 500   Some work still remains in this area.
 501
 502 \b Correctly generate an error for things like "SEG eax".
 503
 504 \b Add the JMPE instruction, enabled by "CPU IA64".
 505
 506 \b Correct compilation on newer gcc/glibc platforms.
 507
 508 \b Issue an error on things like "jmp far eax".
 509
 510
 511 \S{cl-0.98.33} Version 0.98.33
 512
 513 \b New __NASM_PATCHLEVEL__ and __NASM_VERSION_ID__ standard macros to
 514   round out the version-query macros.  version.pl now understands
 515   X.YYplWW or X.YY.ZZplWW as a version number, equivalent to
 516   X.YY.ZZ.WW (or X.YY.0.WW, as appropriate).
 517
 518 \b New keyword "strict" to disable the optimization of specific
 519   operands.
 520
 521 \b Fix the handing of size overrides with JMP instructions
 522   (instructions such as "jmp dword foo".)
 523
 524 \b Fix the handling of "ABSOLUTE label", where "label" points into a
 525   relocatable segment.
 526
 527 \b Fix OBJ output format with lots of externs.
 528
 529 \b More documentation updates.
 530
 531 \b Add -Ov option to get verbose information about optimizations.
 532
 533 \b Undo a braindead change which broke \c{%elif} directives.
 534
 535 \b Makefile updates.
 536
 537
 538 \S{cl-0.98.32} Version 0.98.32
 539
 540 \b Fix NASM crashing when \c{%macro} directives were left unterminated.
 541
 542 \b Lots of documentation updates.
 543
 544 \b Complete rewrite of the PostScript/PDF documentation generator.
 545
 546 \b The MS Visual C++ Makefile was updated and corrected.
 547
 548 \b Recognize .rodata as a standard section name in ELF.
 549
 550 \b Fix some obsolete Perl4-isms in Perl scripts.
 551
 552 \b Fix configure.in to work with autoconf 2.5x.
 553
 554 \b Fix a couple of "make cleaner" misses.
 555
 556 \b Make the normal "./configure && make" work with Cygwin.
 557
 558
 559 \S{cl-0.98.31} Version 0.98.31
 560
 561 \b Correctly build in a separate object directory again.
 562
 563 \b Derive all references to the version number from the version file.
 564
 565 \b New standard macros __NASM_SUBMINOR__ and __NASM_VER__ macros.
 566
 567 \b Lots of Makefile updates and bug fixes.
 568
 569 \b New \c{%ifmacro} directive to test for multiline macros.
 570
 571 \b Documentation updates.
 572
 573 \b Fixes for 16-bit OBJ format output.
 574
 575 \b Changed the NASM environment variable to NASMENV.
 576
 577
 578 \S{cl-0.98.30} Version 0.98.30
 579
 580 \b Changed doc files a lot: completely removed old READMExx and
 581   Wishlist files, incorporating all information in CHANGES and TODO.
 582
 583 \b I waited a long time to rename zoutieee.c to (original) outieee.c
 584
 585 \b moved all output modules to output/ subdirectory.
 586
 587 \b Added 'make strip' target to strip debug info from nasm & ndisasm.
 588
 589 \b Added INSTALL file with installation instructions.
 590
 591 \b Added -v option description to nasm man.
 592
 593 \b Added dist makefile target to produce source distributions.
 594
 595 \b 16-bit support for ELF output format (GNU extension, but useful.)
 596
 597
 598 \S{cl-0.98.28} Version 0.98.28
 599
 600 \b Fastcooked this for Debian's Woody release:
 601 Frank applied the INCBIN bug patch to 0.98.25alt and called
 602 it 0.98.28 to not confuse poor little apt-get.
 603
 604
 605 \S{cl-0.98.26} Version 0.98.26
 606
 607 \b Reorganised files even better from 0.98.25alt
 608
 609
 610 \S{cl-0.98.25alt} Version 0.98.25alt
 611
 612 \b Prettified the source tree. Moved files to more reasonable places.
 613
 614 \b Added findleak.pl script to misc/ directory.
 615
 616 \b Attempted to fix doc.
 617
 618
 619 \S{cl-0.98.25} Version 0.98.25
 620
 621 \b Line continuation character \c{\\}.
 622
 623 \b Docs inadvertantly reverted - "dos packaging".
 624
 625
 626 \S{cl-0.98.24p1} Version 0.98.24p1
 627
 628 \b FIXME: Someone, document this please.
 629
 630
 631 \S{cl-0.98.24} Version 0.98.24
 632
 633 \b Documentation - Ndisasm doc added to Nasm.doc.
 634
 635
 636 \S{cl-0.98.23} Version 0.98.23
 637
 638 \b Attempted to remove rdoff version1
 639
 640 \b Lino Mastrodomenico's patches to preproc.c (%$$ bug?).
 641
 642
 643 \S{cl-0.98.22} Version 0.98.22
 644
 645 \b Update rdoff2 - attempt to remove v1.
 646
 647
 648 \S{cl-0.98.21} Version 0.98.21
 649
 650 \b Optimization fixes.
 651
 652
 653 \S{cl-0.98.20} Version 0.98.20
 654
 655 \b Optimization fixes.
 656
 657
 658 \S{cl-0.98.19} Version 0.98.19
 659
 660 \b H. J. Lu's patch back out.
 661
 662
 663 \S{cl-0.98.18} Version 0.98.18
 664
 665 \b Added ".rdata" to "-f win32".
 666
 667
 668 \S{cl-0.98.17} Version 0.98.17
 669
 670 \b H. J. Lu's "bogus elf" patch. (Red Hat problem?)
 671
 672
 673 \S{cl-0.98.16} Version 0.98.16
 674
 675 \b Fix whitespace before "[section ..." bug.
 676
 677
 678 \S{cl-0.98.15} Version 0.98.15
 679
 680 \b Rdoff changes (?).
 681
 682 \b Fix fixes to memory leaks.
 683
 684
 685 \S{cl-0.98.14} Version 0.98.14
 686
 687 \b Fix memory leaks.
 688
 689
 690 \S{cl-0.98.13} Version 0.98.13
 691
 692 \b There was no 0.98.13
 693
 694
 695 \S{cl-0.98.12} Version 0.98.12
 696
 697 \b Update optimization (new function of "-O1")
 698
 699 \b Changes to test/bintest.asm (?).
 700
 701
 702 \S{cl-0.98.11} Version 0.98.11
 703
 704 \b Optimization changes.
 705
 706 \b Ndisasm fixed.
 707
 708
 709 \S{cl-0.98.10} Version 0.98.10
 710
 711 \b There was no 0.98.10
 712
 713
 714 \S{cl-0.98.09} Version 0.98.09
 715
 716 \b Add multiple sections support to "-f bin".
 717
 718 \b Changed GLOBAL_TEMP_BASE in outelf.c from 6 to 15.
 719
 720 \b Add "-v" as an alias to the "-r" switch.
 721
 722 \b Remove "#ifdef" from Tasm compatibility options.
 723
 724 \b Remove redundant size-overrides on "mov ds, ex", etc.
 725
 726 \b Fixes to SSE2, other insns.dat (?).
 727
 728 \b Enable uppercase "I" and "P" switches.
 729
 730 \b Case insinsitive "seg" and "wrt".
 731
 732 \b Update install.sh (?).
 733
 734 \b Allocate tokens in blocks.
 735
 736 \b Improve "invalid effective address" messages.
 737
 738
 739 \S{cl-0.98.08} Version 0.98.08
 740
 741 \b Add "\c{%strlen}" and "\c{%substr}" macro operators
 742
 743 \b Fixed broken c16.mac.
 744
 745 \b Unterminated string error reported.
 746
 747 \b Fixed bugs as per 0.98bf
 748
 749
 750 \S{cl-0.98.09b with John Coffman patches released 28-Oct-2001} Version 0.98.09b with John Coffman patches released 28-Oct-2001
 751
 752 Changes from 0.98.07 release to 98.09b as of 28-Oct-2001
 753
 754 \b More closely compatible with 0.98 when -O0 is implied
 755 or specified.  Not strictly identical, since backward
 756 branches in range of short offsets are recognized, and signed
 757 byte values with no explicit size specification will be
 758 assembled as a single byte.
 759
 760 \b More forgiving with the PUSH instruction.  0.98 requires
 761 a size to be specified always.  0.98.09b will imply the size
 762 from the current BITS setting (16 or 32).
 763
 764 \b Changed definition of the optimization flag:
 765
 766         -O0     strict two-pass assembly, JMP and Jcc are
 767                 handled more like 0.98, except that back-
 768                 ward JMPs are short, if possible.
 769
 770         -O1     strict two-pass assembly, but forward
 771                 branches are assembled with code guaranteed
 772                 to reach; may produce larger code than
 773                 -O0, but will produce successful assembly
 774                 more often if branch offset sizes are not
 775                 specified.
 776
 777         -O2     multi-pass optimization, minimize branch
 778                 offsets; also will minimize signed immed-
 779                 iate bytes, overriding size specification.
 780
 781         -O3     like -O2, but more passes taken, if needed
 782
 783
 784 \S{cl-0.98.07 released 01/28/01} Version 0.98.07 released 01/28/01
 785
 786 \b       Added Stepane Denis' SSE2 instructions to a *working*
 787         version of the code - some earlier versions were based on
 788         broken code - sorry 'bout that. version "0.98.07"
 789
 790
 791 01/28/01
 792
 793
 794 \b       Cosmetic modifications to nasm.c, nasm.h,
 795         AUTHORS, MODIFIED
 796
 797
 798 \S{cl-0.98.06f released 01/18/01} Version 0.98.06f released 01/18/01
 799
 800
 801 \b       - Add "metalbrain"s jecxz bug fix in insns.dat
 802         - alter nasmdoc.src to match - version "0.98.06f"
 803
 804
 805 \S{cl-0.98.06e released 01/09/01} Version 0.98.06e released 01/09/01
 806
 807
 808 \b       Removed the "outforms.h" file - it appears to be
 809         someone's old backup of "outform.h". version "0.98.06e"
 810
 811 01/09/01
 812
 813 \b fbk - finally added the fix for the "multiple %includes bug",
 814         known since 7/27/99 - reported originally (?) and sent to
 815         us by Austin Lunnen - he reports that John Fine had a fix
 816         within the day. Here it is...
 817
 818 \b Nelson Rush resigns from the group. Big thanks to Nelson for
 819   his leadership and enthusiasm in getting these changes
 820   incorporated into Nasm!
 821
 822 \b fbk - [list +], [list -] directives - ineptly implemented, should
 823         be re-written or removed, perhaps.
 824
 825 \b Brian Raiter / fbk - "elfso bug" fix - applied to aoutb format
 826                        as well - testing might be desirable...
 827
 828 08/07/00
 829
 830 \b James Seter - -postfix, -prefix command line switches.
 831
 832 \b Yuri Zaporogets - rdoff utility changes.
 833
 834
 835 \S{cl-0.98p1} Version 0.98p1
 836
 837 \b GAS-like palign (Panos Minos)
 838
 839 \b FIXME: Someone, fill this in with details
 840
 841
 842 \S{cl-0.98bf (bug-fixed)} Version 0.98bf (bug-fixed)
 843
 844 \b Fixed - elf and aoutb bug - shared libraries
 845         - multiple "%include" bug in "-f obj"
 846         - jcxz, jecxz bug
 847         - unrecognized option bug in ndisasm
 848
 849 \S{cl-0.98.03 with John Coffman's changes released 27-Jul-2000} Version 0.98.03 with John Coffman's changes released 27-Jul-2000
 850
 851 \b Added signed byte optimizations for the 0x81/0x83 class
 852 of instructions: ADC, ADD, AND, CMP, OR, SBB, SUB, XOR:
 853 when used as 'ADD reg16,imm' or 'ADD reg32,imm.'  Also
 854 optimization of signed byte form of 'PUSH imm' and 'IMUL
 855 reg,imm'/'IMUL reg,reg,imm.'  No size specification is needed.
 856
 857 \b Added multi-pass JMP and Jcc offset optimization.  Offsets
 858 on forward references will preferentially use the short form,
 859 without the need to code a specific size (short or near) for
 860 the branch.  Added instructions for 'Jcc label' to use the
 861 form 'Jnotcc $+3/JMP label', in cases where a short offset
 862 is out of bounds.  If compiling for a 386 or higher CPU, then
 863 the 386 form of Jcc will be used instead.
 864
 865 This feature is controlled by a new command-line switch: "O",
 866 (upper case letter O).  "-O0" reverts the assembler to no
 867 extra optimization passes, "-O1" allows up to 5 extra passes,
 868 and "-O2"(default), allows up to 10 extra optimization passes.
 869
 870 \b Added a new directive:  'cpu XXX', where XXX is any of:
 871 8086, 186, 286, 386, 486, 586, pentium, 686, PPro, P2, P3 or
 872 Katmai.  All are case insensitive.  All instructions will
 873 be selected only if they apply to the selected cpu or lower.
 874 Corrected a couple of bugs in cpu-dependence in 'insns.dat'.
 875
 876 \b Added to 'standard.mac', the "use16" and "use32" forms of
 877 the "bits 16/32" directive. This is nothing new, just conforms
 878 to a lot of other assemblers. (minor)
 879
 880 \b Changed label allocation from 320/32 (10000 labels @ 200K+)
 881 to 32/37 (1000 labels); makes running under DOS much easier.
 882 Since additional label space is allocated dynamically, this
 883 should have no effect on large programs with lots of labels.
 884 The 37 is a prime, believed to be better for hashing. (minor)
 885
 886
 887 \S{cl-0.98.03} Version 0.98.03
 888
 889 "Integrated patchfile 0.98-0.98.01.  I call this version 0.98.03 for
 890 historical reasons: 0.98.02 was trashed." --John Coffman
 891 <johninsd@san.rr.com>, 27-Jul-2000
 892
 893 \b Kendall Bennett's SciTech MGL changes
 894
 895 \b Note that you must define "TASM_COMPAT" at compile-time
 896 to get the Tasm Ideal Mode compatibility.
 897
 898 \b All changes can be compiled in and out using the TASM_COMPAT macros,
 899 and when compiled without TASM_COMPAT defined we get the exact same
 900 binary as the unmodified 0.98 sources.
 901
 902 \b standard.mac, macros.c: Added macros to ignore TASM directives before
 903 first include
 904
 905 \b nasm.h: Added extern declaration for tasm_compatible_mode
 906
 907 \b nasm.c: Added global variable tasm_compatible_mode
 908
 909 \b Added command line switch for TASM compatible mode (-t)
 910
 911 \b Changed version command line to reflect when compiled with TASM additions
 912
 913 \b Added response file processing to allow all arguments on a single
 914 line (response file is @resp rather than -@resp for NASM format).
 915
 916 \b labels.c: Changes islocal() macro to support TASM style @@local labels.
 917
 918 \b Added islocalchar() macro to support TASM style @@local labels.
 919
 920 \b parser.c: Added support for TASM style memory references (ie: mov
 921 [DWORD eax],10 rather than the NASM style mov DWORD [eax],10).
 922
 923 \b preproc.c: Added new directives, \c{%arg}, \c{%local}, \c{%stacksize} to directives
 924 table
 925
 926 \b Added support for TASM style directives without a leading % symbol.
 927
 928 \b Integrated a block of changes from Andrew Zabolotny <bit@eltech.ru>:
 929
 930 \b A new keyword \c{%xdefine} and its case-insensitive counterpart \c{%ixdefine}.
 931 They work almost the same way as \c{%define} and \c{%idefine} but expand
 932 the definition immediately, not on the invocation. Something like a cross
 933 between \c{%define} and \c{%assign}. The "x" suffix stands for "eXpand", so
 934 "xdefine" can be deciphered as "expand-and-define". Thus you can do
 935 things like this:
 936
 937 \c      %assign ofs     0
 938 \c
 939 \c      %macro  arg     1
 940 \c              %xdefine %1 dword [esp+ofs]
 941 \c              %assign ofs ofs+4
 942 \c      %endmacro
 943
 944 \b Changed the place where the expansion of %$name macros are expanded.
 945 Now they are converted into ..@ctxnum.name form when detokenizing, so
 946 there are no quirks as before when using %$name arguments to macros,
 947 in macros etc. For example:
 948
 949 \c      %macro  abc     1
 950 \c              %define %1 hello
 951 \c      %endm
 952 \c
 953 \c      abc     %$here
 954 \c      %$here
 955
 956     Now last line will be expanded into "hello" as expected. This also allows
 957     for lots of goodies, a good example are extended "proc" macros included
 958     in this archive.
 959
 960 \b Added a check for "cstk" in smacro_defined() before calling get_ctx() -
 961     this allows for things like:
 962
 963 \c      %ifdef %$abc
 964 \c      %endif
 965
 966     to work without warnings even in no context.
 967
 968 \b Added a check for "cstk" in %if*ctx and %elif*ctx directives -
 969     this allows to use \c{%ifctx} without excessive warnings. If there is
 970     no active context, \c{%ifctx} goes through "false" branch.
 971
 972 \b Removed "user error: " prefix with \c{%error} directive: it just clobbers the
 973     output and has absolutely no functionality. Besides, this allows to write
 974     macros that does not differ from built-in functions in any way.
 975
 976 \b Added expansion of string that is output by \c{%error} directive. Now you
 977     can do things like:
 978
 979 \c      %define hello(x) Hello, x!
 980 \c
 981 \c      %define %$name andy
 982 \c      %error "hello(%$name)"
 983
 984     Same happened with \c{%include} directive.
 985
 986 \b Now all directives that expect an identifier will try to expand and
 987     concatenate everything without whitespaces in between before usage.
 988     For example, with "unfixed" nasm the commands
 989
 990 \c      %define %$abc hello
 991 \c      %define __%$abc goodbye
 992 \c      __%$abc
 993
 994     would produce "incorrect" output: last line will expand to
 995
 996 \c      hello goodbyehello
 997
 998     Not quite what you expected, eh? :-) The answer is that preprocessor
 999     treats the \c{%define} construct as if it would be
1000
1001 \c      %define __ %$abc goodbye
1002
1003     (note the white space between __ and %$abc). After my "fix" it
1004     will "correctly" expand into
1005
1006 \c      goodbye
1007
1008     as expected. Note that I use quotes around words "correct", "incorrect"
1009     etc because this is rather a feature not a bug; however current behaviour
1010     is more logical (and allows more advanced macro usage :-).
1011
1012     Same change was applied to:
1013         \c{%push},\c{%macro},\c{%imacro},\c{%define},\c{%idefine},\c{%xdefine},\c{%ixdefine},
1014         \c{%assign},\c{%iassign},\c{%undef}
1015
1016 \b A new directive [WARNING {+|-}warning-id] have been added. It works only
1017     if the assembly phase is enabled (i.e. it doesn't work with nasm -e).
1018
1019 \b A new warning type: macro-selfref. By default this warning is disabled;
1020     when enabled NASM warns when a macro self-references itself; for example
1021     the following source:
1022
1023 \c        [WARNING macro-selfref]
1024 \c
1025 \c        %macro          push    1-*
1026 \c                %rep    %0
1027 \c                        push    %1
1028 \c                        %rotate 1
1029 \c                %endrep
1030 \c        %endmacro
1031 \c
1032 \c                        push    eax,ebx,ecx
1033
1034     will produce a warning, but if we remove the first line we won't see it
1035     anymore (which is The Right Thing To Do {tm} IMHO since C preprocessor
1036     eats such constructs without warnings at all).
1037
1038 \b Added a "error" routine to preprocessor which always will set ERR_PASS1
1039     bit in severity_code. This removes annoying repeated errors on first
1040     and second passes from preprocessor.
1041
1042 \b Added the %+ operator in single-line macros for concatenating two
1043     identifiers. Usage example:
1044
1045 \c        %define _myfunc _otherfunc
1046 \c        %define cextern(x) _ %+ x
1047 \c        cextern (myfunc)
1048
1049     After first expansion, third line will become "_myfunc". After this
1050     expansion is performed again so it becomes "_otherunc".
1051
1052 \b Now if preprocessor is in a non-emitting state, no warning or error
1053     will be emitted. Example:
1054
1055 \c        %if 1
1056 \c                mov     eax,ebx
1057 \c        %else
1058 \c                put anything you want between these two brackets,
1059 \c                even macro-parameter references %1 or local
1060 \c                labels %$zz or macro-local labels %%zz - no
1061 \c                warning will be emitted.
1062 \c        %endif
1063
1064 \b Context-local variables on expansion as a last resort are looked up
1065     in outer contexts. For example, the following piece:
1066
1067 \c        %push   outer
1068 \c        %define %$a [esp]
1069 \c
1070 \c                %push   inner
1071 \c                %$a
1072 \c                %pop
1073 \c        %pop
1074
1075     will expand correctly the fourth line to [esp]; if we'll define another
1076     %$a inside the "inner" context, it will take precedence over outer
1077     definition. However, this modification has been applied only to
1078     expand_smacro and not to smacro_define: as a consequence expansion
1079     looks in outer contexts, but \c{%ifdef} won't look in outer contexts.
1080
1081     This behaviour is needed because we don't want nested contexts to
1082     act on already defined local macros. Example:
1083
1084 \c        %define %$arg1  [esp+4]
1085 \c        test    eax,eax
1086 \c        if      nz
1087 \c                mov     eax,%$arg1
1088 \c        endif
1089
1090     In this example the "if" mmacro enters into the "if" context, so %$arg1
1091     is not valid anymore inside "if". Of course it could be worked around
1092     by using explicitely %$$arg1 but this is ugly IMHO.
1093
1094 \b Fixed memory leak in \c{%undef}. The origline wasn't freed before
1095     exiting on success.
1096
1097 \b Fixed trap in preprocessor when line expanded to empty set of tokens.
1098     This happens, for example, in the following case:
1099
1100 \c        #define SOMETHING
1101 \c        SOMETHING
1102
1103
1104 \S{cl-0.98} Version 0.98
1105
1106 All changes since NASM 0.98p3 have been produced by H. Peter Anvin <hpa@zytor.com>.
1107
1108 \b The documentation comment delimiter is \# not #.
1109
1110 \b Allow EQU definitions to refer to external labels; reported by
1111   Pedro Gimeno.
1112
1113 \b Re-enable support for RDOFF v1; reported by Pedro Gimeno.
1114
1115 \b Updated License file per OK from Simon and Julian.
1116
1117
1118 \S{cl-0.98p9} Version 0.98p9
1119
1120 \b Update documentation (although the instruction set reference will
1121   have to wait; I don't want to hold up the 0.98 release for it.)
1122
1123 \b Verified that the NASM implementation of the PEXTRW and PMOVMSKB
1124   instructions is correct.  The encoding differs from what the Intel
1125   manuals document, but the Pentium III behaviour matches NASM, not
1126   the Intel manuals.
1127
1128 \b Fix handling of implicit sizes in PSHUFW and PINSRW, reported by
1129   Stefan Hoffmeister.
1130
1131 \b Resurrect the -s option, which was removed when changing the
1132   diagnostic output to stdout.
1133
1134
1135 \S{cl-0.98p8} Version 0.98p8
1136
1137 \b Fix for "DB" when NASM is running on a bigendian machine.
1138
1139 \b Invoke insns.pl once for each output script, making Makefile.in
1140   legal for "make -j".
1141
1142 \b Improve the Unix configure-based makefiles to make package
1143   creation easier.
1144
1145 \b Included an RPM .spec file for building RPM (RedHat Package Manager)
1146   packages on Linux or Unix systems.
1147
1148 \b Fix Makefile dependency problems.
1149
1150 \b Change src/rdsrc.pl to include sectioning information in info
1151   output; required for install-info to work.
1152
1153 \b Updated the RDOFF distribution to version 2 from Jules; minor
1154   massaging to make it compile in my environment.
1155
1156 \b Split doc files that can be built by anyone with a Perl interpreter off
1157   into a separate archive.
1158
1159 \b "Dress rehearsal" release!
1160
1161
1162 \S{cl-0.98p7} Version 0.98p7
1163
1164 \b Fixed opcodes with a third byte-sized immediate argument to not
1165   complain if given "byte" on the immediate.
1166
1167 \b Allow \c{%undef} to remove single-line macros with arguments.  This
1168   matches the behaviour of #undef in the C preprocessor.
1169
1170 \b Allow -d, -u, -i and -p to be specified as -D, -U, -I and -P for
1171   compatibility with most C compilers and preprocessors.  This allows
1172   Makefile options to be shared between cc and nasm, for example.
1173
1174 \b Minor cleanups.
1175
1176 \b Went through the list of Katmai instructions and hopefully fixed the
1177   (rather few) mistakes in it.
1178
1179 \b (Hopefully) fixed a number of disassembler bugs related to ambiguous
1180   instructions (disambiguated by -p) and SSE instructions with REP.
1181
1182 \b Fix for bug reported by Mark Junger: "call dword 0x12345678" should
1183   work and may add an OSP (affected CALL, JMP, Jcc).
1184
1185 \b Fix for environments when "stderr" isn't a compile-time constant.
1186
1187
1188 \S{cl-0.98p6} Version 0.98p6
1189
1190
1191 \b Took officially over coordination of the 0.98 release; so drop
1192   the p3.x notation. Skipped p4 and p5 to avoid confusion with John
1193   Fine's J4 and J5 releases.
1194
1195 \b Update the documentation; however, it still doesn't include
1196   documentation for the various new instructions.  I somehow wonder if
1197   it makes sense to have an instruction set reference in the assembler
1198   manual when Intel et al have PDF versions of their manuals online.
1199
1200 \b Recognize "idt" or "centaur" for the -p option to ndisasm.
1201
1202 \b Changed error messages back to stderr where they belong, but add an
1203   -E option to redirect them elsewhere (the DOS shell cannot redirect
1204   stderr.)
1205
1206 \b -M option to generate Makefile dependencies (based on code from Alex
1207   Verstak.)
1208
1209 \b \c{%undef} preprocessor directive, and -u option, that undefines a
1210   single-line macro.
1211
1212 \b OS/2 Makefile (Mkfiles/Makefile.os2) for Borland under OS/2; from
1213   Chuck Crayne.
1214
1215 \b Various minor bugfixes (reported by):
1216   - Dangling \c{%s} in preproc.c (Martin Junker)
1217
1218 \b THERE ARE KNOWN BUGS IN SSE AND THE OTHER KATMAI INSTRUCTIONS.  I am
1219   on a trip and didn't bring the Katmai instruction reference, so I
1220   can't work on them right now.
1221
1222 \b Updated the License file per agreement with Simon and Jules to
1223   include a GPL distribution clause.
1224
1225
1226 \S{cl-0.98p3.7} Version 0.98p3.7
1227
1228 \b (Hopefully) fixed the canned Makefiles to include the outrdf2 and
1229   zoutieee modules.
1230
1231 \b Renamed changes.asm to changed.asm.
1232
1233
1234 \S{cl-0.98p3.6} Version 0.98p3.6
1235
1236 \b Fixed a bunch of instructions that were added in 0.98p3.5 which had
1237   memory operands, and the address-size prefix was missing from the
1238   instruction pattern.
1239
1240
1241 \S{cl-0.98p3.5} Version 0.98p3.5
1242
1243 \b Merged in changes from John S. Fine's 0.98-J5 release.  John's based
1244   0.98-J5 on my 0.98p3.3 release; this merges the changes.
1245
1246 \b Expanded the instructions flag field to a long so we can fit more
1247   flags; mark SSE (KNI) and AMD or Katmai-specific instructions as
1248   such.
1249
1250 \b Fix the "PRIV" flag on a bunch of instructions, and create new
1251   "PROT" flag for protected-mode-only instructions (orthogonal to if
1252   the instruction is privileged!) and new "SMM" flag for SMM-only
1253   instructions.
1254
1255 \b Added AMD-only SYSCALL and SYSRET instructions.
1256
1257 \b Make SSE actually work, and add new Katmai MMX instructions.
1258
1259 \b Added a -p (preferred vendor) option to ndisasm so that it can
1260   distinguish e.g. Cyrix opcodes also used in SSE.  For example:
1261
1262 \c      ndisasm -p cyrix aliased.bin
1263 \c      00000000  670F514310        paddsiw mm0,[ebx+0x10]
1264 \c      00000005  670F514320        paddsiw mm0,[ebx+0x20]
1265 \c      ndisasm -p intel aliased.bin
1266 \c      00000000  670F514310        sqrtps xmm0,[ebx+0x10]
1267 \c      00000005  670F514320        sqrtps xmm0,[ebx+0x20]
1268
1269 \b Added a bunch of Cyrix-specific instructions.
1270
1271
1272 \S{cl-0.98p3.4} Version 0.98p3.4
1273
1274 \b Made at least an attempt to modify all the additional Makefiles (in
1275   the Mkfiles directory).  I can't test it, but this was the best I
1276   could do.
1277
1278 \b DOS DJGPP+"Opus Make" Makefile from John S. Fine.
1279
1280 \b changes.asm changes from John S. Fine.
1281
1282
1283 \S{cl-0.98p3.3} Version 0.98p3.3
1284
1285 \b Patch from Conan Brink to allow nesting of \c{%rep} directives.
1286
1287 \b If we're going to allow INT01 as an alias for INT1/ICEBP (one of
1288   Jules 0.98p3 changes), then we should allow INT03 as an alias for INT3
1289   as well.
1290
1291 \b Updated changes.asm to include the latest changes.
1292
1293 \b Tried to clean up the <CR>s that had snuck in from a DOS/Windows
1294   environment into my Unix environment, and try to make sure than
1295   DOS/Windows users get them back.
1296
1297 \b We would silently generate broken tools if insns.dat wasn't sorted
1298   properly.  Change insns.pl so that the order doesn't matter.
1299
1300 \b Fix bug in insns.pl (introduced by me) which would cause conditional
1301   instructions to have an extra "cc" in disassembly, e.g. "jnz"
1302   disassembled as "jccnz".
1303
1304
1305 \S{cl-0.98p3.2} Version 0.98p3.2
1306
1307 \b Merged in John S. Fine's changes from his 0.98-J4 prerelease; see
1308   http://www.csoft.net/cz/johnfine/
1309
1310 \b Changed previous "spotless" Makefile target (appropriate for distribution)
1311   to "distclean", and added "cleaner" target which is same as "clean"
1312   except deletes files generated by Perl scripts; "spotless" is union.
1313
1314 \b Removed BASIC programs from distribution.  Get a Perl interpreter
1315   instead (see below.)
1316
1317 \b Calling this "pre-release 3.2" rather than "p3-hpa2" because of
1318   John's contributions.
1319
1320 \b Actually link in the IEEE output format (zoutieee.c); fix a bunch of
1321   compiler warnings in that file.  Note I don't know what IEEE output
1322   is supposed to look like, so these changes were made "blind".
1323
1324
1325 \S{cl-0.98p3-hpa} Version 0.98p3-hpa
1326
1327 \b Merged nasm098p3.zip with nasm-0.97.tar.gz to create a fully
1328   buildable version for Unix systems (Makefile.in updates, etc.)
1329
1330 \b Changed insns.pl to create the instruction tables in nasm.h and
1331   names.c, so that a new instruction can be added by adding it *only*
1332   to insns.dat.
1333
1334 \b Added the following new instructions: SYSENTER, SYSEXIT, FXSAVE,
1335   FXRSTOR, UD1, UD2 (the latter two are two opcodes that Intel
1336   guarantee will never be used; one of them is documented as UD2 in
1337   Intel documentation, the other one just as "Undefined Opcode" --
1338   calling it UD1 seemed to make sense.)
1339
1340 \b MAX_SYMBOL was defined to be 9, but LOADALL286 and LOADALL386 are 10
1341   characters long.  Now MAX_SYMBOL is derived from insns.dat.
1342
1343 \b A note on the BASIC programs included: forget them.  insns.bas is
1344   already out of date.  Get yourself a Perl interpreter for your
1345   platform of choice at
1346   \W{http://www.cpan.org/ports/index.html}{http://www.cpan.org/ports/index.html}.
1347
1348
1349 \S{cl-0.98p3} Version 0.98 pre-release 3
1350
1351 \b added response file support, improved command line handling, new layout
1352 help screen
1353
1354 \b fixed limit checking bug, 'OUT byte nn, reg' bug, and a couple of rdoff
1355 related bugs, updated Wishlist; 0.98 Prerelease 3.
1356
1357
1358 \S{cl-0.98p2} Version 0.98 pre-release 2
1359
1360 \b fixed bug in outcoff.c to do with truncating section names longer
1361 than 8 characters, referencing beyond end of string; 0.98 pre-release 2
1362
1363
1364 \S{cl-0.98p1} Version 0.98 pre-release 1
1365
1366 \b Fixed a bug whereby STRUC didn't work at all in RDF.
1367
1368 \b Fixed a problem with group specification in PUBDEFs in OBJ.
1369
1370 \b Improved ease of adding new output formats. Contribution due to
1371 Fox Cutter.
1372
1373 \b Fixed a bug in relocations in the `bin' format: was showing up when
1374 a relocatable reference crossed an 8192-byte boundary in any output
1375 section.
1376
1377 \b Fixed a bug in local labels: local-label lookups were inconsistent
1378 between passes one and two if an EQU occurred between the definition
1379 of a global label and the subsequent use of a local label local to
1380 that global.
1381
1382 \b Fixed a seg-fault in the preprocessor (again) which happened when
1383 you use a blank line as the first line of a multi-line macro
1384 definition and then defined a label on the same line as a call to
1385 that macro.
1386
1387 \b Fixed a stale-pointer bug in the handling of the NASM environment
1388 variable. Thanks to Thomas McWilliams.
1389
1390 \b ELF had a hard limit on the number of sections which caused
1391 segfaults when transgressed. Fixed.
1392
1393 \b Added ability for ndisasm to read from stdin by using `-' as the
1394 filename.
1395
1396 \b ndisasm wasn't outputting the TO keyword. Fixed.
1397
1398 \b Fixed error cascade on bogus expression in \c{%if} - an error in
1399 evaluation was causing the entire \c{%if} to be discarded, thus creating
1400 trouble later when the \c{%else} or \c{%endif} was encountered.
1401
1402 \b Forward reference tracking was instruction-granular not operand-
1403 granular, which was causing 286-specific code to be generated
1404 needlessly on code of the form `shr word [forwardref],1'. Thanks to
1405 Jim Hague for sending a patch.
1406
1407 \b All messages now appear on stdout, as sending them to stderr serves
1408 no useful purpose other than to make redirection difficult.
1409
1410 \b Fixed the problem with EQUs pointing to an external symbol - this
1411 now generates an error message.
1412
1413 \b Allowed multiple size prefixes to an operand, of which only the first
1414 is taken into account.
1415
1416 \b Incorporated John Fine's changes, including fixes of a large number
1417 of preprocessor bugs, some small problems in OBJ, and a reworking of
1418 label handling to define labels before their line is assembled, rather
1419 than after.
1420
1421 \b Reformatted a lot of the source code to be more readable. Included
1422 'coding.txt' as a guideline for how to format code for contributors.
1423
1424 \b Stopped nested \c{%reps} causing a panic - they now cause a slightly more
1425 friendly error message instead.
1426
1427 \b Fixed floating point constant problems (patch by Pedro Gimeno)
1428
1429 \b Fixed the return value of insn_size() not being checked for -1, indicating
1430 an error.
1431
1432 \b Incorporated 3Dnow! instructions.
1433
1434 \b Fixed the 'mov eax, eax + ebx' bug.
1435
1436 \b Fixed the GLOBAL EQU bug in ELF. Released developers release 3.
1437
1438 \b Incorporated John Fine's command line parsing changes
1439
1440 \b Incorporated David Lindauer's OMF debug support
1441
1442 \b Made changes for LCC 4.0 support (\c{__NASM_CDecl__}, removed register size
1443 specification warning when sizes agree).
1444
1445
1446 \H{cl-0.9x} NASM 0.9 Series
1447
1448 Revisions before 0.98.
1449
1450
1451 \S{cl-0.97} Version 0.97 released December 1997
1452
1453 \b This was entirely a bug-fix release to 0.96, which seems to have got
1454 cursed. Silly me.
1455
1456 \b Fixed stupid mistake in OBJ which caused `MOV EAX,<constant>' to
1457 fail. Caused by an error in the `MOV EAX,<segment>' support.
1458
1459 \b ndisasm hung at EOF when compiled with lcc on Linux because lcc on
1460 Linux somehow breaks feof(). ndisasm now does not rely on feof().
1461
1462 \b A heading in the documentation was missing due to a markup error in
1463 the indexing. Fixed.
1464
1465 \b Fixed failure to update all pointers on realloc() within extended-
1466 operand code in parser.c. Was causing wrong behaviour and seg faults
1467 on lines such as `dd 0.0,0.0,0.0,0.0,...'
1468
1469 \b Fixed a subtle preprocessor bug whereby invoking one multi-line
1470 macro on the first line of the expansion of another, when the second
1471 had been invoked with a label defined before it, didn't expand the
1472 inner macro.
1473
1474 \b Added internal.doc back in to the distribution archives - it was
1475 missing in 0.96 *blush*
1476
1477 \b Fixed bug causing 0.96 to be unable to assemble its own test files,
1478 specifically objtest.asm. *blush again*
1479
1480 \b Fixed seg-faults and bogus error messages caused by mismatching
1481 \c{%rep} and \c{%endrep} within multi-line macro definitions.
1482
1483 \b Fixed a problem with buffer overrun in OBJ, which was causing
1484 corruption at ends of long PUBDEF records.
1485
1486 \b Separated DOS archives into main-program and documentation to reduce
1487 download size.
1488
1489
1490 \S{cl-0.96} Version 0.96 released November 1997
1491
1492 \b Fixed a bug whereby, if `nasm sourcefile' would cause a filename
1493 collision warning and put output into `nasm.out', then `nasm
1494 sourcefile -o outputfile' still gave the warning even though the
1495 `-o' was honoured.
1496 Fixed name pollution under Digital UNIX: one of its header files
1497 defined R_SP, which broke the enum in nasm.h.
1498
1499 \b Fixed minor instruction table problems: FUCOM and FUCOMP didn't have
1500 two-operand forms; NDISASM didn't recognise the longer register
1501 forms of PUSH and POP (eg FF F3 for PUSH BX); TEST mem,imm32 was
1502 flagged as undocumented; the 32-bit forms of CMOV had 16-bit operand
1503 size prefixes; `AAD imm' and `AAM imm' are no longer flagged as
1504 undocumented because the Intel Architecture reference documents
1505 them.
1506
1507 \b Fixed a problem with the local-label mechanism, whereby strange
1508 types of symbol (EQUs, auto-defined OBJ segment base symbols)
1509 interfered with the `previous global label' value and screwed up
1510 local labels.
1511
1512 \b Fixed a bug whereby the stub preprocessor didn't communicate with
1513 the listing file generator, so that the -a and -l options in
1514 conjunction would produce a useless listing file.
1515
1516 \b Merged `os2' object file format back into `obj', after discovering
1517 that `obj' _also_ shouldn't have a link pass separator in a module
1518 containing a non-trivial MODEND. Flat segments are now declared
1519 using the FLAT attribute. `os2' is no longer a valid object format
1520 name: use `obj'.
1521
1522 \b Removed the fixed-size temporary storage in the evaluator. Very very
1523 long expressions (like `mov ax,1+1+1+1+...' for two hundred 1s or
1524 so) should now no longer crash NASM.
1525
1526 \b Fixed a bug involving segfaults on disassembly of MMX instructions,
1527 by changing the meaning of one of the operand-type flags in nasm.h.
1528 This may cause other apparently unrelated MMX problems; it needs to
1529 be tested thoroughly.
1530
1531 \b Fixed some buffer overrun problems with large OBJ output files.
1532 Thanks to DJ Delorie for the bug report and fix.
1533
1534 \b Made preprocess-only mode actually listen to the \c{%line} markers as it
1535 prints them, so that it can report errors more sanely.
1536
1537 \b Re-designed the evaluator to keep more sensible track of expressions
1538 involving forward references: can now cope with previously-nightmare
1539 situations such as:
1540
1541 \c   mov ax,foo | bar
1542 \c   foo equ 1
1543 \c   bar equ 2
1544
1545 \b Added the ALIGN and ALIGNB standard macros.
1546
1547 \b Added PIC support in ELF: use of WRT to obtain the four extra
1548 relocation types needed.
1549
1550 \b Added the ability for output file formats to define their own
1551 extensions to the GLOBAL, COMMON and EXTERN directives.
1552
1553 \b Implemented common-variable alignment, and global-symbol type and
1554 size declarations, in ELF.
1555
1556 \b Implemented NEAR and FAR keywords for common variables, plus
1557 far-common element size specification, in OBJ.
1558
1559 \b Added a feature whereby EXTERNs and COMMONs in OBJ can be given a
1560 default WRT specification (either a segment or a group).
1561
1562 \b Transformed the Unix NASM archive into an auto-configuring package.
1563
1564 \b Added a sanity-check for people applying SEG to things which are
1565 already segment bases: this previously went unnoticed by the SEG
1566 processing and caused OBJ-driver panics later.
1567
1568 \b Added the ability, in OBJ format, to deal with `MOV EAX,<segment>'
1569 type references: OBJ doesn't directly support dword-size segment
1570 base fixups, but as long as the low two bytes of the constant term
1571 are zero, a word-size fixup can be generated instead and it will
1572 work.
1573
1574 \b Added the ability to specify sections' alignment requirements in
1575 Win32 object files and pure binary files.
1576
1577 \b Added preprocess-time expression evaluation: the \c{%assign} (and
1578 \c{%iassign}) directive and the bare \c{%if} (and \c{%elif}) conditional. Added
1579 relational operators to the evaluator, for use only in \c{%if}
1580 constructs: the standard relationals = < > <= >= <> (and C-like
1581 synonyms == and !=) plus low-precedence logical operators &&, ^^ and
1582 ||.
1583
1584 \b Added a preprocessor repeat construct: \c{%rep} / \c{%exitrep} / \c{%endrep}.
1585
1586 \b Added the __FILE__ and __LINE__ standard macros.
1587
1588 \b Added a sanity check for number constants being greater than
1589 0xFFFFFFFF. The warning can be disabled.
1590
1591 \b Added the %0 token whereby a variadic multi-line macro can tell how
1592 many parameters it's been given in a specific invocation.
1593
1594 \b Added \c{%rotate}, allowing multi-line macro parameters to be cycled.
1595
1596 \b Added the `*' option for the maximum parameter count on multi-line
1597 macros, allowing them to take arbitrarily many parameters.
1598
1599 \b Added the ability for the user-level forms of EXTERN, GLOBAL and
1600 COMMON to take more than one argument.
1601
1602 \b Added the IMPORT and EXPORT directives in OBJ format, to deal with
1603 Windows DLLs.
1604
1605 \b Added some more preprocessor \c{%if} constructs: \c{%ifidn} / \c{%ifidni} (exact
1606 textual identity), and \c{%ifid} / \c{%ifnum} / \c{%ifstr} (token type testing).
1607
1608 \b Added the ability to distinguish SHL AX,1 (the 8086 version) from
1609 SHL AX,BYTE 1 (the 286-and-upwards version whose constant happens to
1610 be 1).
1611
1612 \b Added NetBSD/FreeBSD/OpenBSD's variant of a.out format, complete
1613 with PIC shared library features.
1614
1615 \b Changed NASM's idiosyncratic handling of FCLEX, FDISI, FENI, FINIT,
1616 FSAVE, FSTCW, FSTENV, and FSTSW to bring it into line with the
1617 otherwise accepted standard. The previous behaviour, though it was a
1618 deliberate feature, was a deliberate feature based on a
1619 misunderstanding. Apologies for the inconvenience.
1620
1621 \b Improved the flexibility of ABSOLUTE: you can now give it an
1622 expression rather than being restricted to a constant, and it can
1623 take relocatable arguments as well.
1624
1625 \b Added the ability for a variable to be declared as EXTERN multiple
1626 times, and the subsequent definitions are just ignored.
1627
1628 \b We now allow instruction prefixes (CS, DS, LOCK, REPZ etc) to be
1629 alone on a line (without a following instruction).
1630
1631 \b Improved sanity checks on whether the arguments to EXTERN, GLOBAL
1632 and COMMON are valid identifiers.
1633
1634 \b Added misc/exebin.mac to allow direct generation of .EXE files by
1635 hacking up an EXE header using DB and DW; also added test/binexe.asm
1636 to demonstrate the use of this. Thanks to Yann Guidon for
1637 contributing the EXE header code.
1638
1639 \b ndisasm forgot to check whether the input file had been successfully
1640 opened. Now it does. Doh!
1641
1642 \b Added the Cyrix extensions to the MMX instruction set.
1643
1644 \b Added a hinting mechanism to allow [EAX+EBX] and [EBX+EAX] to be
1645 assembled differently. This is important since [ESI+EBP] and
1646 [EBP+ESI] have different default base segment registers.
1647
1648 \b Added support for the PharLap OMF extension for 4096-byte segment
1649 alignment.
1650
1651
1652 \S{cl-0.95 released July 1997} Version 0.95 released July 1997
1653
1654 \b Fixed yet another ELF bug. This one manifested if the user relied on
1655 the default segment, and attempted to define global symbols without
1656 first explicitly declaring the target segment.
1657
1658 \b Added makefiles (for NASM and the RDF tools) to build Win32 console
1659 apps under Symantec C++. Donated by Mark Junker.
1660
1661 \b Added `macros.bas' and `insns.bas', QBasic versions of the Perl
1662 scripts that convert `standard.mac' to `macros.c' and convert
1663 `insns.dat' to `insnsa.c' and `insnsd.c'. Also thanks to Mark
1664 Junker.
1665
1666 \b Changed the diassembled forms of the conditional instructions so
1667 that JB is now emitted as JC, and other similar changes. Suggested
1668 list by Ulrich Doewich.
1669
1670 \b Added `@' to the list of valid characters to begin an identifier
1671 with.
1672
1673 \b Documentary changes, notably the addition of the `Common Problems'
1674 section in nasm.doc.
1675
1676 \b Fixed a bug relating to 32-bit PC-relative fixups in OBJ.
1677
1678 \b Fixed a bug in perm_copy() in labels.c which was causing exceptions
1679 in cleanup_labels() on some systems.
1680
1681 \b Positivity sanity check in TIMES argument changed from a warning to
1682 an error following a further complaint.
1683
1684 \b Changed the acceptable limits on byte and word operands to allow
1685 things like `~10111001b' to work.
1686
1687 \b Fixed a major problem in the preprocessor which caused seg-faults if
1688 macro definitions contained blank lines or comment-only lines.
1689
1690 \b Fixed inadequate error checking on the commas separating the
1691 arguments to `db', `dw' etc.
1692
1693 \b Fixed a crippling bug in the handling of macros with operand counts
1694 defined with a `+' modifier.
1695
1696 \b Fixed a bug whereby object file formats which stored the input file
1697 name in the output file (such as OBJ and COFF) weren't doing so
1698 correctly when the output file name was specified on the command
1699 line.
1700
1701 \b Removed [INC] and [INCLUDE] support for good, since they were
1702 obsolete anyway.
1703
1704 \b Fixed a bug in OBJ which caused all fixups to be output in 16-bit
1705 (old-format) FIXUPP records, rather than putting the 32-bit ones in
1706 FIXUPP32 (new-format) records.
1707
1708 \b Added, tentatively, OS/2 object file support (as a minor variant on
1709 OBJ).
1710
1711 \b Updates to Fox Cutter's Borland C makefile, Makefile.bc2.
1712
1713 \b Removed a spurious second fclose() on the output file.
1714
1715 \b Added the `-s' command line option to redirect all messages which
1716 would go to stderr (errors, help text) to stdout instead.
1717
1718 \b Added the `-w' command line option to selectively suppress some
1719 classes of assembly warning messages.
1720
1721 \b Added the `-p' pre-include and `-d' pre-define command-line options.
1722
1723 \b Added an include file search path: the `-i' command line option.
1724
1725 \b Fixed a silly little preprocessor bug whereby starting a line with a
1726 `%!' environment-variable reference caused an `unknown directive'
1727 error.
1728
1729 \b Added the long-awaited listing file support: the `-l' command line
1730 option.
1731
1732 \b Fixed a problem with OBJ format whereby, in the absence of any
1733 explicit segment definition, non-global symbols declared in the
1734 implicit default segment generated spurious EXTDEF records in the
1735 output.
1736
1737 \b Added the NASM environment variable.
1738
1739 \b From this version forward, Win32 console-mode binaries will be
1740 included in the DOS distribution in addition to the 16-bit binaries.
1741 Added Makefile.vc for this purpose.
1742
1743 \b Added `return 0;' to test/objlink.c to prevent compiler warnings.
1744
1745 \b Added the __NASM_MAJOR__ and __NASM_MINOR__ standard defines.
1746
1747 \b Added an alternative memory-reference syntax in which prefixing an
1748 operand with `&' is equivalent to enclosing it in square brackets,
1749 at the request of Fox Cutter.
1750
1751 \b Errors in pass two now cause the program to return a non-zero error
1752 code, which they didn't before.
1753
1754 \b Fixed the single-line macro cycle detection, which didn't work at
1755 all on macros with no parameters (caused an infinite loop). Also
1756 changed the behaviour of single-line macro cycle detection to work
1757 like cpp, so that macros like `extrn' as given in the documentation
1758 can be implemented.
1759
1760 \b Fixed the implementation of WRT, which was too restrictive in that
1761 you couldn't do `mov ax,[di+abc wrt dgroup]' because (di+abc) wasn't
1762 a relocatable reference.
1763
1764
1765 \S{cl-0.94 released April 1997} Version 0.94 released April 1997
1766
1767
1768 \b Major item: added the macro processor.
1769
1770 \b Added undocumented instructions SMI, IBTS, XBTS and LOADALL286. Also
1771 reorganised CMPXCHG instruction into early-486 and Pentium forms.
1772 Thanks to Thobias Jones for the information.
1773
1774 \b Fixed two more stupid bugs in ELF, which were causing `ld' to
1775 continue to seg-fault in a lot of non-trivial cases.
1776
1777 \b Fixed a seg-fault in the label manager.
1778
1779 \b Stopped FBLD and FBSTP from _requiring_ the TWORD keyword, which is
1780 the only option for BCD loads/stores in any case.
1781
1782 \b Ensured FLDCW, FSTCW and FSTSW can cope with the WORD keyword, if
1783 anyone bothers to provide it. Previously they complained unless no
1784 keyword at all was present.
1785
1786 \b Some forms of FDIV/FDIVR and FSUB/FSUBR were still inverted: a
1787 vestige of a bug that I thought had been fixed in 0.92. This was
1788 fixed, hopefully for good this time...
1789
1790 \b Another minor phase error (insofar as a phase error can _ever_ be
1791 minor) fixed, this one occurring in code of the form
1792
1793 \c   rol ax,forward_reference
1794 \c   forward_reference equ 1
1795
1796 \b The number supplied to TIMES is now sanity-checked for positivity,
1797 and also may be greater than 64K (which previously didn't work on
1798 16-bit systems).
1799
1800 \b Added Watcom C makefiles, and misc/pmw.bat, donated by Dominik Behr.
1801
1802 \b Added the INCBIN pseudo-opcode.
1803
1804 \b Due to the advent of the preprocessor, the [INCLUDE] and [INC]
1805 directives have become obsolete. They are still supported in this
1806 version, with a warning, but won't be in the next.
1807
1808 \b Fixed a bug in OBJ format, which caused incorrect object records to
1809 be output when absolute labels were made global.
1810
1811 \b Updates to RDOFF subdirectory, and changes to outrdf.c.
1812
1813
1814 \S{cl-0.93 released January 1997} Version 0.93 released January 1997
1815
1816 This release went out in a great hurry after semi-crippling bugs
1817 were found in 0.92.
1818
1819 \b Really \e{did} fix the stack overflows this time. *blush*
1820
1821 \b Had problems with EA instruction sizes changing between passes, when
1822 an offset contained a forward reference and so 4 bytes were
1823 allocated for the offset in pass one; by pass two the symbol had
1824 been defined and happened to be a small absolute value, so only 1
1825 byte got allocated, causing instruction size mismatch between passes
1826 and hence incorrect address calculations. Fixed.
1827
1828 \b Stupid bug in the revised ELF section generation fixed (associated
1829 string-table section for .symtab was hard-coded as 7, even when this
1830 didn't fit with the real section table). Was causing `ld' to
1831 seg-fault under Linux.
1832
1833 \b Included a new Borland C makefile, Makefile.bc2, donated by Fox
1834 Cutter <lmb@comtch.iea.com>.
1835
1836
1837 \S{cl-0.92 released January 1997} Version 0.92 released January 1997
1838
1839 \b The FDIVP/FDIVRP and FSUBP/FSUBRP pairs had been inverted: this was
1840 fixed. This also affected the LCC driver.
1841
1842 \b Fixed a bug regarding 32-bit effective addresses of the form
1843 \c{[other_register+ESP]}.
1844
1845 \b Documentary changes, notably documentation of the fact that Borland
1846 Win32 compilers use `obj' rather than `win32' object format.
1847
1848 \b Fixed the COMENT record in OBJ files, which was formatted
1849 incorrectly.
1850
1851 \b Fixed a bug causing segfaults in large RDF files.
1852
1853 \b OBJ format now strips initial periods from segment and group
1854 definitions, in order to avoid complications with the local label
1855 syntax.
1856
1857 \b Fixed a bug in disassembling far calls and jumps in NDISASM.
1858
1859 \b Added support for user-defined sections in COFF and ELF files.
1860
1861 \b Compiled the DOS binaries with a sensible amount of stack, to
1862 prevent stack overflows on any arithmetic expression containing
1863 parentheses.
1864
1865 \b Fixed a bug in handling of files that do not terminate in a newline.
1866
1867
1868 \S{cl-0.91 released November 1996} Version 0.91 released November 1996
1869
1870 \b Loads of bug fixes.
1871
1872 \b Support for RDF added.
1873
1874 \b Support for DBG debugging format added.
1875
1876 \b Support for 32-bit extensions to Microsoft OBJ format added.
1877
1878 \b Revised for Borland C: some variable names changed, makefile added.
1879
1880 \b LCC support revised to actually work.
1881
1882 \b JMP/CALL NEAR/FAR notation added.
1883
1884 \b `a16', `o16', `a32' and `o32' prefixes added.
1885
1886 \b Range checking on short jumps implemented.
1887
1888 \b MMX instruction support added.
1889
1890 \b Negative floating point constant support added.
1891
1892 \b Memory handling improved to bypass 64K barrier under DOS.
1893
1894 \b \c{$} prefix to force treatment of reserved words as identifiers added.
1895
1896 \b Default-size mechanism for object formats added.
1897
1898 \b Compile-time configurability added.
1899
1900 \b \c{#}, \c{@}, \c{~} and c\{?} are now valid characters in labels.
1901
1902 \b \c{-e} and \c{-k} options in NDISASM added.
1903
1904
1905 \S{cl-0.90 released October 1996} Version 0.90 released October 1996
1906
1907 First release version. First support for object file output. Other
1908 changes from previous version (0.3x) too numerous to document.