# SPDX-License-Identifier: GPL-2.0 doc_dir:=$(src)/Documentation export doc_dir SUBDIR += trace-cmd SUBDIR += libtracecmd .PHONY: $(SUBDIR) DOCDIR = $(src)/Documentation ASCIIDOC=asciidoc ASCIIDOC_CONF = $(DOCDIR)/asciidoc.conf ASCIIDOC_EXTRA = --unsafe -f $(ASCIIDOC_CONF) ASCIIDOC_HTML = xhtml11 MANPAGE_XSL = $(DOCDIR)/manpage-normal.xsl XMLTO_EXTRA = INSTALL?=install RM ?= rm -f ASCIIDOC_INSTALLED := $(shell command -v $(ASCIIDOC) 2> /dev/null) ifndef ASCIIDOC_INSTALLED missing_tools += $(ASCIIDOC) endif XMLTO=xmlto XMLTO_INSTALLED := $(shell command -v $(XMLTO) 2> /dev/null) ifndef XMLTO_INSTALLED missing_tools += $(XMLTO) endif # # 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 ASCIIDOC8 ASCIIDOC_EXTRA += -a asciidoc7compatible endif ifdef DOCBOOK_XSL_172 ASCIIDOC_EXTRA += -a libtracecmd-asciidoc-no-roff MANPAGE_XSL = $(DOCDIR)/manpage-1.72.xsl else 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 libtracecmd-asciidoc-no-roff endif endif ifdef MAN_BOLD_LITERAL XMLTO_EXTRA += -m $(DOCDIR)/manpage-bold-literal.xsl endif ifdef DOCBOOK_SUPPRESS_SP XMLTO_EXTRA += -m $(DOCDIR)/manpage-suppress-sp.xsl endif ifdef USE_ASCIIDOCTOR ASCIIDOC = asciidoctor ASCIIDOC_EXTRA = -a compat-mode ASCIIDOC_EXTRA += -I. -rasciidoctor-extensions ASCIIDOC_HTML = xhtml5 endif ifneq ($(findstring $(MAKEFLAGS),w),w) PRINT_DIR = --no-print-directory else # "make -w" NO_SUBDIR = : endif export ASCIIDOC ASCIIDOC_CONF ASCIIDOC_EXTRA ASCIIDOC_HTML export MANPAGE_XSL export XMLTO XMLTO_INSTALLED XMLTO_EXTRA export missing_tools export RM all: $(SUBDIR) clean: $(SUBDIR) install: $(SUBDIR) $(SUBDIR): make -C $@ $(MAKECMDGOALS)