util/find-doc-nits: when loading "missing" files, check if documented

It may be that some "missing" manuals have been written since their
insertion in the "missing" files.  Make sure to alert when such manual
references are found.

This works, because we collect all existing manual references into
%name_map first.

Fixes #10681

Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/10683)

diff --git a/util/find-doc-nits b/util/find-doc-nits
index 93cdf03bb71c8954720014ddf603e416b696e472..4b6d7c5e611132681f53b58d5d36319e81488e2f 100755 (executable)
--- a/util/find-doc-nits
+++ b/util/find-doc-nits
@@ -600,6 +600,11 @@ sub loadmissing($)
     }
     close FH;
 
+    for (@missing) {
+        err("$missingfile:", "$_ is documented in $name_map{$_}")
+            if exists $name_map{$_} && defined $name_map{$_};
+    }
+
     return @missing;
 }