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