summaryrefslogtreecommitdiffstats
path: root/util
diff options
context:
space:
mode:
authorRich Salz <rsalz@akamai.com>2019-08-15 14:26:08 -0400
committerDr. Matthias St. Pierre <Matthias.St.Pierre@ncp-e.com>2019-08-19 00:06:39 +0200
commitcda774223d9a886ece480f304be40797bb73bcd7 (patch)
tree7b14425497412af37bac883dce275d8560915015 /util
parent39a117d17963d0cd4a8f3a3351c0844c325e905c (diff)
Use EXAMPLES not EXAMPLE for section title
And update find-doc-nits to complain if "=head1 EXAMPLE" is found. Reviewed-by: Richard Levitte <levitte@openssl.org> Reviewed-by: Matthias St. Pierre <Matthias.St.Pierre@ncp-e.com> (Merged from https://github.com/openssl/openssl/pull/9602)
Diffstat (limited to 'util')
-rwxr-xr-xutil/find-doc-nits6
1 files changed, 4 insertions, 2 deletions
diff --git a/util/find-doc-nits b/util/find-doc-nits
index 563a6956a7..690d9405e5 100755
--- a/util/find-doc-nits
+++ b/util/find-doc-nits
@@ -182,9 +182,9 @@ sub check()
# Check ordering of some sections in man3
if ( $filename =~ m|man3/| ) {
- &check_section_location($id, $contents, "RETURN VALUES", "EXAMPLE");
+ &check_section_location($id, $contents, "RETURN VALUES", "EXAMPLES");
&check_section_location($id, $contents, "SEE ALSO", "HISTORY");
- &check_section_location($id, $contents, "EXAMPLE", "SEE ALSO");
+ &check_section_location($id, $contents, "EXAMPLES", "SEE ALSO");
}
&name_synopsis($id, $filename, $contents)
@@ -197,6 +197,8 @@ sub check()
if $contents !~ /=cut\n$/;
print "$id more than one cut line.\n"
if $contents =~ /=cut.*=cut/ms;
+ print "$id EXAMPLE not EXAMPLES section.\n"
+ if $contents =~ /=head1 EXAMPLE[^S]/;
print "$id missing copyright\n"
if $contents !~ /Copyright .* The OpenSSL Project Authors/;
print "$id copyright not last\n"