102 lines
2.3 KiB
Makefile
102 lines
2.3 KiB
Makefile
|
# 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)
|
||
|
|
|