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