tools/lib/perf/Documentation/Makefile

Source file repositories/reference/linux-study-clean/tools/lib/perf/Documentation/Makefile

File Facts

System
Linux kernel
Corpus path
tools/lib/perf/Documentation/Makefile
Extension
[no extension]
Size
4507 bytes
Lines
157
Domain
Support Tooling And Documentation
Bucket
tools
Inferred role
Support Tooling And Documentation: build/configuration rule
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

# SPDX-License-Identifier: (LGPL-2.1 OR BSD-2-Clause)
# Most of this file is copied from tools/perf/Documentation/Makefile

include ../../../scripts/Makefile.include
include ../../../scripts/utilities.mak

MAN3_TXT  = libperf.txt
MAN7_TXT  = libperf-counting.txt libperf-sampling.txt
MAN_EX    = examples/*.c

MAN_TXT   = $(MAN3_TXT) $(MAN7_TXT)

_MAN_XML  = $(patsubst %.txt,%.xml,$(MAN_TXT))
_MAN_HTML = $(patsubst %.txt,%.html,$(MAN_TXT))
_MAN_3    = $(patsubst %.txt,%.3,$(MAN3_TXT))
_MAN_7    = $(patsubst %.txt,%.7,$(MAN7_TXT))

MAN_XML   = $(addprefix $(OUTPUT),$(_MAN_XML))
MAN_HTML  = $(addprefix $(OUTPUT),$(_MAN_HTML))
MAN_3     = $(addprefix $(OUTPUT),$(_MAN_3))
MAN_7     = $(addprefix $(OUTPUT),$(_MAN_7))
MAN_X     = $(MAN_3) $(MAN_7)

# Make the path relative to DESTDIR, not prefix
ifndef DESTDIR
  prefix ?=$(HOME)
endif

mandir  ?= $(prefix)/share/man
man3dir  = $(mandir)/man3
man7dir  = $(mandir)/man7

docdir  ?= $(prefix)/share/doc/libperf
htmldir  = $(docdir)/html
exdir    = $(docdir)/examples

ASCIIDOC        = asciidoc
ASCIIDOC_EXTRA  = --unsafe -f asciidoc.conf
ASCIIDOC_HTML   = xhtml11
MANPAGE_XSL     = manpage-normal.xsl
XMLTO_EXTRA     =
XMLTO           =xmlto

INSTALL ?= install
RM      ?= rm -f

# 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 libperf-asciidoc-no-roff
  MANPAGE_XSL = manpage-1.72.xsl

Annotation

Implementation Notes