Something went wrong. Try again.
(I'm so sorry!) Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316# SPDX-License-Identifier: GPL-2.0-onlyinclude ../../scripts/Makefile.includeinclude ../../scripts/utilities.mak
ARTICLES =# with their own formatting rules.SP_ARTICLES =
MAN1_TXT= \ $(filter-out $(addsuffix .txt, $(ARTICLES) $(SP_ARTICLES)), \ $(wildcard perf-*.txt)) \ perf.txtMAN5_TXT=MAN7_TXT=
MAN_TXT = $(MAN1_TXT) $(MAN5_TXT) $(MAN7_TXT)_MAN_XML=$(patsubst %.txt,%.xml,$(MAN_TXT))_MAN_HTML=$(patsubst %.txt,%.html,$(MAN_TXT))
MAN_XML=$(addprefix $(OUTPUT),$(_MAN_XML))MAN_HTML=$(addprefix $(OUTPUT),$(_MAN_HTML))
_DOC_HTML = $(_MAN_HTML)_DOC_HTML+=$(patsubst %,%.html,$(ARTICLES) $(SP_ARTICLES))DOC_HTML=$(addprefix $(OUTPUT),$(_DOC_HTML))
_DOC_MAN1=$(patsubst %.txt,%.1,$(MAN1_TXT))_DOC_MAN5=$(patsubst %.txt,%.5,$(MAN5_TXT))_DOC_MAN7=$(patsubst %.txt,%.7,$(MAN7_TXT))
DOC_MAN1=$(addprefix $(OUTPUT),$(_DOC_MAN1))DOC_MAN5=$(addprefix $(OUTPUT),$(_DOC_MAN5))DOC_MAN7=$(addprefix $(OUTPUT),$(_DOC_MAN7))
# Make the path relative to DESTDIR, not prefixifndef DESTDIRprefix?=$(HOME)endifbindir?=$(prefix)/binhtmldir?=$(prefix)/share/doc/perf-docpdfdir?=$(prefix)/share/doc/perf-docmandir?=$(prefix)/share/manman1dir=$(mandir)/man1man5dir=$(mandir)/man5man7dir=$(mandir)/man7
ASCIIDOC=asciidocASCIIDOC_EXTRA += --unsafe -f asciidoc.confASCIIDOC_HTML = xhtml11MANPAGE_XSL = manpage-normal.xslXMLTO_EXTRA =INSTALL?=installRM ?= rm -fDOC_REF = origin/manHTML_REF = origin/html
ifdef USE_ASCIIDOCTORASCIIDOC = asciidoctorASCIIDOC_EXTRA += -a compat-modeASCIIDOC_EXTRA += -I. -rasciidoctor-extensionsASCIIDOC_EXTRA += -a mansource="perf" -a manmanual="perf Manual"ASCIIDOC_HTML = xhtml5endif
infodir?=$(prefix)/share/infoMAKEINFO=makeinfoINSTALL_INFO=install-infoDOCBOOK2X_TEXI=docbook2x-texiDBLATEX=dblatexXMLTO=xmltoifndef PERL_PATH PERL_PATH = /usr/bin/perlendif
-include ../config.mak.autogen-include ../config.mak
_tmp_tool_path := $(call get-executable,$(ASCIIDOC))ifeq ($(_tmp_tool_path),) missing_tools = $(ASCIIDOC)endif
ifndef USE_ASCIIDOCTOR_tmp_tool_path := $(call get-executable,$(XMLTO))ifeq ($(_tmp_tool_path),) missing_tools += $(XMLTO)endifendif
## For asciidoc ...# -7.1.2, no extra settings are needed.# 8.0-, set ASCIIDOC8.#
## For docbook-xsl ...# -1.68.1, set ASCIIDOC_NO_ROFF? (based on changelog from 1.73.0)# 1.69.0, no extra settings are needed?# 1.69.1-1.71.0, set DOCBOOK_SUPPRESS_SP?# 1.71.1, no extra settings are needed?# 1.72.0, set DOCBOOK_XSL_172.# 1.73.0-, set ASCIIDOC_NO_ROFF#
## If you had been using DOCBOOK_XSL_172 in an attempt to get rid# of 'the ".ft C" problem' in your generated manpages, and you# instead ended up with weird characters around callouts, try# using ASCIIDOC_NO_ROFF instead (it works fine with ASCIIDOC8).#
ifdef ASCIIDOC8ASCIIDOC_EXTRA += -a asciidoc7compatibleendififdef DOCBOOK_XSL_172ASCIIDOC_EXTRA += -a perf-asciidoc-no-roffMANPAGE_XSL = manpage-1.72.xslelse ifdef ASCIIDOC_NO_ROFF # docbook-xsl after 1.72 needs the regular XSL, but will not # pass-thru raw roff codes from asciidoc.conf, so turn them off. ASCIIDOC_EXTRA += -a perf-asciidoc-no-roff endifendififdef MAN_BOLD_LITERALXMLTO_EXTRA += -m manpage-bold-literal.xslendififdef DOCBOOK_SUPPRESS_SPXMLTO_EXTRA += -m manpage-suppress-sp.xslendif
SHELL_PATH ?= $(SHELL)# Shell quote;SHELL_PATH_SQ = $(subst ','\'',$(SHELL_PATH))
## Please note that there is a minor bug in asciidoc.# The version after 6.0.3 _will_ include the patch found here:# http://marc.theaimsgroup.com/?l=perf&m=111558757202243&w=2## Until that version is released you may have to apply the patch# yourself - yes, all 6 characters of it!#
QUIET_SUBDIR0 = +$(MAKE) -C # space to separate -C and subdirQUIET_SUBDIR1 =
ifneq ($(findstring $(MAKEFLAGS),w),w)PRINT_DIR = --no-print-directoryelse # "make -w"NO_SUBDIR = :endif
ifneq ($(findstring $(MAKEFLAGS),s),s)ifneq ($(V),1) QUIET_ASCIIDOC = @echo ' ASCIIDOC '$@; QUIET_XMLTO = @echo ' XMLTO '$@; QUIET_DB2TEXI = @echo ' DB2TEXI '$@; QUIET_MAKEINFO = @echo ' MAKEINFO '$@; QUIET_DBLATEX = @echo ' DBLATEX '$@; QUIET_XSLTPROC = @echo ' XSLTPROC '$@; QUIET_GEN = @echo ' GEN '$@; QUIET_STDERR = 2> /dev/null QUIET_SUBDIR0 = +@subdir= QUIET_SUBDIR1 = ;$(NO_SUBDIR) \ echo ' SUBDIR ' $$subdir; \ $(MAKE) $(PRINT_DIR) -C $$subdir export Vendifendif
all: html man info
html: $(DOC_HTML)
$(DOC_HTML) $(DOC_MAN1) $(DOC_MAN5) $(DOC_MAN7): asciidoc.conf
man: man1 man5 man7man1: $(DOC_MAN1)man5: $(DOC_MAN5)man7: $(DOC_MAN7)
info: $(OUTPUT)perf.info $(OUTPUT)perfman.info
install: install-man
check-man-tools:ifdef missing_tools $(error "You need to install $(missing_tools) for man pages")endif
do-install-man: man $(call QUIET_INSTALL, Documentation-man) \ $(INSTALL) -d -m 755 $(DESTDIR)$(man1dir); \# $(INSTALL) -d -m 755 $(DESTDIR)$(man5dir); \# $(INSTALL) -d -m 755 $(DESTDIR)$(man7dir); \ $(INSTALL) -m 644 $(DOC_MAN1) $(DESTDIR)$(man1dir); \# $(INSTALL) -m 644 $(DOC_MAN5) $(DESTDIR)$(man5dir); \# $(INSTALL) -m 644 $(DOC_MAN7) $(DESTDIR)$(man7dir)
install-man: check-man-tools man do-install-man
ifdef missing_tools DO_INSTALL_MAN = $(warning Please install $(missing_tools) to have the man pages installed)else DO_INSTALL_MAN = do-install-manendif
try-install-man: $(DO_INSTALL_MAN)
install-info: info $(call QUIET_INSTALL, Documentation-info) \ $(INSTALL) -d -m 755 $(DESTDIR)$(infodir); \ $(INSTALL) -m 644 $(OUTPUT)perf.info $(OUTPUT)perfman.info $(DESTDIR)$(infodir); \ if test -r $(DESTDIR)$(infodir)/dir; then \ $(INSTALL_INFO) --info-dir=$(DESTDIR)$(infodir) perf.info ;\ $(INSTALL_INFO) --info-dir=$(DESTDIR)$(infodir) perfman.info ;\ else \ echo "No directory found in $(DESTDIR)$(infodir)" >&2 ; \ fi
#install-html: html# '$(SHELL_PATH_SQ)' ./install-webdoc.sh $(DESTDIR)$(htmldir)
## Determine "include::" file references in asciidoc files.#$(OUTPUT)doc.dep : $(wildcard *.txt) build-docdep.perl $(QUIET_GEN)$(RM) $@+ $@ && \ $(PERL_PATH) ./build-docdep.perl >$@+ $(QUIET_STDERR) && \ mv $@+ $@
-include $(OUTPUT)doc.dep
CLEAN_FILES = \ $(MAN_XML) $(addsuffix +,$(MAN_XML)) \ $(MAN_HTML) $(addsuffix +,$(MAN_HTML)) \ $(DOC_HTML) $(DOC_MAN1) $(DOC_MAN5) $(DOC_MAN7) \ $(OUTPUT)*.texi $(OUTPUT)*.texi+ $(OUTPUT)*.texi++ \ $(OUTPUT)perf.info $(OUTPUT)perfman.info $(OUTPUT)doc.dep \ $(OUTPUT)technical/api-*.html $(OUTPUT)technical/api-index.txtclean: $(call QUIET_CLEAN, Documentation) $(RM) $(CLEAN_FILES)
$(MAN_HTML): $(OUTPUT)%.html : %.txt $(QUIET_ASCIIDOC)$(RM) $@+ $@ && \ $(ASCIIDOC) -b $(ASCIIDOC_HTML) -d manpage \ $(ASCIIDOC_EXTRA) -aperf_version=$(PERF_VERSION) -o $@+ $< && \ mv $@+ $@
# Generate date from either KBUILD_BUILD_TIMESTAMP or git log of# the doc input filePERF_DATE = $(strip \ $(if $(KBUILD_BUILD_TIMESTAMP), \ $(shell date -u -d '$(KBUILD_BUILD_TIMESTAMP)' +%Y-%m-%d), \ $(shell git log -1 --pretty="format:%cd" \ --date=short --no-show-signature $<)))
ifdef USE_ASCIIDOCTOR$(OUTPUT)%.1 $(OUTPUT)%.5 $(OUTPUT)%.7 : %.txt $(QUIET_ASCIIDOC)$(RM) $@+ $@ && \ $(ASCIIDOC) -b manpage -d manpage \ $(ASCIIDOC_EXTRA) -aperf_version=$(PERF_VERSION) \ -adocdate=$(PERF_DATE) -o $@+ $< && \ mv $@+ $@endif
$(OUTPUT)%.1 $(OUTPUT)%.5 $(OUTPUT)%.7 : $(OUTPUT)%.xml $(QUIET_XMLTO)$(RM) $@ && \ $(XMLTO) -o $(OUTPUT). -m $(MANPAGE_XSL) $(XMLTO_EXTRA) man $<
$(OUTPUT)%.xml : %.txt $(QUIET_ASCIIDOC)$(RM) $@+ $@ && \ $(ASCIIDOC) -b docbook -d manpage \ $(ASCIIDOC_EXTRA) -aperf_version=$(PERF_VERSION) \ -aperf_date=$(PERF_DATE) -o $@+ $< && \ mv $@+ $@
XSLT = docbook.xslXSLTOPTS = --xinclude --stringparam html.stylesheet docbook-xsl.css
$(OUTPUT)perfman.texi: $(MAN_XML) cat-texi.perl $(QUIET_DB2TEXI)$(RM) $@+ $@ && \ ($(foreach xml,$(MAN_XML),$(DOCBOOK2X_TEXI) --encoding=UTF-8 \ --to-stdout $(xml) &&) true) > $@++ && \ $(PERL_PATH) cat-texi.perl $@ <$@++ >$@+ && \ rm $@++ && \ mv $@+ $@
$(OUTPUT)perfman.info: $(OUTPUT)perfman.texi $(QUIET_MAKEINFO)$(MAKEINFO) --no-split --no-validate -o $@ $*.texi
$(patsubst %.txt,%.texi,$(MAN_TXT)): %.texi : %.xml $(QUIET_DB2TEXI)$(RM) $@+ $@ && \ $(DOCBOOK2X_TEXI) --to-stdout $*.xml >$@+ && \ mv $@+ $@
$(patsubst %,%.html,$(ARTICLES)) : %.html : %.txt $(QUIET_ASCIIDOC)$(ASCIIDOC) -b $(ASCIIDOC_HTML) $*.txt
WEBDOC_DEST = /pub/software/tools/perf/docs
# UNIMPLEMENTED#install-webdoc : html# '$(SHELL_PATH_SQ)' ./install-webdoc.sh $(WEBDOC_DEST)
# quick-install: quick-install-man
# quick-install-man:# '$(SHELL_PATH_SQ)' ./install-doc-quick.sh $(DOC_REF) $(DESTDIR)$(mandir)
#quick-install-html:# '$(SHELL_PATH_SQ)' ./install-doc-quick.sh $(HTML_REF) $(DESTDIR)$(htmldir)