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