X-Git-Url: http://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2FMakefile.am;h=29c06739657ec6d5ed4c7fb7e6122468494f4e1a;hb=e03d7c66c57bf268b87296566a5160039f35ccfb;hp=c9e3bee53881559830fc220f3adaad59c5504516;hpb=41ad81d87d649dd658ef0305d3abc987abb3fc5d;p=lttng-ust.git diff --git a/doc/man/Makefile.am b/doc/man/Makefile.am index c9e3bee5..29c06739 100644 --- a/doc/man/Makefile.am +++ b/doc/man/Makefile.am @@ -1,3 +1,5 @@ +# SPDX-FileCopyrightText: 2023 EfficiOS, Inc +# # SPDX-License-Identifier: LGPL-2.1-only # Man pages are only built if they are enabled at configure time. @@ -12,16 +14,24 @@ MAN1_NAMES = \ lttng-gen-tp MAN3_NAMES = \ lttng-ust \ - tracef \ - tracelog \ lttng-ust-dl \ - lttng-ust-cyg-profile + lttng-ust-cyg-profile \ + lttng_ust_tracef \ + lttng_ust_tracelog \ + tracef \ + tracelog # Man page aliases (generated from other sources): -MAN3_ALIASES = vtracef.3 vtracelog.3 +MAN3_ALIASES = lttng_ust_vtracef.3 lttng_ust_vtracelog.3 # troff man pages: -MAN3_TROFF = do_tracepoint.3 tracepoint.3 tracepoint_enabled.3 +MAN3_TROFF = \ + do_tracepoint.3 \ + lttng_ust_do_tracepoint.3 \ + lttng_ust_tracepoint.3 \ + lttng_ust_tracepoint_enabled.3 \ + tracepoint.3 \ + tracepoint_enabled.3 # AsciiDoc sources and outputs: MAN1_TXT = $(call manaddsuffix,.1.txt,$(MAN1_NAMES)) @@ -61,6 +71,10 @@ xmlto_verbose = $(xmlto_verbose_@AM_V@) xmlto_verbose_ = $(xmlto_verbose_@AM_DEFAULT_V@) xmlto_verbose_0 = @echo " XMLTO " $@; +xmlto_verbose_out = $(xmlto_verbose_out_@AM_V@) +xmlto_verbose_out_ = $(xmlto_verbose_out_@AM_DEFAULT_V@) +xmlto_verbose_out_0 = 2>/dev/null + # Tools to execute: ADOC = $(asciidoc_verbose)$(ASCIIDOC) -f $(ASCIIDOC_CONF) -d manpage \ -a mansource="LTTng" \ @@ -75,19 +89,38 @@ XTO = $(xmlto_verbose)$(XMLTO) -m $(XSL_FILE) man $(ADOC_DOCBOOK) -o $@ $< %.1: %.1.xml $(XSL_FILE) - $(XTO) $< 2>/dev/null + $(XTO) $< $(xmlto_verbose_out) %.3.xml: $(srcdir)/%.3.txt $(COMMON_DEPS) $(ADOC_DOCBOOK) -o $@ $< -tracef.3 vtracef.3 &: tracef.3.xml $(XSL_FILE) - $(XTO) $< 2>/dev/null +# These pair of files are generated by a single invocation of xmlto, use +# an empty rule that depends on a fake intermediate file to track the +# dependencies without resorting to Group Targets which were only +# introduced in GNU Make 4.3. +lttng_ust_tracef.3 lttng_ust_vtracef.3: lttng_ust_tracef.3.alias + @# Empty recipe to mark lttng_ust_tracef.3 and lttng_ust_vtracef.3 as rebuilt + +lttng_ust_tracelog.3 lttng_ust_vtracelog.3: lttng_ust_tracelog.3.alias + @# Empty recipe to mark lttng_ust_tracelog.3 and lttng_ust_vtracelog.3 as rebuilt + + +.INTERMEDIATE: tracef.3.alias tracelog.3.alias lttng_ust_tracef.3.alias lttng_ust_tracelog.3.alias + +tracef.3.alias: tracef.3.xml $(XSL_FILE) + $(XTO) $< $(xmlto_verbose_out) + +tracelog.3.alias: tracelog.3.xml $(XSL_FILE) + $(XTO) $< $(xmlto_verbose_out) + +lttng_ust_tracef.3.alias: lttng_ust_tracef.3.xml $(XSL_FILE) + $(XTO) $< $(xmlto_verbose_out) -tracelog.3 vtracelog.3 &: tracelog.3.xml $(XSL_FILE) - $(XTO) $< 2>/dev/null +lttng_ust_tracelog.3.alias: lttng_ust_tracelog.3.xml $(XSL_FILE) + $(XTO) $< $(xmlto_verbose_out) %.3: %.3.xml $(XSL_FILE) - $(XTO) $< 2>/dev/null + $(XTO) $< $(xmlto_verbose_out) # Only clean the generated files if we have the tools to generate them again. CLEANFILES = $(MAN_XML) $(MAN)