nasm-cvs Mailing List for The Netwide Assembler (Page 153)

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/nasm/nasm/doc
In directory usw-pr-cvs1:/tmp/cvs-serv31884/nasm/doc

Modified Files:
	nasmdoc.src 
Log Message:



Index: nasmdoc.src
===================================================================
RCS file: /cvsroot/nasm/nasm/doc/nasmdoc.src,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -d -r1.27 -r1.28

--- nasmdoc.src	6 May 2002 22:04:10 -0000	1.27
+++ nasmdoc.src	9 May 2002 21:23:55 -0000	1.28
@@ -253,38 +253,38 @@
 If you want to report a bug, please read \k{bugs} first.
 
 NASM has a \i{WWW page} at
-\W{http://www.web-sites.co.uk/nasm}\c{http://www.web-sites.co.uk/nasm}.
+\W{http://www.web-sites.co.uk/nasm}\c{http://www.web-sites.co.uk/nasm},
+and another, with additional information, at
+\W{http://nasm.2y.net/}\c{http://nasm.2y.net/}
 
 The original authors are \i{e\-mail}able as
 \W{mailto:ju...@ds...}\c{ju...@ds...} and
 \W{mailto:an...@po...}\c{an...@po...}.
 The latter is no longer involved in the development team.
 
-\i{New releases} of NASM are uploaded to the official site 
-\W{http://www.web-sites.co.uk/nasm}\c{http://www.web-sites.co.uk/nasm},
+\i{New releases} of NASM are uploaded to the official sites 
+\W{http://www.web-sites.co.uk/nasm}\c{http://www.web-sites.co.uk/nasm}
 and to
 \W{ftp://ftp.kernel.org/pub/software/devel/nasm/}\i\c{ftp.kernel.org}
 and 
 \W{ftp://ibiblio.org/pub/Linux/devel/lang/assemblers/}\i\c{ibiblio.org}.
-\# \W{ftp://ftp.simtel.net/pub/simtelnet/msdos/asmutl/}\i\c{ftp.simtel.net}
-\# and
-\# \W{ftp://ftp.coast.net/coast/msdos/asmutil/}\i\c{ftp.coast.net}.
 
 Announcements are posted to
 \W{news:comp.lang.asm.x86}\i\c{comp.lang.asm.x86},
 \W{news:alt.lang.asm}\i\c{alt.lang.asm} and
 \W{news:comp.os.linux.announce}\i\c{comp.os.linux.announce}
-\#  and
-\# \W{news:comp.archives.msdos.announce}\i\c{comp.archives.msdos.announce}
-\# (the last one is done automagically by uploading to
-\# \W{ftp://ftp.simtel.net/pub/simtelnet/msdos/asmutl/}\c{ftp.simtel.net}).
 
 If you want information about NASM beta releases, and the current
-development status, please subscribe to the \i\c{nasm-devel} email lists
+development status, please subscribe to the \i\c{nasm-devel} email list
 by registering at
-\W{http://groups.yahoo.com/group/nasm-devel}\c{http://groups.yahoo.com/group/nasm-devel}
-and
+\W{http://groups.yahoo.com/group/nasm-devel}\c{http://groups.yahoo.com/group/nasm-devel},
 \W{http://www.pairlist.net/mailman/listinfo/nasm-devel}\c{http://www.pairlist.net/mailman/listinfo/nasm-devel}
+and
+\W{http://sourceforge.net/projects/nasm}\c{http://sourceforge.net/projects/nasm}.
+
+The preferred list is the list at Sourceforge, which is also the home to
+the latest nasm source code and releases. The other lists are open, but
+may not continue to be supported in the long term.
 
 
 \H{install} Installation
@@ -784,9 +784,9 @@
 value \c{!-s!-ic:\\nasmlib} is equivalent to setting it to \c{-s
 -ic:\\nasmlib}, but \c{!-dNAME="my name"} will work.
 
-This variable was called \c{NASM} in earlier versions of NASM,
-however, this caused problems with makefiles which used a \c{$(NASM)}
-variable.
+This environment variable was previously called \c{NASM}. This was
+changed with version 0.98.31.
+
 
 \H{qstart} \i{Quick Start} for \i{MASM} Users
 
@@ -1676,14 +1676,52 @@
 the NASM command line: see \k{opt-d}.
 
 
+\S{concat%+} Concatenating Single Line Macro Tokens: \i\c{%+}
+
+Individual tokens in single line macros can be concatenated, to produce
+longer tokens for later processing. This can be useful if there are
+several similar macros that perform simlar functions.
+
+As an example, consider the following:
+
+\c %define BDASTART 400h                   ; Start of BIOS data area
+
+\c struc tBIOSDA                           ; its structure
+\c       .COM1addr       RESW    1
+\c       .COM2addr       RESW    1
+\c       ; ..and so on
+\c endstruc
+
+Now, if we need to access the elements of tBIOSDA in different places,
+we can end up with:
+
+\c        mov     ax,BDASTART + tBIOSDA.COM1addr
+\c        mov     bx,BDASTART + tBIOSDA.COM2addr
+
+This will become pretty ugly (and tedious) if used in many places, and
+can be reduced in size significantly by using the following macro:
+
+\c ; Macro to access BIOS variables by their names (from tBDA):
+
+\c %define BDA(x) BDASTART + tBIOSDA. %+ x
+
+Now the above code can be written as:
+
+\c        mov     ax,BDA(COM1addr)
+\c        mov     bx,BDA(COM2addr)
+
+Using this feature, we can simplify references to a lot of macros (and,
+in turn, reduce typing errors).
+
+
 \S{undef} Undefining macros: \i\c{%undef}
 
 Single-line macros can be removed with the \c{%undef} command.  For
 example, the following sequence:
 
 \c %define foo bar
-\c %undef foo
-\c 		mov eax, foo
+\c %undef  foo
+\c                 mov eax, foo
 
 will expand to the instruction \c{mov eax, foo}, since after
 \c{%undef} the macro \c{foo} is no longer defined.
@@ -1776,8 +1814,8 @@
 
 \c %macro prologue 1
 \c           push ebp
-\c           mov ebp,esp
-\c           sub esp,%1
+\c           mov  ebp,esp
+\c           sub  esp,%1
 \c %endmacro
 
 This defines a C-like function prologue as a macro: so you would
@@ -1788,8 +1826,8 @@
 which would expand to the three lines of code
 
 \c myfunc:   push ebp
-\c           mov ebp,esp
-\c           sub esp,12
+\c           mov  ebp,esp
+\c           sub  esp,12
 
 The number \c{1} after the macro name in the \c{%macro} line defines
 the number of parameters the macro \c{prologue} expects to receive.
@@ -5631,8 +5669,9 @@
 bugs. That doesn't usually stop there being plenty we didn't know
 about, though. Any that you find should be reported firstly via the
 \i\c{bugtracker} at
-\W{http://nasm.2y.net/bugtracker/}\c{http://nasm.2y.net/bugtracker/},
-or if that fails then through one of the contacts in \k{contact}
+\W{https://sourceforge.net/projects/nasm/}\c{https://sourceforge.net/projects/nasm/}
+(click on "Bugs"), or if that fails then through one of the
+contacts in \k{contact}.
 
 Please read \k{qstart} first, and don't report the bug if it's
 listed in there as a deliberate feature. (If you think the feature
@@ -5909,7 +5948,7 @@
 one anyway. You have been warned.
 
 
-\A{iref} Intel x86 Instruction Reference
+\A{iref} x86 Instruction Reference
 
 This appendix provides a complete list of the machine instructions
 which NASM will assemble, and a short description of the function of
@@ -5918,7 +5957,7 @@
 It is not intended to be exhaustive documentation on the fine
 details of the instructions' function, such as which exceptions they
 can trigger: for such documentation, you should go to Intel's Web
-site, \W{http://www.intel.com/}\c{http://www.intel.com/}.
+site, \W{http://developer.intel.com/design/Pentium4/manuals/}\c{http://developer.intel.com/design/Pentium4/manuals/}.
 
 Instead, this appendix is intended primarily to provide
 documentation on the way the instructions may be used within NASM.
@@ -12065,13 +12104,13 @@
 
 \b The \c{EIP} register is copied into the \c{ECX} register.
 
-\b Bits [310] of the 64-bit SYSCALL/SYSRET Target Address Register
+\b Bits [31-0] of the 64-bit SYSCALL/SYSRET Target Address Register
 (\c{STAR}) are copied into the \c{EIP} register.
 
-\b Bits [4732] of the \c{STAR} register specify the selector that is
+\b Bits [47-32] of the \c{STAR} register specify the selector that is
 copied into the \c{CS} register.
 
-\b Bits [4732]+1000b of the \c{STAR} register specify the selector that
+\b Bits [47-32]+1000b of the \c{STAR} register specify the selector that
 is copied into the SS register.
 
 The \c{CS} and \c{SS} registers should not be modified by the operating
@@ -12126,7 +12165,7 @@
 \c{CS} or \c{(E)IP}. If you need to return to the calling code, you
 need to write your code to cater for this.
 
-For more information, see the Intel Architecture Software Developers
+For more information, see the Intel Architecture Software Developer's
 Manual, Volume 2.
 
 
@@ -12184,14 +12223,14 @@
 after the corresponding \c{SYSCALL} instruction, is copied into the \c{EIP}
 register.
 
-\b Bits [6348] of the \c{STAR} register specify the selector that is copied
+\b Bits [63-48] of the \c{STAR} register specify the selector that is copied
 into the \c{CS} register.
 
-\b Bits [6348]+1000b of the \c{STAR} register specify the selector that is
+\b Bits [63-48]+1000b of the \c{STAR} register specify the selector that is
 copied into the \c{SS} register.
 
-\b Bits [10] of the \c{SS} register are set to 11b (RPL of 3) regardless of
-the value of bits [4948] of the \c{STAR} register.
+\b Bits [1-0] of the \c{SS} register are set to 11b (RPL of 3) regardless of
+the value of bits [49-48] of the \c{STAR} register.
 
 The \c{CS} and \c{SS} registers should not be modified by the operating
 system between the execution of the \c{SYSCALL} instruction and its






2002	Jan	Feb	Mar	Apr	May (208)	Jun (43)	Jul	Aug (2)	Sep (17)	Oct	Nov (4)	Dec (9)
2003	Jan	Feb (11)	Mar (3)	Apr (2)	May	Jun (3)	Jul (29)	Aug (29)	Sep (48)	Oct	Nov	Dec (5)
2004	Jan (1)	Feb	Mar	Apr	May	Jun	Jul	Aug	Sep	Oct	Nov	Dec (1)
2005	Jan (12)	Feb (1)	Mar (1)	Apr	May (1)	Jun (2)	Jul	Aug	Sep (4)	Oct (3)	Nov (1)	Dec (2)
2006	Jan (1)	Feb (2)	Mar (1)	Apr	May (1)	Jun	Jul	Aug (1)	Sep (2)	Oct (21)	Nov (25)	Dec (16)
2007	Jan (26)	Feb (26)	Mar (18)	Apr (51)	May (45)	Jun (26)	Jul (6)	Aug (85)	Sep (161)	Oct (111)	Nov (83)	Dec (18)
2008	Jan (31)	Feb (27)	Mar	Apr (16)	May (142)	Jun (136)	Jul (51)	Aug (21)	Sep (47)	Oct (428)	Nov (19)	Dec (6)
2009	Jan (11)	Feb (37)	Mar (17)	Apr (15)	May (13)	Jun (61)	Jul (127)	Aug (15)	Sep (22)	Oct (28)	Nov (37)	Dec (10)
2010	Jan (18)	Feb (22)	Mar (10)	Apr (41)	May	Jun (48)	Jul (61)	Aug (54)	Sep (34)	Oct (15)	Nov (49)	Dec (11)
2011	Jan	Feb (24)	Mar (10)	Apr (9)	May	Jun (33)	Jul (41)	Aug (20)	Sep	Oct	Nov	Dec
2012	Jan	Feb (86)	Mar (12)	Apr	May (10)	Jun	Jul (9)	Aug (4)	Sep (11)	Oct (3)	Nov (3)	Dec (10)
2013	Jan (1)	Feb (23)	Mar (15)	Apr (7)	May (20)	Jun (3)	Jul (15)	Aug	Sep (29)	Oct (16)	Nov (69)	Dec (18)
2014	Jan	Feb (8)	Mar	Apr	May (16)	Jun (7)	Jul	Aug (5)	Sep (2)	Oct (4)	Nov (25)	Dec (8)
2015	Jan (6)	Feb (6)	Mar	Apr (1)	May (2)	Jun (1)	Jul (7)	Aug	Sep (2)	Oct (1)	Nov (6)	Dec
2016	Jan (12)	Feb (97)	Mar (57)	Apr (52)	May (33)	Jun (1)	Jul (1)	Aug	Sep	Oct (3)	Nov (3)	Dec
2017	Jan (4)	Feb	Mar (23)	Apr (5)	May	Jun (2)	Jul (3)	Aug (2)	Sep	Oct (6)	Nov (3)	Dec (3)
2018	Jan (4)	Feb (11)	Mar	Apr (1)	May (3)	Jun (6)	Jul	Aug (5)	Sep (5)	Oct (36)	Nov (128)	Dec (18)
2019	Jan	Feb	Mar (1)	Apr (1)	May	Jun	Jul	Aug	Sep	Oct	Nov	Dec
2020	Jan	Feb	Mar	Apr	May (24)	Jun	Jul	Aug	Sep	Oct	Nov	Dec

nasm-cvs Mailing List for The Netwide Assembler (Page 153)

nasm-cvs — CVS commit messages