* A new `--include` feature, inspired by `help2man --include`.
* Allow overriding build date with SOURCE_DATE_EPOCH environment variable
in order to make builds reproducible. See this link for more info:
https://reproducible-builds.org/specs/source-date-epoch/
* The AUTHORS section was changed to more standard AUTHOR.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
News in v4
* The manual page generator logic is now separated from the 'build_manpages'
module (which provides setup.py integration helpers). Therefore the
argparse-manpage doesn't necessarily have to depend on setuptools.
Projects that want to integrate using 'setup.py' should though place a new
"extra" named 'argparse-manpage[setuptools]' into their set of build
requirements in project.toml file.
* The old 'build_manpage' command (!= 'build_manpages') is now more
isolated from the rest of the code, likely never loaded.
* the Manpage class API was changed in v3 so it required an additional
constructor 'data' argument. This change was reverted, and the only
argument is again the ArgumentParser object.
* The 'version' and 'description' options were fixed.
* New options 'manual_section' and 'manual_title' were added.
* The manual page now automatically generates a current date in headers.
* Several groff escaping issues were fixed.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
New in version 3
* New man page format: single-commands-section
* Add CLI and conf options for setting the output format
* Add CLI and conf options to explicitly specify %prog value
* Skip showing commands with help == SUPPRESS
* Avoid rendering docs for command aliases
* Print program name in upper case in header and footer
* The --author CLI option has changed, and takes arbitrary string
(typically 'Author Name <theexample.com>'), and newly can be specified
multiple times. Therefore, it now replaces the '--author-email' option.
The --author-email option is kept, but is just an alias to the --author
option.
* All CLI options can be specified also in setup.cfg
* Don't render AUTHORS and DISTRIBUTION if they would contain undefined values
* Remove '... was written by' from AUTHORS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~