From cc838ee2d66f7295bf7a7e6695aab1080d6791e9 Mon Sep 17 00:00:00 2001 From: Paul Yang Date: Tue, 26 Feb 2019 13:51:02 +0800 Subject: [PATCH] Add section order check in util/find-doc-nits This patch checks if the EXAMPLES section in a pod file is placed before the RETURN VALUES section. Reviewed-by: Richard Levitte (Merged from https://github.com/openssl/openssl/pull/8338) --- util/find-doc-nits | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/util/find-doc-nits b/util/find-doc-nits index a8cea9c5e0..5d5c2d05b2 100755 --- a/util/find-doc-nits +++ b/util/find-doc-nits @@ -142,6 +142,18 @@ sub name_synopsis() } } +# Check if EXAMPLES is located after RETURN VALUES section. +sub check_example_location() +{ + my $filename = shift; + my $contents = shift; + + return unless $contents =~ /=head1 RETURN VALUES/ + and $contents =~ /=head1 EXAMPLES/; + print "$filename: RETURN VAULES should be placed before EXAMPLES section\n" + if $contents =~ /=head1 EXAMPLES.*=head1 RETURN VALUES/ms; +} + sub check() { my $filename = shift; @@ -155,6 +167,8 @@ sub check() close POD; } + &check_example_location($filename, $contents) if $filename =~ m|man3/|; + my $id = "${filename}:1:"; &name_synopsis($id, $filename, $contents) -- 2.25.1