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