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