<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
        {font-family:"Cambria Math";
        panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
        {font-family:Calibri;
        panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0in;
        margin-bottom:.0001pt;
        font-size:12.0pt;
        font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
        {mso-style-priority:99;
        color:#0563C1;
        text-decoration:underline;}
span.EmailStyle17
        {mso-style-type:personal-compose;
        font-family:"Calibri",sans-serif;
        color:windowtext;}
.MsoChpDefault
        {mso-style-type:export-only;}
@page WordSection1
        {size:8.5in 11.0in;
        margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
        {page:WordSection1;}
--></style>
</head>
<body lang="EN-US" link="#0563C1" vlink="#954F72">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt">The next release of OpenSSL splits the “help” for commands into sections, like this:<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">; ./apps/openssl rehash --help<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">Usage: rehash [options] [directory...]<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">General options:<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">-help        Display this summary<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">-h           Display this summary<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">-compat      Create both new- and old-style hash links<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">-old         Use old-style hash to generate links<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">-n           Do not remove existing links<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">Output options:<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">-v           Verbose output<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">Parameters:<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">directory    One or more directories to process (optional)<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">Should the order of options in the manpages follow this layout?  Should there be a blank line (in the SYNOPSIS section!) between the option sections?  Please take a look at
<a href="https://github.com/openssl/openssl/pull/10885">https://github.com/openssl/openssl/pull/10885</a> which does this for s_client.  You can see just the changed file here:
<a href="https://github.com/openssl/openssl/blob/71d8c19554a65cf0717f6b7e7b34849456e76888/doc/man1/openssl-s_client.pod.in">
https://github.com/openssl/openssl/blob/71d8c19554a65cf0717f6b7e7b34849456e76888/doc/man1/openssl-s_client.pod.in</a><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">Replies to me will be summarized for the list.  Thanks!<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
</div>
</body>
</html>