summaryrefslogtreecommitdiffstats
path: root/util/find-doc-nits
diff options
context:
space:
mode:
authorJoshua Lock <jlock@vmware.com>2019-04-09 15:10:08 +0100
committerRichard Levitte <levitte@openssl.org>2019-04-12 15:50:02 +0200
commit573ac8f2228241771f727ecd8ff10f54073536d3 (patch)
tree252247562ed0ada1ff702b88fce9a51f9a90eec9 /util/find-doc-nits
parent95f92d57755a9bfc83135a585da69d497f7293d9 (diff)
Add a check for history section location to find-doc-nits
Check that the HISTORY section is located after the SEE ALSO section, this is a much more frequent order in OpenSSL manual pages (and UNIX manual pages in general). Also check that SEE ALSO comes after EXAMPLES, so that the tool can ensure the correct manual section sequence. Reviewed-by: Matthias St. Pierre <Matthias.St.Pierre@ncp-e.com> Reviewed-by: Richard Levitte <levitte@openssl.org> (Merged from https://github.com/openssl/openssl/pull/8729)
Diffstat (limited to 'util/find-doc-nits')
-rwxr-xr-xutil/find-doc-nits4
1 files changed, 4 insertions, 0 deletions
diff --git a/util/find-doc-nits b/util/find-doc-nits
index 1957eeb7a1..66966eb355 100755
--- a/util/find-doc-nits
+++ b/util/find-doc-nits
@@ -171,6 +171,10 @@ sub check()
# Check if EXAMPLES is located after RETURN VALUES section.
&check_section_location($filename, $contents, "RETURN VALUES", "EXAMPLES") if $filename =~ m|man3/|;
+ # Check if HISTORY is located after SEE ALSO
+ &check_section_location($filename, $contents, "SEE ALSO", "HISTORY") if $filename =~ m|man3/|;
+ # Check if SEE ALSO is located after EXAMPLES
+ &check_section_location($filename, $contents, "EXAMPLES", "SEE ALSO") if $filename =~ m|man3/|;
my $id = "${filename}:1:";