mirror/nasm
2
0
Fork 0
mirror of https://github.com/netwide-assembler/nasm.git synced 2025-03-31 18:20:22 +08:00
Code Issues Packages Projects Releases Wiki Activity

Document __PASS__

Browse Source 
Document __PASS__, but discourage users from using it.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
This commit is contained in:
H. Peter Anvin 2008-09-24 17:34:37 -07:00
parent 7383b407d9
commit 010aee270f
2 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/changes.src
View File

@ -35,6 +35,9 @@ since 2007.
\b New \c{%unmacro} directive to undeclare a multi-line macro.
See \k{unmacro}.
\b Builtin macro \c{__PASS__} which expands to the current assembly pass.
See \k{pass_macro}.
\b \c{__utf16__} and \c{__utf32__} operators to generate UTF-16 and UTF-32
strings. See \k{unicode}.

13
doc/nasmdoc.src
View File

@ -3670,6 +3670,19 @@ For example, if the \c{altreg} package is included (see
\k{pkg_altreg}), then the macro \c{__USE_ALTREG__} is defined.
\S{pass_macro} \i\c{__PASS__}: Assembly Pass
The macro \c{__PASS__} is defined to be \c{1} on preparatory passes,
and \c{2} on the final pass. In preprocess-only mode, it is set to
\c{2} (there being only the final pass); when running only to generate
dependencies (due to the \c{-M} or \c{-MG} option, see \k{opt-M}) it
is set to \c{0}.
\e{Avoid using this macro if at all possible. It is tremendously easy
to generate very strange errors by misusing it, and the semantics may
change in future versions of NASM.}
\S{struc} \i\c{STRUC} and \i\c{ENDSTRUC}: \i{Declaring Structure} Data Types
The core of NASM contains no intrinsic means of defining data