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