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