Rework util/find-doc-nits to distinguish internal documentation
authorRichard Levitte <levitte@openssl.org>
Mon, 6 Apr 2020 11:51:36 +0000 (13:51 +0200)
committerRichard Levitte <levitte@openssl.org>
Sat, 11 Apr 2020 13:51:43 +0000 (15:51 +0200)
commit8270c4791d361847b0b28a30d396006400758a3f
treef7bd29648af6a46f3e43e268b9ca5e53245080ea
parenteacd30a703b52f5b3e8e70b58f99bd1128458c7c
Rework util/find-doc-nits to distinguish internal documentation

We didn't really distinguish internal and public documentation, or
matched that with the state of the documented symbols.  we therefore
needed to rework the logic to account for the state of each symbol.

To simplify things, and make them consistent, we load all of
util/*.num, util/*.syms and util/missing*.txt unconditionally.

Also, we rework the reading of the manuals to happen only once (or
well, not quite, Pod::Checker reads from file too, but at the very
least, our script isn't reading the same file multiple times).

Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/11476)
util/find-doc-nits
util/perl/OpenSSL/Util/Pod.pm