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