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