perf doc: Define man page date when using asciidoctor
authorBen Hutchings <benh@debian.org>
Sat, 13 May 2023 20:37:24 +0000 (22:37 +0200)
committerArnaldo Carvalho de Melo <acme@redhat.com>
Mon, 15 May 2023 20:48:46 +0000 (17:48 -0300)
When building perf documentation with asciidoc, we use "git log" to
find the last commit date of each doc source and pass that to asciidoc
to use as the man page date.

When using asciidoctor, however, the current date is always used
instead.  Defining perf_date like we do for asciidoc also doesn't
work because we're not using DocBook as an intermediate format.
The asciidoctor man page backend looks for the variable "docdate",
so set that instead.

Signed-off-by: Ben Hutchings <benh@debian.org>
Acked-by: Ian Rogers<irogers@google.com>
Cc: Ingo Molnar <mingo@redhat.com>
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Salvatore Bonaccorso <carnil@debian.org>
Link: https://lore.kernel.org/r/ZF/1BOahN/i6xbBx@decadent.org.uk
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
tools/perf/Documentation/Makefile

index ba5d942e4c6aabe22a222dd0c20b06c1fe6f289a..8a7d7078e3867f65fb2a1a2da9b90efdb4c5824d 100644 (file)
@@ -250,11 +250,16 @@ $(MAN_HTML): $(OUTPUT)%.html : %.txt
                $(ASCIIDOC_EXTRA) -aperf_version=$(PERF_VERSION) -o $@+ $< && \
        mv $@+ $@
 
+# Generate date from git log of the doc input file
+PERF_DATE = $(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) -o $@+ $< && \
+               $(ASCIIDOC_EXTRA) -aperf_version=$(PERF_VERSION) \
+               -adocdate=$(PERF_DATE) -o $@+ $< && \
        mv $@+ $@
 endif
 
@@ -266,9 +271,7 @@ $(OUTPUT)%.xml : %.txt
        $(QUIET_ASCIIDOC)$(RM) $@+ $@ && \
        $(ASCIIDOC) -b docbook -d manpage \
                $(ASCIIDOC_EXTRA) -aperf_version=$(PERF_VERSION) \
-               -aperf_date=$(shell git log -1 --pretty="format:%cd" \
-                               --date=short --no-show-signature $<) \
-               -o $@+ $< && \
+               -aperf_date=$(PERF_DATE) -o $@+ $< && \
        mv $@+ $@
 
 XSLT = docbook.xsl