| commit | 7a8d20f6ee8bc57767927755d0a10a8788261bfd | |
| author | Kyle J. McKay <mackyle@gmail.com> | |
| Fri, 5 Mar 2021 12:21:19 +0000 (5 05:21 -0700) | ||
| committer | Kyle J. McKay <mackyle@gmail.com> | |
| Fri, 5 Mar 2021 12:21:19 +0000 (5 05:21 -0700) | ||
| tree | 4b38af8642f034c23674a3cc1ad58fc04ed433d2 | treesnapshot (tar.gz zip) |
| parent | 37ff77f4e8fda9b3c5f384fa7f9122e6c6bd3edb | commitdiff |
help: make sure help shows with nice formatting
Starting with Perl 5.28.0, the default output when using
Pod::Usage with a verbose level >= 2 has been made plain,
ugly, no formatting whatsoever.
Compensate for this documentation travesty by setting
the PERLDOC environment variable, if it's not already set,
to restore the previous behavior.
Additionally, add the necessary changes so that the brief
help shown for '-h' will use terminal formatting codes to
show bold, underline, etc., if available, to avoid the very
ugly plain text mess that would otherwise appear.
Signed-off-by: Kyle J. McKay <mackyle@gmail.com>
Starting with Perl 5.28.0, the default output when using
Pod::Usage with a verbose level >= 2 has been made plain,
ugly, no formatting whatsoever.
Compensate for this documentation travesty by setting
the PERLDOC environment variable, if it's not already set,
to restore the previous behavior.
Additionally, add the necessary changes so that the brief
help shown for '-h' will use terminal formatting codes to
show bold, underline, etc., if available, to avoid the very
ugly plain text mess that would otherwise appear.
Signed-off-by: Kyle J. McKay <mackyle@gmail.com>