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