Merge pull request #15935 from edsantiago/xref_manpage_title

[CI:DOCS] man page xref: verify page title

docs/source/markdown/podman-machine-list.1.md

@@ -1,4 +1,4 @@
-% podman-machine-ls 1
+% podman-machine-list 1
 
 ## NAME
 podman\-machine\-list - List virtual machines

hack/xref-helpmsgs-manpages

@@ -292,6 +292,15 @@ sub podman_man {
         chomp $line;
         next unless $line;		# skip empty lines
 
+        # First line (page title) must match the command name.
+        if ($line =~ /^%\s+/) {
+            my $expect = "% $command 1";
+            if ($line ne $expect) {
+                warn "$ME: $subpath:$.: wrong title line '$line'; should be '$expect'\n";
+                ++$Errs;
+            }
+        }
+
         # .md files designate sections with leading double hash
         if ($line =~ /^##\s*(GLOBAL\s+)?OPTIONS/) {
             $section = 'flags';