NAME

pax - public build and run switchboard for PAX

SYNOPSIS

pax build [options] [entrypoint]
pax run [options] [entrypoint] [-- args...]
pax build -I lib -MDateTime -e 'print DateTime->now'
pax run -I lib -MDateTime -e 'print DateTime->now'
/path/to/pax /path/to/script.pl [script-args...]

DESCRIPTION

The public pax entrypoint stays intentionally small.

It only:

  • bootstraps the repository lib/ path when running from a checkout

  • hands the public CLI contract to PAX::CLI

  • keeps the user-visible command surface at build and run

The compiler, packager, runtime, and diagnostic logic live in the Perl modules under lib/PAX/. This script is only the stable front door.

When the executable is used as a shebang target, PAX::CLI also accepts a plain Perl script path and runs that file directly as interpreter-mode execution.

HOW TO USE

Use this script as the public pax executable. For normal operation call pax build or pax run. For interpreter mode, point a Perl shebang at the installed binary or invoke it directly with a script path.

WHAT USES IT

Operators invoke this file directly, standalone self-hosting tests compile it, and shebang-driven scripts can use it as a Perl-compatible front door.