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