[openssl/openssl] 5bbc49: Add mandoc output support for manpages

  Branch: refs/heads/master
  Home:   https://github.com/openssl/openssl
  Commit: 5bbc49a5c9107f40026a320364df9d9a9e5fef37
      https://github.com/openssl/openssl/commit/5bbc49a5c9107f40026a320364df9d9a9e5fef37
  Author: Enji Cooper <[email protected]>
  Date:   2026-07-20 (Mon, 20 Jul 2026)

  Changed paths:
    M Configurations/unix-Makefile.tmpl
    M Configure

  Log Message:
  -----------
  Add mandoc output support for manpages

This change modifies the Makefile generator to support mandoc format
manpages, in lieu of \*roff format manpages.

After this commit the user has the ability of specifying the manpage
format to the `--manpage-format` flag. The 2 supported manpage formats
as of writing are "mdoc" and "roff" and the default remains the "roff"
format for legacy and portability reasons.

The mandoc format requires pod2mdoc to be installed, whereas the roff
output format requires pod2man to be installed. The former requires an
additional utility be installed, whereas the latter uses pod2man, a
utility that has been present with perl distributions for well over a
decade.

mandoc format support is being added as it is an easier/arguably more
structured manpage format to parse, making it easier for downstream
consumers like FreeBSD to implement OS-specific build support, as the
minimum dependencies for the OpenSSL build process are more involved
than the tools available for the FreeBSD OS bootstrapping process.

Signed-off-by: Enji Cooper <[email protected]>

Reviewed-by: Dmitry Belyavskiy <[email protected]>
Reviewed-by: Tomas Mraz <[email protected]>
MergeDate: Mon Jul 20 09:52:29 2026
(Merged from https://github.com/openssl/openssl/pull/28450)


  Commit: 1512b307326d33d12c522c18d64dd92eb4d0e4a4
      https://github.com/openssl/openssl/commit/1512b307326d33d12c522c18d64dd92eb4d0e4a4
  Author: Enji Cooper <[email protected]>
  Date:   2026-07-20 (Mon, 20 Jul 2026)

  Changed paths:
    M INSTALL.md

  Log Message:
  -----------
  INSTALL.md: document `--manpage-format` changes

This change documents the new Configure option, `--manpage-format`.

Address formatting issues and expound on the `Reconfigure` section.

Signed-off-by: Enji Cooper <[email protected]>

Reviewed-by: Dmitry Belyavskiy <[email protected]>
Reviewed-by: Tomas Mraz <[email protected]>
MergeDate: Mon Jul 20 09:52:30 2026
(Merged from https://github.com/openssl/openssl/pull/28450)


Compare: https://github.com/openssl/openssl/compare/a5b3f8863fce...1512b307326d

To unsubscribe from these emails, change your notification settings at https://github.com/openssl/openssl/settings/notifications

-- 
You received this message because you are subscribed to the Google Groups "openssl-commits" group.
To unsubscribe from this group and stop receiving emails from it, send an email to [email protected].
To view this discussion visit https://groups.google.com/a/openssl.org/d/msgid/openssl-commits/openssl/openssl/push/refs/heads/master/a5b3f8-1512b3%40github.com.