nasm/doc
H. Peter Anvin 7e80d6b834 Make: handle warning files while building in a directory
The dependency on the warning files breaks when we are building in a
directory *and* the files already exist from being shipped with the
distribution tarballs. The make VPATH simply isn't sophisticated
enough to deal with it, so let the C compiler handle it by #including
the generated file from a dummy C file.

Reported-by: Rudi Heitbaum <rudi@heitbaum.com>
Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2023-01-17 13:05:55 -08:00
..
afmmetrics.ph doc: fix fonts where the scale (unitsPerEm) is not 1000 2017-04-10 15:21:04 -07:00
changes.src doc: fix HTML table of contents generation 2022-12-21 18:23:27 -08:00
findfont.ph doc: fix yet another set of Ghostscript font problems 2019-06-06 20:51:10 -07:00
genps.pl doc/genps.pl: handle large lists of index entries 2022-11-08 15:24:24 -08:00
head.ps doc: actually *use* the smaller code font size... 2020-06-27 23:10:50 -07:00
inslist.pl doc: clean up the instruction list in the documentation slightly 2017-04-07 09:51:24 -07:00
internal.doc Better explanation why insnsa.c is a separate module 2002-05-25 01:39:12 +00:00
local.css doc: add a local.css specifically to be overridden locally 2017-04-16 23:52:23 -07:00
Makefile.in Make: handle warning files while building in a directory 2023-01-17 13:05:55 -08:00
nasmdoc.css doc: improve the HTML index readability 2022-11-09 21:37:16 -08:00
nasmdoc.src Document CPU LATEVEX, add CPU EVEX and CPU VEX flags 2022-12-07 10:11:21 -08:00
nasmlogo.eps doc: New NASM logo 2012-02-25 14:53:34 -08:00
nasmlogw.png doc: add indented paragraphs, valid XHTML, CSS style sheet 2017-04-13 22:12:05 -07:00
opt_var.txt Fix some typos 2022-01-09 17:34:35 +01:00
psfonts.ph psfonts.ph: add more font aliases 2022-11-08 15:12:31 -08:00
pspdf.pl Fix some typos 2022-01-09 17:34:35 +01:00
pswidth.ph doc: fix fonts where the scale (unitsPerEm) is not 1000 2017-04-10 15:21:04 -07:00
rdsrc.pl doc: html: add Chapter 1 to navbar in the TOC 2022-12-21 18:35:17 -08:00
README Document/update dependencies for the documentation 2017-05-02 13:01:59 -07:00
ttfmetrics.ph doc: fix fonts where the scale (unitsPerEm) is not 1000 2017-04-10 15:21:04 -07:00

To build the entire documentation, the following tools are needed:

1. A Perl interpreter for your platform
2. The following Perl modules available from CPAN:
   Font::TTF
   Sort::Versions
3. asciidoc
   http://asciidoc.org/
4. xmlto
   https://fedorahosted.org/xmlto
5. One of:
	Adobe Acrobat (acrodist)
	Ghostscript (ps2pdf) http://download.ghostscript.com/
	pstopdf	(available on some BSD-derived Unix systems)

	Of these, Ghostscript is the most tested, although Acrobat has
	been claimed to generate smaller files.
6. For best results, the Adobe fonts Source Sans Pro and Source Code
   Pro, available for free at:
   https://github.com/adobe-fonts