util/find-doc-nits: Relax check of function declarations in name_synopsis()
authorRichard Levitte <levitte@openssl.org>
Mon, 20 Jul 2020 15:10:44 +0000 (17:10 +0200)
committerRichard Levitte <levitte@openssl.org>
Tue, 21 Jul 2020 16:52:29 +0000 (18:52 +0200)
commit8eca461731feb25b94ccf181e76ec2723e27769a
treedad96bce52be16415249ede2839db2d9d4793c6b
parent904f42509f8d5e6210113e49a7e41ed2b1dd5a81
util/find-doc-nits: Relax check of function declarations in name_synopsis()

The relaxation allows spaces between function name and argument list,
to allow line breaks like this when there are very long names:

    int (fantastically_long_name_breaks_80char_limit)
        (fantastically_long_name_breaks_80char_limit *something);

This revealed some other intricaties, such as documented internal
structures with function pointers inside, so a check of open
structures was also added, and they are now simply skipped over.

Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/12494)
util/find-doc-nits