Rich, If no-one else tells you, keeping the docs up to date is amazing work and thank you for it.
My general thought is that all docs should be consistent with one another for ease of cross referncing and skimming and the manpages should follow the same layout. Cheers, Ethan On Tue, Jan 28, 2020 at 11:21 AM Salz, Rich via openssl-users < openssl-users@openssl.org> wrote: > The next release of OpenSSL splits the “help” for commands into sections, > like this: > > > > ; ./apps/openssl rehash --help > > Usage: rehash [options] [directory...] > > > > General options: > > -help Display this summary > > -h Display this summary > > -compat Create both new- and old-style hash links > > -old Use old-style hash to generate links > > -n Do not remove existing links > > > > Output options: > > -v Verbose output > > > > Parameters: > > directory One or more directories to process (optional) > > > > 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 > https://github.com/openssl/openssl/pull/10885 which does this for > s_client. You can see just the changed file here: > https://github.com/openssl/openssl/blob/71d8c19554a65cf0717f6b7e7b34849456e76888/doc/man1/openssl-s_client.pod.in > > > > Replies to me will be summarized for the list. Thanks! > > >
