nasm/doc
H. Peter Anvin b2004511dd ELF: handle more than 32,633 sections
Dead code elimination in ELF uses separate ELF sections for every
functions or data items that may be garbage collected. This can end up
being more than 32,633 sections which, when the ELF internal and
relocation sections are added in, can exceed the legacy ELF maximum of
65,279 sections.

Newer versions of the ELF specification has added support for much
larger number of sections by putting a place holder value (usually
SHN_XINDEX == 0xffff, but 0 in some cases) into fields where the
section index is a 16-bit value, and storing the full value in a
diffent place: the program header uses entries in section header 0,
the symbol table uses an auxiliary segment with the additional
indicies; the section header did not need it as the sh_link field is
already 32 (or 64) bits long.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2019-02-26 00:02:35 -08:00
..
afmmetrics.ph doc: fix fonts where the scale (unitsPerEm) is not 1000 2017-04-10 15:21:04 -07:00
changes.src ELF: handle more than 32,633 sections 2019-02-26 00:02:35 -08:00
findfont.ph win32, doc: fix PDF generation scripts for Windows 2017-04-26 00:05:12 -07:00
genps.pl nasmdoc.pdf: always begin a chapter on an odd page 2017-04-17 16:01:31 -07:00
head.ps doc: add indented paragraphs, valid XHTML, CSS style sheet 2017-04-13 22:12:05 -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 dependency generation a bit more robust 2017-11-06 22:37:37 -08:00
nasmdoc.css nasmdoc.css: add more space between columns and a column separator 2017-05-02 13:09:49 -07:00
nasmdoc.src ELF: add support for the ELF "merge" attribute 2018-12-30 07:54:48 -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 optimization: Introduce new flag to turn-off selectively 2018-08-16 00:01:31 +03:00
psfonts.ph doc: add indented paragraphs, valid XHTML, CSS style sheet 2017-04-13 22:12:05 -07:00
pspdf.pl pspdf.pl: GhostScript font integration seems broken with -dSAFER 2018-09-24 18:02:22 -07:00
pswidth.ph doc: fix fonts where the scale (unitsPerEm) is not 1000 2017-04-10 15:21:04 -07:00
rdsrc.pl doc/rdsrc.pl: fix unescaped brace 2018-06-25 23:13:59 -07: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