NAME

repomatic pack-manpages - Pack the rendered man pages as a release tarball

SYNOPSIS

repomatic pack-manpages [OPTIONS]

DESCRIPTION

Bundle the rendered man pages into the tarball a release attaches.

The tarball holds the pages under the name of their directory, like `tar --create man/` stores them. It is byte-deterministic: re-packing an unchanged tree gives an identical file, with the same attestation digest.

Prints the path of the tarball.

OPTIONS

--dir DIRECTORY

Directory holding the rendered roff pages.

-o / --output FILE

Write the tarball to this file. Defaults to the manpages_asset_name metadata key with a .tar.gz extension, in the working directory.

--help / -h

Show this message and exit.

ENVIRONMENT

PACK_MANPAGES_MAN_DIR

Directory holding the rendered roff pages.

PACK_MANPAGES_OUTPUT

Write the tarball to this file. Defaults to the manpages_asset_name metadata key with a .tar.gz extension, in the working directory.

PACK_MANPAGES__CLICK_DEFAULT_HELP

Show this message and exit.

EXIT STATUS

0

Success.

1

A runtime error, an aborted prompt (Ctrl-D), or a declined confirmation.

2

A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

130

Interrupted with Ctrl-C: the process ends by SIGINT, reported as 130.

EXAMPLES

Pack ./man into <manpages_asset_name>.tar.gz

repomatic pack\-manpages

Pack another directory into an explicit file

repomatic pack\-manpages \-\-dir build/man \-\-output papaya\-manpages.tar.gz

AUTHORS

Kevin Deldycke