[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, 12 Aug 2025 03:28:04 +0000 (05:28 +0200)
commitf7225430dd2ed2992a7a9a1e1f36413fce53ff9f
tree1e129bc3f428a4befe2f792e5fb4535325565876
parent81637a7f7dbf7ceadda627b9b15f875fa40a4d0d
[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