Commit graph

222 commits

Author SHA1 Message Date
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