mirror/nasm
2
0
Fork 0
mirror of https://github.com/netwide-assembler/nasm.git synced 2024-11-27 08:10:07 +08:00
Code Issues Packages Projects Releases Wiki Activity
d31a74e301
nasm/doc/Makefile.in

86 lines
2.0 KiB
Makefile
Raw Normal View History

NASM 0.98
2002-05-01 04:58:18 +08:00
#
# UNIX Makefile for NASM documentation
#
Fix building in a separate directory from the source code The code to handle building in a separate directory had seriously bitrotted. This contains a number of fixes to make it possible, including bits like the documentation which never worked in the past. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2016-05-17 11:30:09 +08:00
top_srcdir = @top_srcdir@
NASM 0.98
2002-05-01 04:58:18 +08:00
srcdir = @srcdir@
VPATH = @srcdir@
prefix = @prefix@
exec_prefix = @exec_prefix@
bindir = @bindir@
mandir = @mandir@
docdir = $(prefix)/doc/nasm
infodir = @infodir@
Suppress datarootdir warnings from configure
2007-10-19 14:33:06 +08:00
datarootdir = @datarootdir@
NASM 0.98
2002-05-01 04:58:18 +08:00
INSTALL = @INSTALL@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
INSTALL_DATA = @INSTALL_DATA@
Fix building in a separate directory from the source code The code to handle building in a separate directory had seriously bitrotted. This contains a number of fixes to make it possible, including bits like the documentation which never worked in the past. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2016-05-17 11:30:09 +08:00
PERL = perl -I$(srcdir)
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-20 02:39:23 +08:00
doc: add the option to generate an uncompressed PDF An uncompressed PDF is about twice as big, but if one is using an external compression program (e.g. .pdf.xz) it compresses far better. Use it for the RPM specfile. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2017-04-11 07:10:28 +08:00
PDFOPT = @PDFOPT@
NASM 0.98
2002-05-01 04:58:18 +08:00
msvc: finally make it possible to build the full Windows package Finally make it possible to build the full Windows install package with MSVC tools. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-07 11:20:04 +08:00
RM_F = rm -f
RM_RF = rm -rf
doc: add indented paragraphs, valid XHTML, CSS style sheet Add indented paragraphs, which can be used to continue an item in a bulleted list. Produce valid strict XHTML, and include a style sheet with a navbar and other fancy things. Remove archaic output formats. Now only text, XHTML, and PDF are supported. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-14 12:54:42 +08:00
CP_F = cp -f
doc: add a local.css specifically to be overridden locally Add a file local.css which is referenced *after* nasmdoc.css, thus overriding the latter. This file intentionally has no actual content, which means it can be overridden locally for any desired content, e.g. indexing into web fonts or overriding any of the style. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2017-04-17 14:52:23 +08:00
CP_UF = cp -ufv
# Auxiliary files referenced by the HTML files
HTMLAUX = nasmdoc.css local.css nasmlogw.png
msvc: finally make it possible to build the full Windows package Finally make it possible to build the full Windows install package with MSVC tools. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-07 11:20:04 +08:00
doc: generate proper XHTML for the contents and index The table of contents and index needed rework to be valid (X)HTML. The TOC in particular needed some fairly significant rework - it is supposed to be an ordered list, after all. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-14 16:50:13 +08:00
SRCS = nasmdoc.src inslist.src changes.src version.src
doc: add indented paragraphs, valid XHTML, CSS style sheet Add indented paragraphs, which can be used to continue an item in a bulleted list. Produce valid strict XHTML, and include a style sheet with a navbar and other fancy things. Remove archaic output formats. Now only text, XHTML, and PDF are supported. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-14 12:54:42 +08:00
OUT = html nasmdoc.txt nasmdoc.pdf
NASM 0.98
2002-05-01 04:58:18 +08:00
doc: improve the look of the documentation with better fonts Use the Adobe Source Sans/Code Pro fonts by default. They are Open Source fonts by Adobe. However, since these fonts are quite large, let them be an external dependency and do our best to try to find them with whatever mechanism is available on the system for finding standard fonts. Also have a list of substitution fonts if necessary. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2017-04-10 21:35:29 +08:00
.SUFFIXES: .pfa .ph
NASM 0.98
2002-05-01 04:58:18 +08:00
all: $(OUT)
doc: update location of insns.dat insns.dat is now in the x86 directory. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2016-07-07 02:01:12 +08:00
inslist.src: inslist.pl ../x86/insns.dat
$(PERL) $(srcdir)/inslist.pl $(srcdir)/../x86/insns.dat
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-21 13:50:02 +08:00
doc: Makefile fixes missing from previous checkin
2008-06-12 09:38:15 +08:00
.PHONY: html
doc: add a local.css specifically to be overridden locally Add a file local.css which is referenced *after* nasmdoc.css, thus overriding the latter. This file intentionally has no actual content, which means it can be overridden locally for any desired content, e.g. indexing into web fonts or overriding any of the style. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2017-04-17 14:52:23 +08:00
html: $(HTMLAUX)
doc: generate proper XHTML for the contents and index The table of contents and index needed rework to be valid (X)HTML. The TOC in particular needed some fairly significant rework - it is supposed to be an ordered list, after all. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-14 16:50:13 +08:00
mkdir -p html
doc: add a local.css specifically to be overridden locally Add a file local.css which is referenced *after* nasmdoc.css, thus overriding the latter. This file intentionally has no actual content, which means it can be overridden locally for any desired content, e.g. indexing into web fonts or overriding any of the style. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2017-04-17 14:52:23 +08:00
for f in $(HTMLAUX); do $(CP_UF) "$(srcdir)/$$f" html/; done
$(MAKE) html/nasmdoc0.html
doc: Makefile fixes missing from previous checkin
2008-06-12 09:38:15 +08:00
Fix building in a separate directory from the source code The code to handle building in a separate directory had seriously bitrotted. This contains a number of fixes to make it possible, including bits like the documentation which never worked in the past. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2016-05-17 11:30:09 +08:00
RDSRC = $(PERL) $(srcdir)/rdsrc.pl -I$(srcdir)/
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 14:45:57 +08:00
html/nasmdoc0.html: $(SRCS) rdsrc.pl
doc: generate proper XHTML for the contents and index The table of contents and index needed rework to be valid (X)HTML. The TOC in particular needed some fairly significant rework - it is supposed to be an ordered list, after all. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-14 16:50:13 +08:00
$(RM_F) html/*.html
doc: complete removal of unnecessary moves Make the tool write the output (especially HTML) in a specified subdirectory directly, and make the tool create the subdirectory if it doesn't already exists. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2017-04-07 11:33:39 +08:00
$(RDSRC) -ohtml html nasmdoc.src
NASM 0.98
2002-05-01 04:58:18 +08:00
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 14:45:57 +08:00
nasmdoc.dip: $(SRCS) rdsrc.pl
msvc: finally make it possible to build the full Windows package Finally make it possible to build the full Windows install package with MSVC tools. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-07 11:20:04 +08:00
$(RDSRC) dip nasmdoc.src
doc: Makefile fixes missing from previous checkin
2008-06-12 09:38:15 +08:00
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 14:45:57 +08:00
nasmdoc.txt: $(SRCS) rdsrc.pl
msvc: finally make it possible to build the full Windows package Finally make it possible to build the full Windows install package with MSVC tools. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-07 11:20:04 +08:00
$(RDSRC) txt nasmdoc.src
Fix building in a separate directory from the source code The code to handle building in a separate directory had seriously bitrotted. This contains a number of fixes to make it possible, including bits like the documentation which never worked in the past. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2016-05-17 11:30:09 +08:00
version.src: $(top_srcdir)/version.pl $(top_srcdir)/version
$(PERL) $(top_srcdir)/version.pl docsrc \
< $(top_srcdir)/version > version.src
Support generating PDF using ps2pdf with special annotations in the PostScript output of rdsrc.pl.
2002-05-04 22:16:20 +08:00
Makefile.in: add ttfmetrics.ph as a dependency The new module ttfmetrics.ph is a dependency. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2017-04-10 21:41:13 +08:00
nasmdoc.ps: nasmdoc.dip genps.pl afmmetrics.ph ttfmetrics.ph \
pswidth.ph nasmlogo.eps psfonts.ph head.ps
Fix building in a separate directory from the source code The code to handle building in a separate directory had seriously bitrotted. This contains a number of fixes to make it possible, including bits like the documentation which never worked in the past. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2016-05-17 11:30:09 +08:00
$(PERL) $(srcdir)/genps.pl -headps $(srcdir)/head.ps nasmdoc.dip \
> nasmdoc.ps
Don't remove head.ps by mistake
2002-05-15 05:21:24 +08:00
doc: add the option to generate an uncompressed PDF An uncompressed PDF is about twice as big, but if one is using an external compression program (e.g. .pdf.xz) it compresses far better. Use it for the RPM specfile. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2017-04-11 07:10:28 +08:00
nasmdoc.pdf: nasmdoc.ps pspdf.pl
configure, doc/Makefile.in: fix out-of-directory build Fix bit rot for out of directory builds. Signed-off-by: Ed Beroset <beroset@mindspring.com> Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-14 22:11:57 +08:00
$(PERL) $(srcdir)/pspdf.pl $(PDFOPT) nasmdoc.ps nasmdoc.pdf
Don't remove head.ps by mistake
2002-05-15 05:21:24 +08:00
NASM 0.98
2002-05-01 04:58:18 +08:00
clean:
msvc: finally make it possible to build the full Windows package Finally make it possible to build the full Windows install package with MSVC tools. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-07 11:20:04 +08:00
-$(RM_F) *.rtf *.hpj *.texi *.gid *.ipf *.dip
-$(RM_F) *.aux *.cp *.fn *.ky *.pg *.log *.toc *.tp *.vr
-$(RM_F) inslist.src version.src
doc/Makefile.in: drop nasmdoc.ps as a usable documentation file There is no sane reason to use nasmdoc.ps over nasmdoc.pdf since, oh, about 20 years. nasmdoc.ps doesn't embed the fonts (and if it did, it would be very large, whereas nasmdoc.pdf only contains the characters we explicitly need), and support for PDF is generally much better than support for PostScript. It also makes the distribution file smaller to not have two redundant files. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2017-04-11 06:34:59 +08:00
-$(RM_F) nasmdoc*.ps
NASM 0.98
2002-05-01 04:58:18 +08:00
spotless: clean
msvc: finally make it possible to build the full Windows package Finally make it possible to build the full Windows install package with MSVC tools. Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
2017-04-07 11:20:04 +08:00
-$(RM_RF) html info
-$(RM_F) *.hlp nasmdoc.txt *.inf *.pdf *.dvi
NASM 0.98
2002-05-01 04:58:18 +08:00
install: all
mkdir -p $(INSTALLROOT)$(docdir)/html
$(INSTALL_DATA) html/* $(INSTALLROOT)$(docdir)/html
doc/Makefile.in: drop nasmdoc.ps as a usable documentation file There is no sane reason to use nasmdoc.ps over nasmdoc.pdf since, oh, about 20 years. nasmdoc.ps doesn't embed the fonts (and if it did, it would be very large, whereas nasmdoc.pdf only contains the characters we explicitly need), and support for PDF is generally much better than support for PostScript. It also makes the distribution file smaller to not have two redundant files. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
2017-04-11 06:34:59 +08:00
$(INSTALL_DATA) nasmdoc.pdf nasmdoc.txt $(INSTALLROOT)$(docdir)
Reference in New Issue Copy Permalink