Commit Graph

626 Commits

Author SHA1 Message Date
H. Peter Anvin
2d3dce2fd7 doc: document the %use fp macro package
Documentation for %use fp was missing...

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2010-08-24 09:55:27 -07:00
Cyrill Gorcunov
84a9e308c3 doc: Update -O option description
We use -Ox by default since Nasm-2.09 so "-O0" is not
longer "default" option. But first paragraph still has
the reference which confuses people. Get rid of it.

Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-08-16 13:53:22 +04:00
Cyrill Gorcunov
327edcfc7a doc: Fix typo in changes.src
Reported-by: Frank Kotler <fbkotler@zytor.com>
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-08-16 13:47:24 +04:00
Keith Kanios
c71cb6b72a doc/nasmdoc.src: revamped context fall-through entry 2010-08-14 12:36:49 -05:00
Cyrill Gorcunov
e1b6e5712b doc: Describe context-through lookup
Feel free to update this text as well,
and check it please for being more/less
readable.

CC: Keith Kanios <keith@kanios.net>
CC: "H. Peter Anvin" <hpa@zytor.com>
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-08-13 12:32:53 +04:00
Cyrill Gorcunov
8cb43d3f68 sectalign: Implement on/off mode
And describe it in documentation. We've introduced
sectalign in 2.09rc series and have to provide an
ability to steer this feature.

Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-08-12 19:09:28 +04:00
Cyrill Gorcunov
e091d6ed62 BR3041451: Implement upper bound for %rep counter
Since %rep counter is a 64 bit signed integer we have to use some
"maximum possible value" limit (upper bound) otherwise there may be
a situation when %rep counter is 0 or even negative while user
has been passing big positive integer value.

Reported-by: nasm64developer
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-08-09 18:35:35 +04:00
Cyrill Gorcunov
dea6c7a974 doc: Updates on macro ranges
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-07-28 18:00:24 +04:00
Cyrill Gorcunov
407e6c707f doc: Explain SECTALIGN
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-07-28 17:59:49 +04:00
Cyrill Gorcunov
455e087c6a doc: Fix ..sym section name misprint
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-07-27 01:48:27 +04:00
H. Peter Anvin
ab5bd05d82 Revert "Improve process_ea and introduce -OL"
This reverts commit ac732cb6a5.

Resolved Conflicts:

	doc/nasmdoc.src

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2010-07-25 12:43:30 -07:00
Victor van den Elzen
b8e699fb3d Remove redundant sentence in docs 2010-07-24 22:24:15 +02:00
Victor van den Elzen
ac732cb6a5 Improve process_ea and introduce -OL
Two fixes:
1. Optimization of [bx+0xFFFF] etc
   0xFFFF is an sbyte under 16-bit semantics,
   so make sure to check it right.

2. Don't optimize displacements in -O0
   Displacements that fit into an sbyte or
   can be removed should *not* be optimized in -O0.

   Implicit zero displacements are still optimized, e.g.:
   [eax] -> 0 bit displacement, [ebp] -> 8 bit displacement.
   However explicit displacements are not optimized:
   [eax+0] -> 32 bit displacement, [ebp+0] -> 32 bit displacement.

Because #2 breaks compatibility with 0.98,
I introduced a new optimization level: -OL, legacy.
2010-07-24 22:00:12 +02:00
Cyrill Gorcunov
088d151130 doc: Update changes.src
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-07-23 18:57:40 +04:00
H. Peter Anvin
077fb93d2b preproc: allow non-identifier character in environment variables
Allow non-identifier characters in the name of environment variables,
by surrounding them with string quotes (subject to ordinary
string-quoting rules.)

Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2010-07-20 14:56:30 -07:00
Cyrill Gorcunov
aed4eaa8f3 changes.src: Fix misprint in "instructions" word.
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-07-17 18:24:13 +04:00
H. Peter Anvin
6c74498114 nasmdoc: we still miss Chuck, but...
We still miss Chuck, but I don't think we can really say anymore we're
doing this particular release in his memory.

Requiescat in pace, our friend.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2010-07-15 22:51:26 -07:00
H. Peter Anvin
abe61900e4 Merge branch 'nasm-2.08.xx'
Resolved Conflicts:
	version

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2010-07-15 22:45:04 -07:00
H. Peter Anvin
5bc03271bd changes.src: update with the 2.08.xx changes
Patchlevels should be documented, too...

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2010-07-15 22:44:03 -07:00
H. Peter Anvin
31387b2d04 Make -Ox the default
Make -Ox the default; it's the optimization level expected by most
users, and it is clearly still causing confusion that it has to be
specified manually.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2010-07-15 18:30:18 -07:00
Bryant Keller
a537d4964e Documentation: describe %ifenv and friends
Signed-off-by: Bryant Keller <bkeller@assembly.ath.cx>
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-07-13 23:49:39 +04:00
Cyrill Gorcunov
702df6d6cc Update changes.src
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-07-13 21:17:54 +04:00
Cyrill Gorcunov
924df0d498 Documentation updates
Various small fixes.

Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-07-13 21:17:03 +04:00
H. Peter Anvin
dc2152ed0a nasmdoc: remove obsolete Sourceforge references
Remove obsolete Sourceforge references, replace with nasm.us.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2010-07-09 19:04:59 -07:00
Cyrill Gorcunov
f2c1cb06e0 doc: Update changes.src
Before soon-coming 2.09rc2.

Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-07-07 01:48:33 +04:00
H. Peter Anvin
0d55110313 doc: inslist.src is an intermediate file, move to "make clean"
inslist.src is an intermediate file, it should be in "make clean"
rather than "make spotless"; otherwise it ends up in the xdoc tarball.

Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2010-06-25 13:40:10 -07:00
Cyrill Gorcunov
640edfd784 nasmdoc: Document macro parameters range
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-06-05 11:24:59 +04:00
H. Peter Anvin
19cbe0c1c4 nasmdoc: document octal/binary floating-point
Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2010-05-07 13:21:20 -07:00
H. Peter Anvin
c8d8a13cde nasmdoc: add missing comma
Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2010-05-07 13:14:45 -07:00
H. Peter Anvin
26bb8890ef nasmdoc: update the full set of numeric prefix/suffix characters.
Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2010-05-07 13:12:12 -07:00
H. Peter Anvin
671a19600c doc: use bouncer URLs for the ABI docs
MSDN can't seem to keep their URLs stable, so use bouncer links
that we can change if necessary.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2010-04-22 10:50:51 -07:00
Cyrill Gorcunov
92aa187f3a smartalign: Introduce nojmp mode
This allows to force nasm to generate multibyte
NOPs without jmp injected.

Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-04-21 01:06:53 +04:00
Cyrill Gorcunov
376b8106d2 nasmdoc.src: Refer to ..imagebase in special symbols area
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-04-10 00:02:51 +04:00
Cyrill Gorcunov
90bb2850fa doc/changes.src: Restore empty line.
Due to previous commit empty line was occasionally
removed which make text harder to read. Restore it.

Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-03-03 23:15:25 +03:00
Cyrill Gorcunov
3dce1e162d Update doc/changes.src
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-03-03 23:13:48 +03:00
Cyrill Gorcunov
f09116f445 preproc.c: Turn off rmacro,exitmacro support
We've a problem in supporting [i]rmacro, exitmacro
facilities at moment.

In a sake of not holding new NASM release any longer these
directives are just marked as being "forbidden".

This allow us to not squash much changes in current source
code base but remain on a safe side same time.

Reviewed-by: Keith Kanios <keith@kanios.net>
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-02-28 12:24:20 +03:00
Cyrill Gorcunov
1579c88185 Revert "doc/nasmdoc.src: Get rid of id length restriction"
This reverts commit 3012d5d430.

nasm64developer pointed out that we still have this
limit in label.c (IDLEN_MAX).

Reported-by: nasm64developer
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-02-17 01:21:54 +03:00
Cyrill Gorcunov
3012d5d430 doc/nasmdoc.src: Get rid of id length restriction
We always allocate enough memory to hold identifiers
with any length. So lets remove restriction from
documentation.

Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-02-17 00:08:55 +03:00
Cyrill Gorcunov
2e624179ad doc/nasmdoc.src: Point to the correct license file
There is no "COPYING" but "LICENSE" file.

Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-02-17 00:08:36 +03:00
Cyrill Gorcunov
e2063ab9e4 doc/nasmdoc.src: It's 2010 already
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-02-17 00:08:28 +03:00
H. Peter Anvin
3af3779826 doc/changes.src: update in preparation of 2.08 release
Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2010-02-15 10:15:53 -08:00
Cyrill Gorcunov
7ce4250a63 doc/nasmdoc.src: Delete misplaced "point" sign
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-02-10 23:31:03 +03:00
Cyrill Gorcunov
7a8098c7cb doc/changes.src: Update changes
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2010-01-03 15:41:22 +03:00
Cyrill Gorcunov
3e73cfc8b7 doc/nasmdoc.src: Update the number of sync points in docs
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2009-12-22 23:42:07 +03:00
Cyrill Gorcunov
78debd0a57 doc/changes.src: describe changes
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2009-12-13 14:13:35 +03:00
H. Peter Anvin
5792483c7d changes.src: document removal of DREX instructions
Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-11-09 14:58:45 -08:00
Cyrill Gorcunov
b9771908b6 Document BR 2887108 in changes.src
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2009-11-06 22:00:45 +03:00
Keith Kanios
4ea846623a changes.src: document preprocessor directives added since 2.07
nasmdoc.src: document %exitmacro
2009-10-25 14:06:24 -05:00
Cyrill Gorcunov
66ba8cdba1 changes.src: describe changes since version 2.07 up to 2.08rc1
There are already new commits which fix other bugs
but at moment only changes up to 2.08rc1.

Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2009-10-18 01:09:40 +04:00
Cyrill Gorcunov
946debb627 doc/nasmdoc.src: NASMENV -- fixup backslashes
−i option (include file search directories) should
contain trailing slash.

Reported-by: Frank Kotler <fbkotler@zytor.com>
Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2009-09-26 01:06:18 +04:00
H. Peter Anvin
a5547dcb74 doc: \ needs to be repeated except in \c-line context; daily snapshots
Fix case where \\ needs to be written as \\\\ in order to appear as a
double backslash.  Also add mention of release candidates and
snapshots.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-08-02 14:16:07 -07:00
H. Peter Anvin
80d0fd371f Merge branch 'master' into new-preproc 2009-07-16 10:18:43 -04:00
H. Peter Anvin
a99c98470e changes: it's not just invalid UTF-8 sequences that are affected...
It isn't just invalid UTF-8 sequences that are affected; it is in fact
any high-bit bytes (we don't ever try to construct UTF-8 characters,
just deconstruct them.)

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-15 17:43:32 -04:00
H. Peter Anvin
67d520c7fa Merge branch 'master' into new-preproc 2009-07-15 16:32:49 -04:00
H. Peter Anvin
cc6ee1acf2 changes: document fixed crash on invalid UTF-8 sequences
Document nasm_quote() fixes.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-15 16:31:55 -04:00
H. Peter Anvin
62f2863860 doc: use consistent title case
Section titles are in title case and don't end with a period.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-15 09:27:10 -04:00
H. Peter Anvin
9bd5e12f53 doc: fix formatting of the bin multisection header
"Multisection" is not a keyword...

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-15 09:21:01 -04:00
Keith Kanios
d37a38c359 pptok: change %rimacro to %irmacro
preproc: change PP_RIMACRO to PP_IRMACRO
nasmdoc: add entries for %[i]deftok and %[i]rmacro
2009-07-14 21:00:40 -05:00
H. Peter Anvin
a6e25b5356 Document macho64 output format
At least mention the 64-bit macho format in the documentation.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-08 21:42:18 -07:00
H. Peter Anvin
a7a14b2fcb changes: document listing fix
Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-07 16:08:56 -07:00
H. Peter Anvin
e227fe6f80 changes: add Mach-O alignment issue fix
Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-06 19:27:33 -07:00
H. Peter Anvin
83b942d3e1 changes: document %+ behavior revert
Revert to original %+ behavior.  This is what we really wanted in the
first place, except this time we have fixed some bugs.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-06 19:00:08 -07:00
H. Peter Anvin
fba06d2719 changes.src: document user-visible changes
Update user-visible changes so far.  Since I consider the license
change alone to be big enough of a deal to justify a "real" version
number, make this version 2.07.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-06 11:28:12 -07:00
H. Peter Anvin
ecfba9d6ab doc: update license and contact information
Update license information to 2-BSD; update contact information.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-06 11:22:58 -07:00
H. Peter Anvin
7ae512b5a8 More "make install" fixes... 2009-07-05 18:48:50 -07:00
H. Peter Anvin
224c9ac063 doc: S-records seems to usually be pluralized
Call it "S-records" not "S-record".

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-05 15:46:42 -07:00
H. Peter Anvin
d78fc550b8 doc: srec produces S-records, not Intel hex...
Copy and paste accident...

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-05 15:45:45 -07:00
H. Peter Anvin
fc87e65aec doc: use the term "extensions" to mean of-specific anything
We seem to use the term "extensions" to mean anything that is specific
to an object format, so continue to do so.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-05 15:44:38 -07:00
H. Peter Anvin
8a3686287d doc: fix capitalization
Consistently capitalize NASM.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-05 15:43:23 -07:00
H. Peter Anvin
4660a2b4a0 outbin: add support for Intel hex and Motorola S-records
Add support for directly generating Intel hex or Motorola S-records.
These formats are commonly used with ROM burners.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-07-05 15:29:55 -07:00
H. Peter Anvin
c940afc103 In memory of Chuck...
Let the 2.06 release be in memory of Chuck.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-06-28 17:12:37 -07:00
H. Peter Anvin
8e471da71d Add copyright header to nasmdoc.src
Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-06-28 17:00:48 -07:00
H. Peter Anvin
e6ee1a859b Add copyright verbiage to Perl scripts; update LICENSE
This adds copyright verbiage to the Perl scripts.  Scripts that are
known to be clean w.r.t. the 2-clause BSD license are given that
license; unclear ones are given the "LGPL for now".

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-06-28 16:54:44 -07:00
H. Peter Anvin
31b707bef0 Move backend-specific code to output/; break out null debug stuff
Move backend-specific code into the output/ directory, and make the
null debugging backend a separate file (it certainly isn't needed for
ndisasm...)

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-06-27 22:07:33 -07:00
H. Peter Anvin
c4471462dc ELF: eliminate hard-coded section numbers
Eliminiate hard-coded section numbers, at least to the best of our
ability.  There is still a very odd piece of computation in
elf_build_reltab() which I can't really figure out...

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-06-25 14:54:44 -07:00
H. Peter Anvin
d219a3e46f ELF: add header files, begin merging common code, drop .comment
Add something approaching real ELF header files.

Begin merging the common ELF code, beginning with the section name
detection.

Drop automatic generation of .comment section, and in particular the
treatment of .common as a special section (if we decide generating
.comment is still a good idea, we should just do it as a macro.)

Augment the list of known sections, and make it table-driven.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-06-25 12:30:50 -07:00
H. Peter Anvin
883735f4c3 changes.src: update 2009-06-25 11:23:37 -07:00
H. Peter Anvin
a5e0279cbd changes.src: fix some odd spacing 2009-06-24 16:50:54 -07:00
H. Peter Anvin
b9cc7f1449 doc: use NASM syntax for x87 registers
The x87 registers are called ST0 and ST1 in NASM syntax, not ST(0) and
ST(1).

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-05-23 16:25:14 -07:00
H. Peter Anvin
03b9f94133 doc: remove insref.src
Remove the old, obsolete insref.src.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2009-05-08 17:56:59 -07:00
H. Peter Anvin
6ca419e7c5 doc: slightly tidy the copyright page of the manual. 2009-04-19 17:26:09 -07:00
H. Peter Anvin
9c7f3f5608 Document preprocessor token concatenation fix. 2009-04-07 22:09:05 -07:00
Victor van den Elzen
b32536cc53 Add STRUC change to changes.src 2009-03-29 03:09:13 +02:00
Victor van den Elzen
56b820355c FR 2499968: structures with non-zero base offset
Add an optional second argument to struc, document it and test it.
Also removed trailing whitespace in nasmdoc.src in the process.
2009-03-27 03:53:59 +01:00
H. Peter Anvin
875138830b changes.src: document WAIT and %$$ fixes 2009-02-21 18:26:20 -08:00
H. Peter Anvin
e8a3e6278a changes.src: document updated AVX specification 2009-02-18 14:13:25 -08:00
Soronel Haetir
e5fdc60c2b Document the as86 ..start label
I realized that a documentation change is required to inform users about the
addition of entry point support for the as86 format.  The following produces
reasonable output for .txt output, but I am blind and so can't check the
other formats as readily.
2009-01-21 15:30:27 -08:00
H. Peter Anvin
3e8ac5366f doc: clean up the "String Manipulation in Macros" section
Minor cleanups to the "String Manipulation in Macros" section.
2009-01-18 23:04:45 -08:00
H. Peter Anvin
33a5ad1f8e doc: indent the time macro example
Indent the time macro example for ease of reading.
2009-01-18 22:59:13 -08:00
H. Peter Anvin
bed44b3889 doc: fix typo
verson -> version
2009-01-18 22:55:53 -08:00
H. Peter Anvin
55a9c08dac doc: update the section on numeric constants
Update the section on numeric constants, and add a few more examples.
2009-01-18 22:51:46 -08:00
H. Peter Anvin
fd925d9512 changes.src: document Mach-O alignment fix. 2008-12-22 16:37:59 -08:00
H. Peter Anvin
674788166f changes.src: document POPCNT fix.
Add POPCNT fix to release notes.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-11-06 09:42:11 -08:00
H. Peter Anvin
da05001506 doc: better description of %line
The implication that %line allows NASM to digest cpp output is just
plain wrong, at least without additional intermediate processing.  Be
a little more circumspect.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-11-05 15:55:40 -08:00
H. Peter Anvin
67a405e2f4 changes.src: document if for %ifmacro.
Document fixed %ifmacro.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-11-04 14:26:32 -08:00
H. Peter Anvin
e263d04544 doc/changes.src: document ELF TLS
Add ELF TLS to the release notes.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-11-02 20:41:29 -08:00
H. Peter Anvin
76fab7ab17 doc: minor edit to the TLS documentation examples.
Minimize the TLS documentation examples (we don't need "dword" in a
mov from ebx, for example.)  This is just to avoid user confusion.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-11-02 20:40:16 -08:00
Charles Crayne
81afb49809 Document differences between TLS coding in ELF32 and ELF64
Absolute relocation wrt ..tlsie for ELF32
Relative relocation wrt ..gottpoff for ELF64
2008-11-01 17:09:36 -07:00
H. Peter Anvin
8321866bb5 doc: cross-reference macro parameter concatenation with %[...]
Explicitly document that %[...] and macro parameters concatenate the
same way, and cross-reference the two.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-29 21:02:30 -07:00
H. Peter Anvin
6c9f6f8e3d doc: fix typo in the description of %unmacro
The description of %unmacro used %unmacro in a place which should
obviously have been %macro.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-29 20:46:30 -07:00
H. Peter Anvin
2d9ceaa3ee doc: fix capitalization
Make the capitalization of "The -t Option" consistent with the other
options.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-29 18:17:59 -07:00
H. Peter Anvin
b7aaf0b9e5 doc: remove duplicate entry for the "error" warning class
Remove duplicate entry for the "error" warning class; leave at the end
with "all", as being another meta-warning class.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-29 18:16:31 -07:00
H. Peter Anvin
8a2f145260 doc: retroactively document updates to the warning options
Retroactively document the following changes to the warning options:

  - gcc-like syntax (-Wfoo, -Wno-foo)
  - "all" alias
  - "error" metawarning

Added in 2.00rc1 but never documented.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-29 18:14:03 -07:00
H. Peter Anvin
fd366a9db4 Merge commit 'nasm-2.05.01'
Conflicts:
	doc/changes.src
2008-10-29 10:53:37 -07:00
H. Peter Anvin
7714ced1d9 doc/changes.src: document -W/-w fix as a NASM 2.05.01 feature.
Make -W/-w fix a release note for NASM 2.05.01.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-29 10:51:51 -07:00
Charles Crayne
ee5245a9f2 Initial documentation for ELF64 TLS
More to come.
2008-10-27 22:53:40 -07:00
H. Peter Anvin
c83f9de3b4 doc/changes.src: retroactively document anonymous %push
Retroactively document the anonymous %push, which was added in version
2.04 but not documented.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-24 16:53:53 -07:00
H. Peter Anvin
264b7b982c preproc: don't macro-expand the argument to %use
Use expand_id() for the argument to %use, instead of expand_smacro().
This really makes more sense for a "naked" argument.  This is a
semantic change, but is unlikely to break any real code.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-24 16:38:17 -07:00
H. Peter Anvin
0b7d903ec8 doc: document %pop with argument
Document that %pop can now take an argument, and what it does.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-24 16:27:11 -07:00
H. Peter Anvin
59c2e54f25 doc: document anonymous %push
The anonymous %push was never documented, document it now.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-24 16:19:03 -07:00
H. Peter Anvin
b34fce7111 doc/changes.src: begin the release notes for 2.06
The next version will presumably be called 2.06; begin collecting
release notes.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-24 16:05:19 -07:00
H. Peter Anvin
df7d3e22fc doc: fix awkward word order
"the exactly same" -> "exactly the same"

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-24 10:15:46 -07:00
H. Peter Anvin
912595dfc0 Merge branch 'indirect' 2008-10-23 23:13:44 -07:00
H. Peter Anvin
7766ab0e0b doc/changes.src: update release notes
Update the release notes in preparation for NASM 2.05.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-23 19:29:28 -07:00
H. Peter Anvin
0ca00860df doc: document the %[...] construct.
Add documentation for the %[...] construct.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-19 17:00:52 -07:00
H. Peter Anvin
3ffd0fc157 doc/changes.src: document massive changes to ELF64 backend
We didn't just fix the GOT stuff, but also now properly use RELA and
so forth.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-17 23:36:45 -07:00
H. Peter Anvin
44d3552ab9 Add reference to %+ from macro parameter concatenation
Add a reference to the %+ operator from the section on macro parameter
concatenation.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-15 16:18:17 -07:00
H. Peter Anvin
850ba56f1d doc: minor editorial change
Use the terms "defined" and "expanded" for single-line macros more
consistently.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-15 16:14:39 -07:00
H. Peter Anvin
a3e57106fa doc: add link to the macro packages when talking about them
When discussing the standard macro packages in the context of
__USE_*__ macros, link to them as well as to the %use directive.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-15 11:15:48 -07:00
H. Peter Anvin
d5118f2009 BR 2164053: --prefix _ not --prefix_
The --prefix option takes a separate argument, not an attached
argument.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-13 10:17:27 -07:00
H. Peter Anvin
8cd1df87e5 Document RIP-relative GOT fixes in ELF64 2008-10-12 21:17:04 -07:00
H. Peter Anvin
68b41d3d47 changes: document immediate fix 2008-10-06 19:15:42 -07:00
H. Peter Anvin
04c6052670 changes: document CVT fixes.
Document fixes to the CVT instructions.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-06 18:00:13 -07:00
H. Peter Anvin
6c80ab6f7f assemble.c: do not warn on valid SBYTE optimizations
Do not warn on valid SBYTE optimizations.  If we are optimizing and
match one of the SBYTE conditions, do not error out.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-10-04 18:50:47 -07:00
H. Peter Anvin
a3a60e95a0 doc/changes.src: update
Add information about the recent bug fixes.
2008-10-01 10:02:44 -07:00
H. Peter Anvin
1abb9e5370 changes.src: document JMP reg64 fix.
Document the fixed JMP reg64.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-09-30 17:14:54 -07:00
H. Peter Anvin
2aa72b64a6 rdsrc.pl: handle tabs in the input
It is just to painful to keep the source files tab-free.  Handle tabs
in the input as required.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-09-30 17:12:19 -07:00
H. Peter Anvin
e232d9a6bf doc: remove tab
The documentation processor doesn't like tabs.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-09-30 17:07:14 -07:00
H. Peter Anvin
2f16043879 Allow %warning output to be suppressed
Allow the user to suppress user-specified warnings.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-09-30 16:39:17 -07:00
H. Peter Anvin
dc0bf47feb Document the -O0 and -O1 behaviors.
Document the way the -O0 and -O1 options actually behave.  -O0, in
particular, is NASM 0.98 compatibility mode.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-09-30 16:24:47 -07:00
Charles Crayne
3cc2459944 Document a64 and o64 qualifiers
Add references and index entries for a64 and o64.
2008-09-26 17:13:09 -07:00
H. Peter Anvin
61f130f4e9 Set __PASS__ to 3 for preprocess only
When running the preprocessor only, set __PASS__ to 3.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-09-25 15:45:06 -07:00
H. Peter Anvin
010aee270f Document __PASS__
Document __PASS__, but discourage users from using it.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-09-24 17:34:37 -07:00
H. Peter Anvin
13f1f3eed6 doc/changes.src: something closer to final release notes for 2.04
doc/changes.src should contain the user-visible changes in human
comprehensible form (release notes, not a changelog.)  Get something
closer to what it should look like for 2.04.
2008-09-24 08:59:29 -07:00
H. Peter Anvin
314b5f9a12 nasmdoc.src: more consistent indentation in %error section
We had different indentation levels only two paragraphs apart.
Overall, the document is horribly inconsistent about indentation,
which should be fixed.
2008-09-24 08:46:50 -07:00
H. Peter Anvin
8e3f75ea6e %error, %warning out on the final pass, add %fatal
Only process %error or %warning directives on the final pass.  Add a
new %fatal directive which terminates assembly immediately.
2008-09-24 00:21:58 -07:00
H. Peter Anvin
233c4945b1 doc: document the use of macros in %error
Document the use of macros in %error and %warning, valid since 2.03.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-09-10 23:34:39 -07:00
H. Peter Anvin
1dc23a1b39 doc: Call %xdefine a "resolving define" instead of "enhancing define"
%xdefine is an early-binding %define (%define being late-binding.)
There is nothing "enhanced" about it, it just specifies a different
policy.  Call it a "resolving define" instead.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-09-10 23:29:45 -07:00
H. Peter Anvin
3f85cfc766 doc: clean up formatting around -O option
Clean up the formatting in descriptions of the -O option.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2008-09-10 23:27:10 -07:00
H. Peter Anvin
a2d542ccaa changes: document optimizer change 2008-09-10 23:04:56 -07:00
Charles Crayne
2581c869b1 Decouple forward references from optimization
Users who wish to control the level of optimization can
continue to specify -O0, -O1, or -Ox,
where x can be the letter itself, or any number > 1.

However, even with optimization turned off,
NASM will always make enough passes to resolve
forward references. As a result, INCBIN is now the only
item left in the critical expressions list, although TIMES
still has its own constant value check.
2008-09-10 19:21:52 -07:00
H. Peter Anvin
df73e0b63a Update doc/changes.src 2008-09-03 15:16:44 -07:00
H. Peter Anvin
39e9a5f72f Document %use smartalign 2008-09-03 15:03:20 -07:00
H. Peter Anvin
4a532bc707 Document %unmacro 2008-09-03 14:31:20 -07:00
Victor van den Elzen
22343c2c72 Add macro-defaults warning class and documentation. 2008-08-06 14:48:55 +02:00
Victor van den Elzen
0e857f1fe5 Improve checking and documentation for %ifctx 2008-07-23 13:21:29 +02:00
Victor van den Elzen
819703afce Fix multipass inline warning (dis/en)abling
Also add a new form: resetting warnings to their original value.
2008-07-16 15:20:56 +02:00
H. Peter Anvin
5506e1fdef changes.src: put \c{...} around macro directives
Put \c{...} around macro directives.  Not the only ones that should
have that, of course, but they were easy to do with search and replace.
2008-07-14 02:54:00 -04:00
H. Peter Anvin
6477f3d315 changes.src: remove double entry for %warning 2008-07-14 02:49:52 -04:00
H. Peter Anvin
04156cd099 Move the revision history into the documentation
Clumsily convert the revision history to nasmdoc format, so it can be
included in the documentation as Appendix C.
2008-07-14 02:45:57 -04:00
H. Peter Anvin
cf6b43476e doc: document packed BCD constants 2008-07-13 15:55:55 -07:00
H. Peter Anvin
bbf769df01 doc: update NASM Version Macros
Clean up and slightly update the section on NASM version macros.
2008-07-13 15:44:25 -07:00
H. Peter Anvin
6621073059 doc: move %error/%warning to a separate section
They don't really belong in the section on conditional assembly.
2008-07-13 15:41:36 -07:00
H. Peter Anvin
31b98f5431 doc: Document %strcat 2008-07-13 15:35:07 -07:00
H. Peter Anvin
f4ae5ad11b Protect %use from multi-inclusion and provide a test macro
Automatically provide an include guard for %use packages; the macro
__USE_package__ is automatically defined, and inclusion is suppressed
if it is already defined.
2008-06-19 18:39:24 -07:00
H. Peter Anvin
5f9f4007ff doc: framework for documenting standard macro packages
Add a framework for documenting the standard macro packages.  Also
move the standard macros to the end of the preprocessor section,
instead of having them in the middle of the directives list.
2008-06-19 16:58:05 -07:00
H. Peter Anvin
9dee352dee doc: macroize texi2ipf and ipfc
Macroize the texi2ipf and ipfc commands (used for OS/2).
2008-06-19 11:47:13 -07:00
H. Peter Anvin
eec3b52505 doc: for ps to pdf conversion, use "acrodist", "ps2pdf" or "pstopdf"
For PostScript to PDF conversion, use whichever of "acrodist",
"ps2pdf", or "pstopdf" which we can find on the system.  I haven't
tried either acrodist or pstopdf myself, only going my the
documentation, but prefer acrodist since it is claimed to produce
smaller output files than ps2pdf.
2008-06-19 11:39:23 -07:00
H. Peter Anvin
ca6a242dcd Merge branch 'nasm-2.03.x'
Conflicts:

	Makefile.in
	Mkfiles/msvc.mak
	Mkfiles/netware.mak
	Mkfiles/openwcom.mak
	Mkfiles/owlinux.mak
2008-06-16 21:45:42 -07:00
H. Peter Anvin
07c1468307 doc: add missing nasmdoc.txt target 2008-06-16 21:19:34 -07:00
H. Peter Anvin
1794876088 Merge branch 'nasm-2.03.x'
Conflicts:

	doc/nasmdoc.src
2008-06-15 21:27:30 -07:00
H. Peter Anvin
04e225ccef Make -F imply -g (BR 1991213)
When the user specifies -F, imply the -g option.  Too many users seem
to make this mistake.

Conflicts:

	doc/nasmdoc.src
2008-06-15 21:25:56 -07:00
H. Peter Anvin
d11c48d910 Merge branch 'nasm-2.03.x'
Conflicts:

	doc/nasmdoc.src
2008-06-15 21:22:40 -07:00
H. Peter Anvin
eafc83fc65 doc: Nasm -> NASM
Consistently write NASM in all capitals
2008-06-15 21:21:07 -07:00
H. Peter Anvin
1b18ece43c doc: title capitalization 2008-06-15 21:20:59 -07:00
H. Peter Anvin
f83781db62 doc: add missing period.
Conflicts:
2008-06-15 21:20:45 -07:00
H. Peter Anvin
cca25b8a13 doc: Makefile fixes missing from previous checkin 2008-06-15 21:18:24 -07:00
H. Peter Anvin
702400f314 doc: another case of the RTF backend corrupting state
Another case of the RTF backend corrupting global state.  "Fix" it by
only outputting one format at a time; this also makes it possible to
run in parallel.
2008-06-15 21:18:17 -07:00
H. Peter Anvin
bcd0b9903c doc: ps/pdf: set page numbers in normal-sized italic
Set page numbers in normal-sized italic, instead of large and bold.
We might want to consider using bold italic, but I think this is just
fine.
2008-06-15 21:18:08 -07:00
H. Peter Anvin
a43569cb9b doc: Add NASMENV to the index (BR 1917084)
Add NASMENV to the documentation index.
2008-06-15 21:18:01 -07:00
H. Peter Anvin
fac516d1e5 ps/pdf doc: default to 10-point font, wider leading
Switch the main font to 10 points Times Roman, but leave the leading
at 11 points.  This produces, in my opinion, a much more legible and
printable document.
2008-06-15 21:10:45 -07:00
H. Peter Anvin
9fea5c4f30 doc: Add Unicode Strings to Unicode index 2008-06-14 21:23:39 -07:00
H. Peter Anvin
5c657bdc12 Document __utf16__ and __utf32__ 2008-06-14 21:21:17 -07:00
H. Peter Anvin
dfaa278cd5 doc: add a couple of stylistic alternatives
Add a few alternate font sets for the documentation.  I would be
interested to see if anyone thinks they are better.
2008-06-14 12:09:25 -07:00
H. Peter Anvin
2b2a938dea doc: Nasm -> NASM
Consistently write NASM in all capitals
2008-06-11 21:09:22 -07:00
H. Peter Anvin
593b73ae6d doc: title capitalization 2008-06-11 18:52:54 -07:00
H. Peter Anvin
7baaf630a5 doc: add missing period. 2008-06-11 18:51:14 -07:00
H. Peter Anvin
57bf27b654 doc: remove obsolete note. 2008-06-11 18:50:41 -07:00
H. Peter Anvin
792ade2256 doc: Makefile fixes missing from previous checkin 2008-06-11 18:38:15 -07:00
H. Peter Anvin
773a513a1d doc: another case of the RTF backend corrupting state
Another case of the RTF backend corrupting global state.  "Fix" it by
only outputting one format at a time; this also makes it possible to
run in parallel.
2008-06-11 18:32:33 -07:00
H. Peter Anvin
62332b2373 doc: ps/pdf: set page numbers in normal-sized italic
Set page numbers in normal-sized italic, instead of large and bold.
We might want to consider using bold italic, but I think this is just
fine.
2008-06-11 18:23:14 -07:00
H. Peter Anvin
eb8db629d0 doc: Add NASMENV to the index (BR 1917084)
Add NASMENV to the documentation index.
2008-06-11 18:14:24 -07:00
H. Peter Anvin
3d61238bf8 ps/pdf doc: default to 10-point font, wider leading
Switch the main font to 10 points Times Roman, but leave the leading
at 11 points.  This produces, in my opinion, a much more legible and
printable document.
2008-06-11 18:09:02 -07:00
H. Peter Anvin
ca5ec7a225 Make -F imply -g (BR 1991213)
When the user specifies -F, imply the -g option.  Too many users seem
to make this mistake.
2008-06-11 18:07:40 -07:00
H. Peter Anvin
7df0417e58 Add %warning, saner unquoting of %error
- Add %warning directive
- Only unquote an %error or %warning string if it is the only thing on
  the directive line.
- Don't expand macros inside a quoted string, even for %error.
2008-06-10 18:27:38 -07:00
H. Peter Anvin
c800e131c1 doc: Fix title "String Constants"
Cut & paste oops...
2008-06-08 16:55:15 -07:00
H. Peter Anvin
cf948a3904 doc: Index Unicode and UTF-8
Add Unicode and UTF-8 to the index
2008-06-08 16:54:03 -07:00
H. Peter Anvin
cb40e8a010 doc: \t is also a supported escape sequence... 2008-06-08 16:50:23 -07:00
H. Peter Anvin
9544bec3f5 doc: s/by/in/ certain preprocessor directives. 2008-06-08 16:49:16 -07:00
H. Peter Anvin
c2734cc43c Split documentation on string syntax out of "character constants"
Split the documentation on string syntax, as a lexical entity, out of
the section about character constants.  It was confusing to have
discussion that apply more to string constants than character
constants, and they use the same syntax anyway.
2008-06-08 16:46:37 -07:00
H. Peter Anvin
062ee976c4 doc: A few floating-point examples 2008-06-08 16:39:28 -07:00
H. Peter Anvin
27bdec9295 doc: add a comma
This time the comma should actually be there.
2008-06-08 16:35:45 -07:00
H. Peter Anvin
6581802f8b doc: ALL %if constructs have %elif/%ifn/%elifn variants.
All %if constructs now have %elif/%ifn/%elifn; this is hard-coded into
the preprocessor.
2008-06-08 16:34:44 -07:00
H. Peter Anvin
868067de66 doc: remove superfluous comma 2008-06-08 16:25:20 -07:00
H. Peter Anvin
66f1d9ffb1 Improve the %iftoken example 2008-06-08 16:24:06 -07:00
H. Peter Anvin
ef0145540e Fix capitalization in titles 2008-06-08 16:20:26 -07:00
Frank Kotler
af19b09a2e Document __OUTPUT_FORMAT__
It may be "too late" for this to get into 2.03, but I've been whining
that "__OUTPUT_FORMAT__" ought to be documented. Maybe...
2008-06-08 10:48:16 -07:00
H. Peter Anvin
533fb7e1f5 doc: Remove superfluous comma. 2008-06-04 17:24:35 -07:00
H. Peter Anvin
9e20016eda Add %defstr, %idefstr
Add %defstr and %idefstr, to define a macro as a quoted string.
2008-06-04 17:23:14 -07:00
H. Peter Anvin
64bd892d7f doc: Remove "what's new" since it is out of date 2008-06-02 18:32:01 -07:00
H. Peter Anvin
e8a092976e Document UTF-8 conversion better, use "byte" instead of "ASCII"
ASCII specifically refers to characters <= 127, so to use "ASCII" for
literal bytes is really confusing in a multibyte environment.  Give an
example of using Unicode escapes.
2008-06-01 23:00:23 -07:00
H. Peter Anvin
677befc461 Document that underscores in numbers is permitted. 2008-06-01 22:53:15 -07:00
H. Peter Anvin
c23b2a9d47 nasmdoc: document %substr, ... 2008-06-01 22:36:09 -07:00
H. Peter Anvin
39fe51eedf Fix bug where the WinHelp backend corrupts the internal data
WinHelp/RTF needs to convert \ to \\, but did so on the global data,
so the DIP output was corrupted.
2008-06-01 22:34:55 -07:00
H. Peter Anvin
311d27d328 doc: Single section for all the date/time macros
Move all the date/time macros to a common section so we can give a
common example.  We don't have support for a fourth level of headers,
so just use a bulleted list.
2008-05-30 14:32:16 -07:00
H. Peter Anvin
7d6fae6537 doc: fix __UTC_DATE__ and __UTC_TIME__ description 2008-05-30 14:11:40 -07:00
H. Peter Anvin
fd59e0c63c Document %pathsearch and %depend 2008-05-30 11:03:56 -07:00
H. Peter Anvin
e63e62be46 doc: consistent capitalization (and indexing!) of INCBIN 2008-05-30 10:09:24 -07:00
H. Peter Anvin
9e1f528c36 Add the -MP option to emit phony targets
Add the -MP option to emit phony targets.  Since this means each
header file has to be visited more than once, change the
implementation to use an internal list of all the dependencies, and
centralize the emission of the dependency files.
2008-05-29 21:38:00 -07:00
H. Peter Anvin
dbd75f7afc Document the new dependency options. 2008-05-29 19:27:05 -07:00
H. Peter Anvin
14b015f9d6 Missing % in %ifmacro 2008-05-28 22:11:13 -07:00
Andy Polyakov
95cd596352 doc: document Win32/64 SEH extensions
Document COFF extensions for Windows SEH
2008-05-27 14:03:09 -07:00
H. Peter Anvin
ca4f36cc2c Document %? and %?? 2008-05-25 22:09:17 -07:00
H. Peter Anvin
e6a5cb536a doc: another reference to DY 2008-05-23 18:24:03 -07:00
H. Peter Anvin
a69749581d Document DY, RESY and YWORD 2008-05-23 17:58:01 -07:00
H. Peter Anvin
21513e822f inslist.pl: deal with the new encoding format
Make it possible for inslist.pl to understand the new encoding format;
fix a few minor buglets.
2008-05-20 18:33:40 -07:00
Charles Crayne
a762ca544b Avoid long line warning when generating nasm docs
rdsrc.pl limits lines to 68 characters for some formats
2008-04-12 13:35:43 -07:00
Charles Crayne
8ca31b48af Document avaiabily of DWARF for ELF32 and ELF64 2008-04-07 14:26:29 -07:00
H. Peter Anvin
134b94665d Add %ifempty and variants 2008-02-16 17:01:40 -08:00
H. Peter Anvin
cbf768d67d Implement %iftoken, test for a single token
Implement %iftoken, a test for a single token.  This is useful in
cases using %+ to splice a macro-provided token.
2008-02-16 16:41:25 -08:00
H. Peter Anvin
8c01b0b409 Use term "host platform" consistently 2008-02-16 14:57:45 -08:00
H. Peter Anvin
70e63c9a9a Add standard time macro boilerplate to __POSIX_TIME__ 2008-02-16 14:56:49 -08:00
H. Peter Anvin
6b18bcce46 BR 774131: date and time macros
This checkin creates the following date and time macros:

__DATE__, __TIME__, __UTC_DATE__, __UTC_TIME__: strings

__DATE_NUM__, __TIME_NUM__, __UTC_DATE_NUM__, __UTC_TIME_NUM__:
civil dates in digit-string formats

__POSIX_TIME__: time in POSIX time_t format
2008-02-16 14:54:10 -08:00
H. Peter Anvin
8960f37b9c doc/Makefile.in: avoid deleting opt_var.txt, fix dependencies
Fix dependencies in the generation of the instruction list, and make
sure we don't delete opt_var.txt on "make spotless".
2008-01-20 21:50:02 -08:00
Charles Crayne
c17a0eb31b Add autogenerated instruction list to NASM documentation
1. Allow included files in rdsrc.pl
2. New program inslist.pl to generate instruction list from insns.dat
3. Mark certain comments in insns.dat as documentation subheaders
4. Add Instruction List appendix to nasmdoc.src
5. Update build process to invoke inslist.pl
2008-01-20 16:27:03 -08:00
Charles Crayne
1727b3d0eb Check in Ed Beroset's documentation fix
Correct count in %strlen example
2007-12-28 15:00:03 -08:00
H. Peter Anvin
e55c836b5a Document naming of registers in 64-bit mode
Intel's docs diverge from AMD's docs (MASM follow AMD's docs);
formally document what we're doing and include a file of macros in
case someone wants to use alternate names.
2007-12-10 15:35:28 -08:00
H. Peter Anvin
5f5a252a36 Refer to version 2.00 consistently as 2.00 not 2.0 2007-11-29 17:30:11 -08:00
H. Peter Anvin
869ed26461 doc: 16- and 128-bit floating point were also new for 2.0 2007-11-29 17:29:37 -08:00
H. Peter Anvin
f7acb2f902 Update install instructions; remove references to nasmw.exe 2007-11-29 17:28:05 -08:00
H. Peter Anvin
72da449a41 doc: s/NASM/nasm/ in invocation example
On case-sensitive systems, "NASM" doesn't work.
2007-11-29 17:20:45 -08:00
H. Peter Anvin
d1e8ba6039 -o is output filename, not output format 2007-11-29 17:19:49 -08:00
H. Peter Anvin
3e30d5aefe Give an example on how Unix and Win64 count argument differently 2007-11-29 17:17:35 -08:00
H. Peter Anvin
52b4d6d7b0 Allow numbers to be sorted separately from letters
Allow numbers to be sorted separately from letters.
2007-11-29 17:10:04 -08:00
H. Peter Anvin
540f903928 nasmdoc.src: editorial changes 2007-11-29 17:07:53 -08:00
H. Peter Anvin
c780557e15 %ixdefine, not %xidefine
The docs had %xidefine, the code has %ixdefine.  The code wins.
2007-11-29 13:10:08 -08:00
Charles Crayne
f2098e9935 Documention Changes for Release 2.00
modified:   CHANGES
	modified:   ChangeLog
	modified:   doc/nasmdoc.src
2007-11-25 14:25:13 -08:00
H. Peter Anvin
21eed86871 Typo fixes in documentation
Typo fixes in documentation, including BR 1836379
2007-11-24 16:31:48 -08:00
H. Peter Anvin
24588d35e7 Remove FIXME from documentation
This better work now, we're in release candidate mode.
2007-11-17 21:21:18 -08:00
Charles Crayne
db90f35d89 Check in Keith's Fixes
1. Don't warn on 32-bit overflow
2. Change EM64T to Intel 64 in Defining CPU Dependencies
   section of documentation.
2007-11-17 21:08:33 -08:00
root
dbb1828ad5 Support setting OSABI value in ELF header. 2007-11-13 19:52:54 -08:00
Charles Crayne
c22ae5cb12 Update documentation for stack relative directives.
Bring a few other sections up to date.
2007-11-10 21:55:19 -08:00
Charles Crayne
9fb030f8cd Update documantation for stack relative directives 2007-11-09 16:37:41 -08:00
Charles Crayne
102cdadb6f Update documentation for stack relative directives 2007-11-09 16:25:43 -08:00
H. Peter Anvin
88602aa53a ps2pdf: remove -dOptimize=true
Remove -dOptimize=true; it actually generates larger output, since the
optimization performed is "network optimization".
2007-11-08 20:29:37 -08:00
H. Peter Anvin
2ce0274303 Use a 32-bit floating-point limb size; support 8-bit float
Use a 32-bit limb size ("like a digit, but bigger") for floating-point
conversion.  This cuts the number of multiplications per constant by a
factor of four.

This means supporting fractional-limb-sized numbers, so while we're at
it, add support for 8-bit floating point numbers (apparently used in
graphics and in audio compression applications.)
2007-10-29 20:20:12 -07:00
Charles Crayne
650dc9d004 Update sections about debug info formats 2007-10-24 15:30:17 -07:00
H. Peter Anvin
7065309739 Formatting: kill off "stealth whitespace"
"Stealth whitespace" makes it harder to read diffs, and just generally
cause unwanted weirdness.  Do a source-wide pass to get rid of it.
2007-10-19 14:42:29 -07:00
Charles Crayne
f3eea3d539 Suppress datarootdir warnings from configure 2007-10-18 23:33:06 -07:00
H. Peter Anvin
f6c9e65d4f Implement floating-point option control directive
New directive [FLOAT] with associated standard macros; allows the
setting to be saved and restored.
2007-10-16 14:40:27 -07:00
H. Peter Anvin
fd7dd11345 Create option -Ox to tell NASM to do unlimited passes
Add option -Ox to tell NASM to do as many passes as it needs, instead
of imposing a fixed number.
2007-10-10 14:06:59 -07:00
H. Peter Anvin
413fb900bf nasm option reshuffling, -E -> -Z
Old -E becomes -Z
New -E is alias for -e
Remove the obsolete -r option
2007-09-26 15:19:28 -07:00
H. Peter Anvin
4cba95cf81 nasmdoc: corrections on 64-bit immediates/displacements
Corrections the section on 64-bit immediates and displacements.  In
particular, immediates are sign-extended the same way displacements
are (and the same way 8-bit immediates are), so there is some use for
the 7-byte mov eax,dword imm form :(
2007-09-25 20:36:45 -07:00
H. Peter Anvin
64b3a9c56b nasmdoc: shorten lines which are too long 2007-09-25 16:02:21 -07:00
H. Peter Anvin
f664bf1ed6 Document NASM behaviour for 64-bit immediates and displacements
Document (intended) NASM behaviour for 64-bit immediates and
displacements.
2007-09-25 16:01:07 -07:00
H. Peter Anvin
ed29882b51 nasmdoc: grammar fix
half -> halves
2007-09-24 13:54:00 -07:00
H. Peter Anvin
1fd23400fd nasmdoc: remove stray periods
A title line doesn't end in a period.
2007-09-24 13:44:02 -07:00
H. Peter Anvin
37a321fbbe Implement the -MG option (SF RFE 1564264)
Implement the -MG option, to generate dependencies in the presence of
generated files.  In the end, we probably need to support the full
gamut of GCC-like dependency-generation options.
2007-09-24 13:41:58 -07:00
H. Peter Anvin
dee8eaa967 nasmdoc: clarify __float*__ example 2007-09-24 12:52:09 -07:00
H. Peter Anvin
ea043ef039 nasmdoc: document the __float*__ operators 2007-09-24 12:44:38 -07:00
H. Peter Anvin
25a993488c BR 1783117: Document that %+ needs a space after it, and fix crash
Document that %+ needs a space after it due to collision with %+1
syntax for multiline macro arguments; make it issue an error message
rather than crashing.
2007-09-22 17:45:45 -07:00
H. Peter Anvin
8084f105a2 Document Infinity and NaN
Add __Infinity__, __QNaN__, and __SNaN__ to the documentation.
2007-09-18 22:08:04 -07:00
H. Peter Anvin
5107d672a0 Update documentation
Document new floating-point capabilities, and clean up the discussion
about BITS 64 and REX prefixes.
2007-09-18 19:12:26 -07:00
H. Peter Anvin
0edc309505 Document oword, do and reso
Document oword and the associated do and reso pseudoinstructions.
2007-09-18 13:45:12 -07:00
H. Peter Anvin
2f3c4c056e Additional documentation for 64-bit programming
Flesh out the documentation for 64-bit programming a little bit; in
particular, include links to the ABI documentation for various
platforms.
2007-09-17 13:03:33 -07:00
H. Peter Anvin
d105682096 Remove $Id$ tags (useless with git)
Remove CVS $Id$ tags, since git doesn't use them.
2007-09-12 21:05:06 -07:00
H. Peter Anvin
9c06db6935 doc: add some cross-references 2007-09-11 23:57:23 +00:00
H. Peter Anvin
9b49e24e1f Feeble attempt at updating the documentation; remove Appendix B
Feeble attempt to document 64-bit support.  Also, remove Appendix B since
we have been utterly useless at keeping it up to date, and it's redundant
with the processor manufacturer's documentation anyway.
2007-09-11 23:52:01 +00:00
Frank Kotler
155eef6a3d finally commit Mike Frysinger's "elf-visibility" patch 2007-08-26 05:10:24 +00:00
Chuck Crayne
b7eea1c940 Addition of elf32 and elf64 output formats.
Addition of ! as unary operator in expression evaluation.
Allow numeric constants in DQ directive.
2007-05-04 02:16:08 +00:00
Keith Kanios
b7a89544d0 General push for x86-64 support, dubbed 0.99.00. 2007-04-12 02:40:54 +00:00
Eric Christopher
1e0de6e913 Fix documentation building for non-srcdir builds. Still bugs in .ps implementation.
Add Mach-O documentation.
2006-02-04 00:23:30 +00:00
Frank Kotler
9d8c22b202 add John Coffman's optimizer documentation 2005-03-10 02:03:11 +00:00
Frank Kotler
c0e34d4f81 Document maximum identifier length 2004-12-31 03:38:32 +00:00
Frank Kotler
6f7a5a60dc Touch up docs 2003-12-12 07:54:15 +00:00
Frank Kotler
b4a1735c47 Update rdoff 2003-12-12 06:18:07 +00:00
H. Peter Anvin
9173ab9961 Update documentation slightly; remove weird special-casing of -O2 and -O3 2003-08-29 19:25:46 +00:00
Frank Kotler
d0ed6fd30d Alexei's patch to allow "-I" paths to be searched for "incbin"ed files 2003-08-27 11:33:56 +00:00
H. Peter Anvin
ad4f0e09f3 Support "cpu prescott" 2003-02-25 00:03:00 +00:00
H. Peter Anvin
bf2faec654 Update copyright year 2003-02-24 23:32:00 +00:00
H. Peter Anvin
792600f48b Improve language 2003-02-24 23:28:48 +00:00
Frank Kotler
8fa0d037f3 "Q" and "O" suffixes now indicate octal - touch up docs 2003-02-06 02:44:08 +00:00
Frank Kotler
3967c3d476 update docs - multisection, [list +/-], --prefix, pslldq/psrldq (?), etc. 2003-02-04 17:21:02 +00:00
Frank Kotler
e5ffcb333a fix reported bug in doc - cosmetic touchups 2002-12-07 00:44:19 +00:00
H. Peter Anvin
a04f636bd0 Fix the definition of PSLLDQ (BR 578123) 2002-11-10 06:13:37 +00:00
H. Peter Anvin
fc869bac3d Visual C++ error format needs <space>:<space> after the parentheses. 2002-06-10 00:41:41 +00:00
Ed Beroset
a8d4f4b24a Added documentation for -X command line switch which allows the user to
specify the desired error reporting output format.
2002-06-09 23:22:25 +00:00
H. Peter Anvin
26575434d3 Don't hard-code '.' as the current directory 2002-06-04 00:44:46 +00:00
H. Peter Anvin
626b957c5f Document "CPU IA64" 2002-06-02 07:23:28 +00:00
Debbie Wiles
4cd2604ebf Altered the documentation for the %! directive 2002-06-01 11:16:49 +00:00
Debbie Wiles
585d422f14 Documented the %! (get environment) preprocessor directive. 2002-05-29 15:36:49 +00:00
H. Peter Anvin
b6469d3a84 Allow passing options to genps.pl from the user command line 2002-05-25 22:21:27 +00:00
Debbie Wiles
64fee5a6c8 Documented %xdefine and %xidefine, and fixed an index item in %define. 2002-05-25 13:12:21 +00:00
Debbie Wiles
64de47c0cb Documented the ___NASM_PATCHLEVEL__ and __NASM_VERSION_ID__ macros. 2002-05-25 03:05:05 +00:00
H. Peter Anvin
45724a8110 Better explanation why insnsa.c is a separate module 2002-05-25 01:39:12 +00:00
H. Peter Anvin
36775e439f Missed one undecorated ORG 2002-05-24 20:33:51 +00:00
Debbie Wiles
bbe2f5ef31 Fixed a few typos, tidied up index entries for BIN and its' subentries. 2002-05-24 20:00:52 +00:00
Debbie Wiles
a77955580e Reversed a few changes erroneously removed in the last update 2002-05-24 19:10:40 +00:00
Debbie Wiles
f128b4b164 Added multisection to documentation for the .bin format, and removed obsolete details. 2002-05-24 14:36:19 +00:00
H. Peter Anvin
8b923b1231 Fix typo: "BIT 16" -> "BITS 16" 2002-05-23 06:40:32 +00:00