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