[PATCH] perf docs: Fix perf-check manual page built with asciidoctor
authorBen Hutchings <benh@debian.org>
Sun, 23 Mar 2025 20:04:02 +0000 (21:04 +0100)
committerSalvatore Bonaccorso <carnil@debian.org>
Tue, 6 May 2025 19:33:52 +0000 (21:33 +0200)
commit5d414019db5d1173344b051bbba9aa0b2ca98939
tree609bb702d9d2b339357ead3d6b4d6b3cb3d30c5d
parentd3dd70f9bab04e3f78f40400d66b6d47fc555089
[PATCH] perf docs: Fix perf-check manual page built with asciidoctor

Forwarded: https://lore.kernel.org/linux-perf-users/Z-BxCE8WrcRmR_5f@decadent.org.uk/

asciidoctor is more picky than asciidoc about the length of heading
underlines, and currently mis-parses perf-check.txt:

  ASCIIDOC perf-check.1
asciidoctor: ERROR: perf-check.txt: line 1: non-conforming manpage title
asciidoctor: ERROR: perf-check.txt: line 1: name section expected
asciidoctor: WARNING: perf-check.txt: line 2: unterminated example block
asciidoctor: WARNING: perf-check.txt: line 5: unterminated listing block

Fix the length of the title underline so it works properly.

Fixes: 98ad0b77323c ("perf check: Introduce 'check' subcommand")
Signed-off-by: Ben Hutchings <benh@debian.org>
Gbp-Pq: Topic bugfix/all
Gbp-Pq: Name perf-docs-Fix-perf-check-manual-page-built-with-asci.patch
tools/perf/Documentation/perf-check.txt