Lines Matching +full:technical +full:- +full:articles
1 # SPDX-License-Identifier: GPL-2.0-only
5 ARTICLES = macro
10 $(filter-out $(addsuffix .txt, $(ARTICLES) $(SP_ARTICLES)), \
11 $(wildcard perf-*.txt)) \
24 _DOC_HTML+=$(patsubst %,%.html,$(ARTICLES) $(SP_ARTICLES))
40 htmldir?=$(prefix)/share/doc/perf-doc
41 pdfdir?=$(prefix)/share/doc/perf-doc
48 ASCIIDOC_EXTRA += --unsafe -f asciidoc.conf
50 MANPAGE_XSL = manpage-normal.xsl
53 RM ?= rm -f
59 ASCIIDOC_EXTRA += -a compat-mode
60 ASCIIDOC_EXTRA += -I. -rasciidoctor-extensions
61 ASCIIDOC_EXTRA += -a mansource="perf" -a manmanual="perf Manual"
67 INSTALL_INFO=install-info
68 DOCBOOK2X_TEXI=docbook2x-texi
75 -include ../config.mak.autogen
76 -include ../config.mak
78 _tmp_tool_path := $(call get-executable,$(ASCIIDOC))
84 _tmp_tool_path := $(call get-executable,$(XMLTO))
92 # -7.1.2, no extra settings are needed.
93 # 8.0-, set ASCIIDOC8.
97 # For docbook-xsl ...
98 # -1.68.1, set ASCIIDOC_NO_ROFF? (based on changelog from 1.73.0)
100 # 1.69.1-1.71.0, set DOCBOOK_SUPPRESS_SP?
103 # 1.73.0-, set ASCIIDOC_NO_ROFF
114 ASCIIDOC_EXTRA += -a asciidoc7compatible
117 ASCIIDOC_EXTRA += -a perf-asciidoc-no-roff
118 MANPAGE_XSL = manpage-1.72.xsl
121 # docbook-xsl after 1.72 needs the regular XSL, but will not
122 # pass-thru raw roff codes from asciidoc.conf, so turn them off.
123 ASCIIDOC_EXTRA += -a perf-asciidoc-no-roff
127 XMLTO_EXTRA += -m manpage-bold-literal.xsl
130 XMLTO_EXTRA += -m manpage-suppress-sp.xsl
143 # yourself - yes, all 6 characters of it!
146 QUIET_SUBDIR0 = +$(MAKE) -C # space to separate -C and subdir
150 PRINT_DIR = --no-print-directory
151 else # "make -w"
168 $(MAKE) $(PRINT_DIR) -C $$subdir
186 install: install-man
188 check-man-tools:
193 do-install-man: man
194 $(call QUIET_INSTALL, Documentation-man) \
195 $(INSTALL) -d -m 755 $(DESTDIR)$(man1dir); \
196 # $(INSTALL) -d -m 755 $(DESTDIR)$(man5dir); \
197 # $(INSTALL) -d -m 755 $(DESTDIR)$(man7dir); \
198 $(INSTALL) -m 644 $(DOC_MAN1) $(DESTDIR)$(man1dir); \
199 # $(INSTALL) -m 644 $(DOC_MAN5) $(DESTDIR)$(man5dir); \
200 # $(INSTALL) -m 644 $(DOC_MAN7) $(DESTDIR)$(man7dir)
202 install-man: check-man-tools man do-install-man
207 DO_INSTALL_MAN = do-install-man
210 try-install-man: $(DO_INSTALL_MAN)
212 install-info: info
213 $(call QUIET_INSTALL, Documentation-info) \
214 $(INSTALL) -d -m 755 $(DESTDIR)$(infodir); \
215 $(INSTALL) -m 644 $(OUTPUT)perf.info $(OUTPUT)perfman.info $(DESTDIR)$(infodir); \
216 if test -r $(DESTDIR)$(infodir)/dir; then \
217 $(INSTALL_INFO) --info-dir=$(DESTDIR)$(infodir) perf.info ;\
218 $(INSTALL_INFO) --info-dir=$(DESTDIR)$(infodir) perfman.info ;\
223 #install-html: html
224 # '$(SHELL_PATH_SQ)' ./install-webdoc.sh $(DESTDIR)$(htmldir)
230 $(OUTPUT)doc.dep : $(wildcard *.txt) build-docdep.perl
232 $(PERL_PATH) ./build-docdep.perl >$@+ $(QUIET_STDERR) && \
235 -include $(OUTPUT)doc.dep
243 $(OUTPUT)technical/api-*.html $(OUTPUT)technical/api-index.txt
249 $(ASCIIDOC) -b $(ASCIIDOC_HTML) -d manpage \
250 $(ASCIIDOC_EXTRA) -aperf_version=$(PERF_VERSION) -o $@+ $< && \
257 $(shell date -u -d '$(KBUILD_BUILD_TIMESTAMP)' +%Y-%m-%d), \
258 $(shell git log -1 --pretty="format:%cd" \
259 --date=short --no-show-signature $<)))
264 $(ASCIIDOC) -b manpage -d manpage \
265 $(ASCIIDOC_EXTRA) -aperf_version=$(PERF_VERSION) \
266 -adocdate=$(PERF_DATE) -o $@+ $< && \
272 $(XMLTO) -o $(OUTPUT). -m $(MANPAGE_XSL) $(XMLTO_EXTRA) man $<
276 $(ASCIIDOC) -b docbook -d manpage \
277 $(ASCIIDOC_EXTRA) -aperf_version=$(PERF_VERSION) \
278 -aperf_date=$(PERF_DATE) -o $@+ $< && \
282 XSLTOPTS = --xinclude --stringparam html.stylesheet docbook-xsl.css
284 $(OUTPUT)perfman.texi: $(MAN_XML) cat-texi.perl
286 ($(foreach xml,$(MAN_XML),$(DOCBOOK2X_TEXI) --encoding=UTF-8 \
287 --to-stdout $(xml) &&) true) > $@++ && \
288 $(PERL_PATH) cat-texi.perl $@ <$@++ >$@+ && \
293 $(QUIET_MAKEINFO)$(MAKEINFO) --no-split --no-validate -o $@ $*.texi
297 $(DOCBOOK2X_TEXI) --to-stdout $*.xml >$@+ && \
300 $(patsubst %,%.html,$(ARTICLES)) : %.html : %.txt
301 $(QUIET_ASCIIDOC)$(ASCIIDOC) -b $(ASCIIDOC_HTML) $*.txt
306 #install-webdoc : html
307 # '$(SHELL_PATH_SQ)' ./install-webdoc.sh $(WEBDOC_DEST)
309 # quick-install: quick-install-man
311 # quick-install-man:
312 # '$(SHELL_PATH_SQ)' ./install-doc-quick.sh $(DOC_REF) $(DESTDIR)$(mandir)
314 #quick-install-html:
315 # '$(SHELL_PATH_SQ)' ./install-doc-quick.sh $(HTML_REF) $(DESTDIR)$(htmldir)