scitech.txt

   1
   2                         The Netwide Assembler: NASM
   3                         ===========================
   4
   5 --------------------------------------------------------------------------------
   6                          SciTech MGL Modifications
   7 --------------------------------------------------------------------------------
   8
   9 All changes can be compiled in and out using the TASM_COMPAT macros,
  10 and when compiled without TASM_COMPAT defined we get the exact same
  11 binary as the unmodified 0.98 sources.
  12
  13 standard.mac:
  14 macros.c:
  15  . Added macros to ignore TASM directives before first include
  16
  17 nasm.h:
  18  . Added extern declaration for tasm_compatible_mode
  19
  20 nasm.c:
  21  . Added global variable tasm_compatible_mode
  22  . Added command line switch for TASM compatible mode (-t)
  23  . Changed version command line to reflect when compiled with TASM additions
  24  . Added response file processing to allow all arguments on a single
  25    line (response file is @resp rather than -@resp for NASM format).
  26
  27 labels.c:
  28  . Changes islocal() macro to support TASM style @@local labels.
  29  . Added islocalchar() macro to support TASM style @@local labels.
  30
  31 parser.c:
  32  . Added support for TASM style memory references (ie: mov [DWORD eax],10
  33    rather than the NASM style mov DWORD [eax],10).
  34
  35 preproc.c:
  36  . Added new directives, %arg, %local, %stacksize to directives table
  37  . Added support for TASM style directives without a leading % symbol.
  38
  39 --------------------------------------------------------------------------------
  40     Integrated a block of changes from Andrew Zabolotny <bit@eltech.ru>:
  41 --------------------------------------------------------------------------------
  42
  43 -*- A new keyword %xdefine and its case-insensitive counterpart %ixdefine.
  44     They work almost the same way as %define and %idefine but expand
  45     the definition immediately, not on the invocation. Something like a cross
  46     between %define and %assign. The "x" suffix stands for "eXpand", so
  47     "xdefine" can be deciphered as "expand-and-define". Thus you can do
  48     things like this:
  49
  50         %assign ofs     0
  51
  52         %macro  arg     1
  53                 %xdefine %1 dword [esp+ofs]
  54                 %assign ofs ofs+4
  55         %endmacro
  56
  57 -*- Changed the place where the expansion of %$name macros are expanded.
  58     Now they are converted into ..@ctxnum.name form when detokenizing, so
  59     there are no quirks as before when using %$name arguments to macros,
  60     in macros etc. For example:
  61
  62         %macro  abc     1
  63                 %define %1 hello
  64         %endm
  65
  66         abc     %$here
  67         %$here
  68
  69     Now last line will be expanded into "hello" as expected. This also allows
  70     for lots of goodies, a good example are extended "proc" macros included
  71     in this archive.
  72
  73 -*- Added a check for "cstk" in smacro_defined() before calling get_ctx() -
  74     this allows for things like:
  75
  76         %ifdef %$abc
  77         %endif
  78
  79     to work without warnings even in no context.
  80
  81 -*- Added a check for "cstk" in %if*ctx and %elif*ctx directives -
  82     this allows to use %ifctx without excessive warnings. If there is
  83     no active context, %ifctx goes through "false" branch.
  84
  85 -*- Removed "user error: " prefix with %error directive: it just clobbers the
  86     output and has absolutely no functionality. Besides, this allows to write
  87     macros that does not differ from built-in functions in any way.
  88
  89 -*- Added expansion of string that is output by %error directive. Now you
  90     can do things like:
  91
  92         %define hello(x) Hello, x!
  93
  94         %define %$name andy
  95         %error "hello(%$name)"
  96
  97     Same happened with %include directive.
  98
  99 -*- Now all directives that expect an identifier will try to expand and
 100     concatenate everything without whitespaces in between before usage.
 101     For example, with "unfixed" nasm the commands
 102
 103         %define %$abc hello
 104         %define __%$abc goodbye
 105         __%$abc
 106
 107     would produce "incorrect" output: last line will expand to
 108
 109         hello goodbyehello
 110
 111     Not quite what you expected, eh? :-) The answer is that preprocessor
 112     treats the %define construct as if it would be
 113
 114         %define __ %$abc goodbye
 115
 116     (note the white space between __ and %$abc). After my "fix" it
 117     will "correctly" expand into
 118
 119         goodbye
 120
 121     as expected. Note that I use quotes around words "correct", "incorrect"
 122     etc because this is rather a feature not a bug; however current behaviour
 123     is more logical (and allows more advanced macro usage :-).
 124
 125     Same change was applied to:
 126         %push,%macro,%imacro,%define,%idefine,%xdefine,%ixdefine,
 127         %assign,%iassign,%undef
 128
 129 -*- A new directive [WARNING {+|-}warning-id] have been added. It works only
 130     if the assembly phase is enabled (i.e. it doesn't work with nasm -e).
 131
 132 -*- A new warning type: macro-selfref. By default this warning is disabled;
 133     when enabled NASM warns when a macro self-references itself; for example
 134     the following source:
 135
 136         [WARNING macro-selfref]
 137
 138         %macro          push    1-*
 139                 %rep    %0
 140                         push    %1
 141                         %rotate 1
 142                 %endrep
 143         %endmacro
 144
 145                         push    eax,ebx,ecx
 146
 147     will produce a warning, but if we remove the first line we won't see it
 148     anymore (which is The Right Thing To Do {tm} IMHO since C preprocessor
 149     eats such constructs without warnings at all).
 150
 151 -*- Added a "error" routine to preprocessor which always will set ERR_PASS1
 152     bit in severity_code. This removes annoying repeated errors on first
 153     and second passes from preprocessor.
 154
 155 -*- Added the %+ operator in single-line macros for concatenating two
 156     identifiers. Usage example:
 157
 158         %define _myfunc _otherfunc
 159         %define cextern(x) _ %+ x
 160         cextern (myfunc)
 161
 162     After first expansion, third line will become "_myfunc". After this
 163     expansion is performed again so it becomes "_otherunc".
 164
 165 -*- Now if preprocessor is in a non-emmitting state, no warning or error
 166     will be emmitted. Example:
 167
 168         %if 1
 169                 mov     eax,ebx
 170         %else
 171                 put anything you want between these two brackets,
 172                 even macro-parameter references %1 or local labels %$zz
 173                 or macro-local labels %%zz - no warning will be emmitted.
 174         %endif
 175
 176 -*- Context-local variables on expansion as a last resort are looked up
 177     in outer contexts. For example, the following piece:
 178
 179         %push   outer
 180         %define %$a [esp]
 181
 182                 %push   inner
 183                 %$a
 184                 %pop
 185         %pop
 186
 187     will expand correctly the fourth line to [esp]; if we'll define another
 188     %$a inside the "inner" context, it will take precedence over outer
 189     definition. However, this modification has been applied only to
 190     expand_smacro and not to smacro_define: as a consequence expansion
 191     looks in outer contexts, but %ifdef won't look in outer contexts.
 192
 193     This behaviour is needed because we don't want nested contexts to
 194     act on already defined local macros. Example:
 195
 196         %define %$arg1  [esp+4]
 197         test    eax,eax
 198         if      nz
 199                 mov     eax,%$arg1
 200         endif
 201
 202     In this example the "if" mmacro enters into the "if" context, so %$arg1
 203     is not valid anymore inside "if". Of course it could be worked around
 204     by using explicitely %$$arg1 but this is ugly IMHO.
 205
 206 -*- Fixed memory leak in %undef. The origline wasn't freed before
 207     exiting on success.
 208
 209 -*- Fixed trap in preprocessor when line expanded to empty set of tokens.
 210     This happens, for example, in the following case:
 211
 212         #define SOMETHING
 213         SOMETHING