fix: clap CLI definitions and manpage generation

- add #[group(skip)] to all Parser-derived structs
- fix conflicts_with and arg definitions for correct CLI behavior
- refactor bin entry points to support manpage generation
This commit is contained in:
Aiden McClelland
2026-03-18 23:48:13 -06:00
parent b1b7d2fa70
commit bcdeabfe85
471 changed files with 8753 additions and 50 deletions

View File

@@ -0,0 +1,18 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-action-clear-tasks 1 "clear-tasks "
.SH NAME
start\-container\-action\-clear\-tasks
.SH SYNOPSIS
\fBstart\-container action clear\-tasks\fR [\fB\-\-only\fR] [\fB\-\-except\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-\-only\fR \fI<ONLY>\fR
Only clear these task IDs
.TP
\fB\-\-except\fR \fI<EXCEPT>\fR
Task IDs to exclude
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,15 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-action-clear 1 "clear "
.SH NAME
start\-container\-action\-clear
.SH SYNOPSIS
\fBstart\-container action clear\fR [\fB\-\-except\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-\-except\fR \fI<EXCEPT>\fR
Action IDs to exclude
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,21 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-action-get-input 1 "get-input "
.SH NAME
start\-container\-action\-get\-input
.SH SYNOPSIS
\fBstart\-container action get\-input\fR [\fB\-p\fR|\fB\-\-package\-id\fR] [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIACTION_ID\fR>
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-p\fR, \fB\-\-package\-id\fR \fI<PACKAGE_ID>\fR
Package identifier
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIACTION_ID\fR>
Action identifier

View File

@@ -0,0 +1,24 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-action-run 1 "run "
.SH NAME
start\-container\-action\-run
.SH SYNOPSIS
\fBstart\-container action run\fR [\fB\-p\fR|\fB\-\-package\-id\fR] [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIACTION_ID\fR> <\fIINPUT\fR>
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-p\fR, \fB\-\-package\-id\fR \fI<PACKAGE_ID>\fR
Package identifier
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIACTION_ID\fR>
Action identifier
.TP
<\fIINPUT\fR>
Input data for the action

View File

@@ -0,0 +1,21 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-action 1 "action "
.SH NAME
start\-container\-action
.SH SYNOPSIS
\fBstart\-container action\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-container\-action\-clear(1)
.TP
start\-container\-action\-clear\-tasks(1)
.TP
start\-container\-action\-get\-input(1)
.TP
start\-container\-action\-run(1)

View File

@@ -0,0 +1,15 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-check-dependencies 1 "check-dependencies "
.SH NAME
start\-container\-check\-dependencies
.SH SYNOPSIS
\fBstart\-container check\-dependencies\fR [\fB\-h\fR|\fB\-\-help\fR] [\fIPACKAGE_IDS\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
[\fIPACKAGE_IDS\fR]

View File

@@ -0,0 +1,15 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-echo 1 "echo "
.SH NAME
start\-container\-echo
.SH SYNOPSIS
\fBstart\-container echo\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIMESSAGE\fR>
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIMESSAGE\fR>
Message to echo back

View File

@@ -0,0 +1,12 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-get-data-version 1 "get-data-version "
.SH NAME
start\-container\-get\-data\-version
.SH SYNOPSIS
\fBstart\-container get\-data\-version\fR [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,12 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-get-dependencies 1 "get-dependencies "
.SH NAME
start\-container\-get\-dependencies
.SH SYNOPSIS
\fBstart\-container get\-dependencies\fR [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,12 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-get-os-ip 1 "get-os-ip "
.SH NAME
start\-container\-get\-os\-ip
.SH SYNOPSIS
\fBstart\-container get\-os\-ip\fR [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,15 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-get-status 1 "get-status "
.SH NAME
start\-container\-get\-status
.SH SYNOPSIS
\fBstart\-container get\-status\fR [\fB\-h\fR|\fB\-\-help\fR] [\fIPACKAGE_ID\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
[\fIPACKAGE_ID\fR]

View File

@@ -0,0 +1,12 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-git-info 1 "git-info "
.SH NAME
start\-container\-git\-info
.SH SYNOPSIS
\fBstart\-container git\-info\fR [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,12 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-plugin-url 1 "url "
.SH NAME
start\-container\-plugin\-url
.SH SYNOPSIS
\fBstart\-container plugin url\fR [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,15 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-plugin 1 "plugin "
.SH NAME
start\-container\-plugin
.SH SYNOPSIS
\fBstart\-container plugin\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-container\-plugin\-url(1)

View File

@@ -0,0 +1,12 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-rebuild 1 "rebuild "
.SH NAME
start\-container\-rebuild
.SH SYNOPSIS
\fBstart\-container rebuild\fR [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,12 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-restart 1 "restart "
.SH NAME
start\-container\-restart
.SH SYNOPSIS
\fBstart\-container restart\fR [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,15 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-set-data-version 1 "set-data-version "
.SH NAME
start\-container\-set\-data\-version
.SH SYNOPSIS
\fBstart\-container set\-data\-version\fR [\fB\-h\fR|\fB\-\-help\fR] [\fIVERSION\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
[\fIVERSION\fR]

View File

@@ -0,0 +1,15 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-set-dependencies 1 "set-dependencies "
.SH NAME
start\-container\-set\-dependencies
.SH SYNOPSIS
\fBstart\-container set\-dependencies\fR [\fB\-h\fR|\fB\-\-help\fR] [\fIDEPENDENCIES\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
[\fIDEPENDENCIES\fR]

View File

@@ -0,0 +1,15 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-set-main-status 1 "set-main-status "
.SH NAME
start\-container\-set\-main\-status
.SH SYNOPSIS
\fBstart\-container set\-main\-status\fR [\fB\-h\fR|\fB\-\-help\fR] <\fISTATUS\fR>
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fISTATUS\fR>

View File

@@ -0,0 +1,12 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-shutdown 1 "shutdown "
.SH NAME
start\-container\-shutdown
.SH SYNOPSIS
\fBstart\-container shutdown\fR [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,18 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-subcontainer-create-fs 1 "create-fs "
.SH NAME
start\-container\-subcontainer\-create\-fs
.SH SYNOPSIS
\fBstart\-container subcontainer create\-fs\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIIMAGE_ID\fR> [\fINAME\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIIMAGE_ID\fR>
.TP
[\fINAME\fR]

View File

@@ -0,0 +1,15 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-subcontainer-destroy-fs 1 "destroy-fs "
.SH NAME
start\-container\-subcontainer\-destroy\-fs
.SH SYNOPSIS
\fBstart\-container subcontainer destroy\-fs\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIGUID\fR>
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIGUID\fR>

View File

@@ -0,0 +1,39 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-subcontainer-exec-command 1 "exec-command "
.SH NAME
start\-container\-subcontainer\-exec\-command
.SH SYNOPSIS
\fBstart\-container subcontainer exec\-command\fR [\fB\-\-force\-tty\fR] [\fB\-\-force\-stderr\-tty\fR] [\fB\-\-pty\-size\fR] [\fB\-e\fR|\fB\-\-env\fR] [\fB\-\-env\-file\fR] [\fB\-w\fR|\fB\-\-workdir\fR] [\fB\-u\fR|\fB\-\-user\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fICHROOT\fR> [\fICOMMAND\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-\-force\-tty\fR
Force TTY mode for I/O
.TP
\fB\-\-force\-stderr\-tty\fR
Force stderr to be treated as a TTY
.TP
\fB\-\-pty\-size\fR \fI<PTY_SIZE>\fR
PTY terminal size (<rows>:<cols>[:<x>:<y>])
.TP
\fB\-e\fR, \fB\-\-env\fR \fI<ENV>\fR
Environment variable (KEY=VALUE)
.TP
\fB\-\-env\-file\fR \fI<ENV_FILE>\fR
Path to environment file
.TP
\fB\-w\fR, \fB\-\-workdir\fR \fI<WORKDIR>\fR
Working directory path
.TP
\fB\-u\fR, \fB\-\-user\fR \fI<USER>\fR
User name to run as
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fICHROOT\fR>
Path for chroot environment
.TP
[\fICOMMAND\fR]
Command to execute in the container

View File

@@ -0,0 +1,39 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-subcontainer-exec 1 "exec "
.SH NAME
start\-container\-subcontainer\-exec
.SH SYNOPSIS
\fBstart\-container subcontainer exec\fR [\fB\-\-force\-tty\fR] [\fB\-\-force\-stderr\-tty\fR] [\fB\-\-pty\-size\fR] [\fB\-e\fR|\fB\-\-env\fR] [\fB\-\-env\-file\fR] [\fB\-w\fR|\fB\-\-workdir\fR] [\fB\-u\fR|\fB\-\-user\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fICHROOT\fR> [\fICOMMAND\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-\-force\-tty\fR
Force TTY mode for I/O
.TP
\fB\-\-force\-stderr\-tty\fR
Force stderr to be treated as a TTY
.TP
\fB\-\-pty\-size\fR \fI<PTY_SIZE>\fR
PTY terminal size (<rows>:<cols>[:<x>:<y>])
.TP
\fB\-e\fR, \fB\-\-env\fR \fI<ENV>\fR
Environment variable (KEY=VALUE)
.TP
\fB\-\-env\-file\fR \fI<ENV_FILE>\fR
Path to environment file
.TP
\fB\-w\fR, \fB\-\-workdir\fR \fI<WORKDIR>\fR
Working directory path
.TP
\fB\-u\fR, \fB\-\-user\fR \fI<USER>\fR
User name to run as
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fICHROOT\fR>
Path for chroot environment
.TP
[\fICOMMAND\fR]
Command to execute in the container

View File

@@ -0,0 +1,39 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-subcontainer-launch-init 1 "launch-init "
.SH NAME
start\-container\-subcontainer\-launch\-init
.SH SYNOPSIS
\fBstart\-container subcontainer launch\-init\fR [\fB\-\-force\-tty\fR] [\fB\-\-force\-stderr\-tty\fR] [\fB\-\-pty\-size\fR] [\fB\-e\fR|\fB\-\-env\fR] [\fB\-\-env\-file\fR] [\fB\-w\fR|\fB\-\-workdir\fR] [\fB\-u\fR|\fB\-\-user\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fICHROOT\fR> [\fICOMMAND\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-\-force\-tty\fR
Force TTY mode for I/O
.TP
\fB\-\-force\-stderr\-tty\fR
Force stderr to be treated as a TTY
.TP
\fB\-\-pty\-size\fR \fI<PTY_SIZE>\fR
PTY terminal size (<rows>:<cols>[:<x>:<y>])
.TP
\fB\-e\fR, \fB\-\-env\fR \fI<ENV>\fR
Environment variable (KEY=VALUE)
.TP
\fB\-\-env\-file\fR \fI<ENV_FILE>\fR
Path to environment file
.TP
\fB\-w\fR, \fB\-\-workdir\fR \fI<WORKDIR>\fR
Working directory path
.TP
\fB\-u\fR, \fB\-\-user\fR \fI<USER>\fR
User name to run as
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fICHROOT\fR>
Path for chroot environment
.TP
[\fICOMMAND\fR]
Command to execute in the container

View File

@@ -0,0 +1,39 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-subcontainer-launch 1 "launch "
.SH NAME
start\-container\-subcontainer\-launch
.SH SYNOPSIS
\fBstart\-container subcontainer launch\fR [\fB\-\-force\-tty\fR] [\fB\-\-force\-stderr\-tty\fR] [\fB\-\-pty\-size\fR] [\fB\-e\fR|\fB\-\-env\fR] [\fB\-\-env\-file\fR] [\fB\-w\fR|\fB\-\-workdir\fR] [\fB\-u\fR|\fB\-\-user\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fICHROOT\fR> [\fICOMMAND\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-\-force\-tty\fR
Force TTY mode for I/O
.TP
\fB\-\-force\-stderr\-tty\fR
Force stderr to be treated as a TTY
.TP
\fB\-\-pty\-size\fR \fI<PTY_SIZE>\fR
PTY terminal size (<rows>:<cols>[:<x>:<y>])
.TP
\fB\-e\fR, \fB\-\-env\fR \fI<ENV>\fR
Environment variable (KEY=VALUE)
.TP
\fB\-\-env\-file\fR \fI<ENV_FILE>\fR
Path to environment file
.TP
\fB\-w\fR, \fB\-\-workdir\fR \fI<WORKDIR>\fR
Working directory path
.TP
\fB\-u\fR, \fB\-\-user\fR \fI<USER>\fR
User name to run as
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fICHROOT\fR>
Path for chroot environment
.TP
[\fICOMMAND\fR]
Command to execute in the container

View File

@@ -0,0 +1,25 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container-subcontainer 1 "subcontainer "
.SH NAME
start\-container\-subcontainer
.SH SYNOPSIS
\fBstart\-container subcontainer\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-container\-subcontainer\-create\-fs(1)
.TP
start\-container\-subcontainer\-destroy\-fs(1)
.TP
start\-container\-subcontainer\-exec(1)
.TP
start\-container\-subcontainer\-exec\-command(1)
.TP
start\-container\-subcontainer\-launch(1)
.TP
start\-container\-subcontainer\-launch\-init(1)

View File

@@ -0,0 +1,53 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-container 1 "start-container 0.4.0-alpha.21"
.SH NAME
start\-container
.SH SYNOPSIS
\fBstart\-container\fR [\fB\-\-socket\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIsubcommands\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-\-socket\fR \fI<SOCKET>\fR
Path to Unix socket
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version
.SH SUBCOMMANDS
.TP
start\-container\-action(1)
.TP
start\-container\-check\-dependencies(1)
.TP
start\-container\-echo(1)
.TP
start\-container\-get\-data\-version(1)
.TP
start\-container\-get\-dependencies(1)
.TP
start\-container\-get\-os\-ip(1)
.TP
start\-container\-get\-status(1)
.TP
start\-container\-git\-info(1)
.TP
start\-container\-plugin(1)
.TP
start\-container\-rebuild(1)
.TP
start\-container\-restart(1)
.TP
start\-container\-set\-data\-version(1)
.TP
start\-container\-set\-dependencies(1)
.TP
start\-container\-set\-main\-status(1)
.TP
start\-container\-shutdown(1)
.TP
start\-container\-subcontainer(1)
.SH VERSION
v0.4.0\-alpha.21