CLICK-EXTRA-MAN(1) CLICK-EXTRA-MAN(1)

click-extra man - Render the man page of an external Click CLI.

click-extra man [OPTIONS] SCRIPT [SUBCOMMAND]...

Render the man page of an external Click CLI.

Resolves SCRIPT as a console_scripts entry point, module:function notation, .py file path, or Python module name. Loads the Click command and prints its man page (roff) to standard output without running it.

Extra arguments after SCRIPT navigate into nested command groups.

With --output-dir DIR, the whole subcommand tree rooted at SCRIPT [SUBCOMMAND]... is written as one .1 file per node into DIR instead of being printed to stdout. Suitable for invocation from a release pipeline or a distributor's build phase (Debian's override_dh_installman, Guix' install-man-page snippet, etc.).

Write one .1 file per (sub)command into the given directory instead of printing a single page to stdout. The directory is created if missing; subcommand pages are named <script>-<sub>.1. Must appear before SCRIPT, since arguments after SCRIPT navigate into nested subcommands.
Show this message and exit.

Write one .1 file per (sub)command into the given directory instead of printing a single page to stdout. The directory is created if missing; subcommand pages are named <script>-<sub>.1. Must appear before SCRIPT, since arguments after SCRIPT navigate into nested subcommands.
Show this message and exit.

0
Success.
1
A runtime error, or an aborted prompt (Ctrl-C, a declined confirmation).
2
A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

Kevin Deldycke

2026-06-15 7.20.0.dev0