@rom-weaver/cli 0.12.3 → 0.14.0

package/docs/man/rom-weaver-bundle-create.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-bundle\-create \- Write a rom\-weaver\-bundle.json recipe from local ROM and patch files
 .SH SYNOPSIS
-\fBrom\-weaver bundle create\fR [\fB\-i\fR|\fB\-\-input\fR] [\fB\-\-json\fR] [\fB\-\-assume\-in\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-rom\-url\fR] [\fB\-\-log\-level\fR] [\fB\-\-rom\-name\fR] [\fB\-\-patch\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-patch\-id\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-patch\-version\fR] [\fB\-\-color\fR] [\fB\-\-patch\-name\fR] [\fB\-\-no\-color\fR] [\fB\-\-patch\-description\fR] [\fB\-\-patch\-author\fR] [\fB\-\-patch\-label\fR] [\fB\-\-patch\-optional\fR] [\fB\-\-patch\-source\-url\fR] [\fB\-\-patch\-header\fR] [\fB\-\-patch\-basis\fR] [\fB\-\-patch\-expect\-in\fR] [\fB\-\-patch\-expect\-out\fR] [\fB\-\-expect\-out\fR] [\fB\-\-output\-name\fR] [\fB\-\-output\-header\fR] <\fB\-o\fR|\fB\-\-output\fR> [\fB\-\-bundle\fR] [\fB\-\-bundle\-rom\fR] [\fB\-\-no\-bundle\-rom\fR] [\fB\-\-checksum\fR] [\fB\-\-from\fR] [\fB\-\-schema\-ref\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-h\fR|\fB\-\-help\fR]
+\fBrom\-weaver bundle create\fR [\fB\-i\fR|\fB\-\-input\fR] [\fB\-\-json\fR] [\fB\-\-assume\-in\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-rom\-url\fR] [\fB\-\-log\-level\fR] [\fB\-\-rom\-name\fR] [\fB\-\-patch\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-patch\-id\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-patch\-version\fR] [\fB\-\-color\fR] [\fB\-\-patch\-name\fR] [\fB\-\-no\-color\fR] [\fB\-\-patch\-description\fR] [\fB\-\-patch\-author\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-\-patch\-label\fR] [\fB\-\-patch\-optional\fR] [\fB\-\-patch\-source\-url\fR] [\fB\-\-patch\-header\fR] [\fB\-\-patch\-basis\fR] [\fB\-\-patch\-expect\-in\fR] [\fB\-\-patch\-expect\-out\fR] [\fB\-\-expect\-out\fR] [\fB\-\-output\-name\fR] [\fB\-\-output\-header\fR] [\fB\-\-bundle\fR] [\fB\-\-bundle\-rom\fR] [\fB\-\-no\-bundle\-rom\fR] [\fB\-\-checksum\fR] [\fB\-\-from\fR] [\fB\-\-schema\-ref\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-\-force\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-o\fR|\fB\-\-output\fR>
 .SH DESCRIPTION
 Write a rom\-weaver\-bundle.json recipe from local ROM and patch files.
 .PP
@@ -43,24 +43,52 @@ patches reads left to right:
 .TP
 \fB\-\-patch\-id\fR \fI<PATCH_ID>\fR
 Identifier for the preceding \-\-patch that stays the same across releases, so a replacement keeps its settings
+
+This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
+
+  \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .TP
 \fB\-\-patch\-version\fR \fI<PATCH_VERSION>\fR
 Version of the preceding \-\-patch, in whatever form its author uses
+
+This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
+
+  \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .TP
 \fB\-\-patch\-name\fR \fI<PATCH_NAME>\fR
 Name to show for the preceding \-\-patch
+
+This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
+
+  \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .TP
 \fB\-\-patch\-description\fR \fI<PATCH_DESCRIPTION>\fR
 What the preceding \-\-patch does
+
+This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
+
+  \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .TP
 \fB\-\-patch\-author\fR \fI<PATCH_AUTHOR>\fR
 Who made the preceding \-\-patch
+
+This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
+
+  \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .TP
 \fB\-\-patch\-label\fR \fI<PATCH_LABEL>\fR
 Short status note for the preceding \-\-patch, such as beta or recommended
+
+This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
+
+  \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .TP
 \fB\-\-patch\-optional\fR \fI<PATCH_OPTIONAL>\fR
 Mark the preceding \-\-patch optional, so it starts switched off and needs \-\-with to run
+
+This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
+
+  \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .br
 
 .br
@@ -74,9 +102,17 @@ false
 .TP
 \fB\-\-patch\-source\-url\fR \fI<PATCH_SOURCE_URL>\fR
 Where the preceding \-\-patch can be downloaded from. The local file is still read to build the bundle
+
+This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
+
+  \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .TP
 \fB\-\-patch\-header\fR \fI<PATCH_HEADER>\fR
 Whether the preceding \-\-patch applies to the ROM with or without its copier header: auto, keep, or strip
+
+This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
+
+  \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .br
 
 .br
@@ -92,6 +128,10 @@ auto
 .TP
 \fB\-\-patch\-basis\fR \fI<PATCH_BASIS>\fR
 Which ROM the preceding \-\-patch was built against: base (the bundle\*(Aqs ROM) or previous (the patch before it). Use auto to leave it out and let apply infer it
+
+This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
+
+  \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .br
 
 .br
@@ -107,6 +147,10 @@ previous
 .TP
 \fB\-\-patch\-expect\-in\fR \fI<ALGO=HEX>\fR
 Checksum the ROM should have before the preceding \-\-patch runs. Recorded only when it differs from the bundle\*(Aqs ROM checksums (repeatable, comma\-separable)
+
+This flag must follow the \-\-patch it describes. Give it once per \-\-patch, in the same order, or leave it out entirely \- a partial list is an error. An occurrence before any \-\-patch has nothing to bind to.
+
+  \-\-patch a.bps \-\-patch\-name "First" \-\-patch b.ups \-\-patch\-name "Second"
 .TP
 \fB\-\-patch\-expect\-out\fR \fI<ALGO=HEX>\fR
 Checksum the ROM should have after the preceding \-\-patch runs. Recorded only when it differs from the final output checksums (repeatable, comma\-separable)
@@ -144,8 +188,30 @@ Pack this file into \-\-bundle as the ROM, while \-\-input supplies the checksum
 \fB\-\-no\-bundle\-rom\fR
 Keep the ROM out of \-\-bundle and record only its checksums, so whoever applies the bundle brings their own copy
 .TP
-\fB\-\-checksum\fR \fI<CHECKSUM>\fR
-Which checksums to record for the ROM (repeatable) [default: crc32,md5,sha1]
+\fB\-\-checksum\fR \fI<ALGO>\fR
+Which checksums to record for the ROM (repeatable, comma\-separable) [default: crc32,md5,sha1]
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+crc32
+.IP \(bu 2
+md5
+.IP \(bu 2
+sha1
+.IP \(bu 2
+sha256
+.IP \(bu 2
+blake3
+.IP \(bu 2
+crc32c
+.IP \(bu 2
+crc16
+.IP \(bu 2
+adler32
+.RE
 .TP
 \fB\-\-from\fR \fI<FILE>\fR
 Build the bundle from a hand\-written rom\-weaver\-bundle.json instead of flags.
@@ -163,6 +229,9 @@ Record this $schema URL in the bundle so editors can validate it. Left out unles
 \fB\-j\fR, \fB\-\-threads\fR \fI<auto|N>\fR [default: auto]
 How many threads to use at most. auto uses every core; a format may still use fewer
 .TP
+\fB\-\-force\fR
+Overwrite the output if it already exists (without this, the command stops instead)
+.TP
 \fB\-h\fR, \fB\-\-help\fR
 Print help (see a summary with \*(Aq\-h\*(Aq)
 .SH "GLOBAL OPTIONS"
@@ -211,3 +280,6 @@ Keep colors even when output is piped
 .TP
 \fB\-\-no\-color\fR
 Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates

package/docs/man/rom-weaver-bundle-parse.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-bundle\-parse \- Read a rom\-weaver\-bundle.json recipe and report what it points at
 .SH SYNOPSIS
-\fBrom\-weaver bundle parse\fR <\fB\-i\fR|\fB\-\-input\fR> [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-\-no\-extract\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-h\fR|\fB\-\-help\fR]
+\fBrom\-weaver bundle parse\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-\-no\-extract\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR>
 .SH DESCRIPTION
 Read a rom\-weaver\-bundle.json recipe, check that it is valid, and report the
 ROM and patches it points at.
@@ -96,3 +96,6 @@ Keep colors even when output is piped
 .TP
 \fB\-\-no\-color\fR
 Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates

package/docs/man/rom-weaver-bundle-schema.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-bundle\-schema \- Print the rom\-weaver\-bundle.json JSON Schema, for editors and hand\-authoring
 .SH SYNOPSIS
-\fBrom\-weaver bundle schema\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-h\fR|\fB\-\-help\fR]
+\fBrom\-weaver bundle schema\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR]
 .SH DESCRIPTION
 Print the rom\-weaver\-bundle.json JSON Schema to stdout.
 .PP
@@ -65,3 +65,6 @@ Keep colors even when output is piped
 .TP
 \fB\-\-no\-color\fR
 Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates

package/docs/man/rom-weaver-bundle.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-bundle \- Build and read rom\-weaver\-bundle.json patch recipes
 .SH SYNOPSIS
-\fBrom\-weaver bundle\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
+\fBrom\-weaver bundle\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
 .SH DESCRIPTION
 Build and read rom\-weaver\-bundle.json patch recipes
 .SH OPTIONS
@@ -57,6 +57,9 @@ Keep colors even when output is piped
 .TP
 \fB\-\-no\-color\fR
 Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates
 .SH SUBCOMMANDS
 .TP
 rom\-weaver\-bundle\-create(1)

package/docs/man/rom-weaver-checksum.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-checksum \- Compute checksums for a file, or for a ROM inside an archive
 .SH SYNOPSIS
-\fBrom\-weaver checksum\fR <\fB\-i\fR|\fB\-\-input\fR> [\fB\-\-json\fR] <\fB\-a\fR|\fB\-\-algo\fR> [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-log\-level\fR] [\fB\-\-no\-extract\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-no\-ignore\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-no\-trim\-fix\fR] [\fB\-\-color\fR] [\fB\-\-start\fR] [\fB\-\-length\fR] [\fB\-\-no\-color\fR] [\fB\-\-probe\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-h\fR|\fB\-\-help\fR]
+\fBrom\-weaver checksum\fR [\fB\-\-json\fR] [\fB\-a\fR|\fB\-\-algo\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-log\-level\fR] [\fB\-\-no\-extract\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-no\-ignore\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-no\-trim\-fix\fR] [\fB\-\-color\fR] [\fB\-\-start\fR] [\fB\-\-length\fR] [\fB\-\-no\-color\fR] [\fB\-\-probe\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR>
 .SH DESCRIPTION
 Compute checksums for a file, so you can tell one dump from another.
 .PP
@@ -20,8 +20,30 @@ match a file that is stored slightly differently.
 \fB\-i\fR, \fB\-\-input\fR \fI<INPUT>\fR
 File to hash. Use \- to read from stdin
 .TP
-\fB\-a\fR, \fB\-\-algo\fR \fI<ALGO>\fR
-Which checksum to compute: crc32, md5, sha1, sha256, blake3, crc32c, crc16, or adler32 (repeatable, comma\-separable)
+\fB\-a\fR, \fB\-\-algo\fR \fI<ALGO>\fR [default: crc32,md5,sha1]
+Which checksum to compute (repeatable, comma\-separable)
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+crc32
+.IP \(bu 2
+md5
+.IP \(bu 2
+sha1
+.IP \(bu 2
+sha256
+.IP \(bu 2
+blake3
+.IP \(bu 2
+crc32c
+.IP \(bu 2
+crc16
+.IP \(bu 2
+adler32
+.RE
 .TP
 \fB\-s\fR, \fB\-\-select\fR \fI<SELECT>\fR
 Pick which file inside the archive to use, by exact name, prefix, or glob (repeatable)
@@ -108,3 +130,6 @@ Keep colors even when output is piped
 .TP
 \fB\-\-no\-color\fR
 Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates

package/docs/man/rom-weaver-completions.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-completions \- Print a tab\-completion script for your shell
 .SH SYNOPSIS
-\fBrom\-weaver completions\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fISHELL\fR>
+\fBrom\-weaver completions\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fISHELL\fR>
 .SH DESCRIPTION
 Print a tab\-completion script for your shell to stdout.
 .PP
@@ -82,3 +82,6 @@ Keep colors even when output is piped
 .TP
 \fB\-\-no\-color\fR
 Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates

package/docs/man/rom-weaver-compress.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-compress \- Pack files into an archive, disc image, or ROM\-specific compressed format
 .SH SYNOPSIS
-\fBrom\-weaver compress\fR <\fB\-i\fR|\fB\-\-input\fR> [\fB\-\-json\fR] [\fB\-f\fR|\fB\-\-format\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] <\fB\-o\fR|\fB\-\-output\fR> [\fB\-\-codec\fR] [\fB\-\-log\-level\fR] [\fB\-\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-h\fR|\fB\-\-help\fR]
+\fBrom\-weaver compress\fR [\fB\-\-json\fR] [\fB\-f\fR|\fB\-\-format\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-codec\fR] [\fB\-\-log\-level\fR] [\fB\-\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-force\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-color\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR> <\fB\-o\fR|\fB\-\-output\fR>
 .SH DESCRIPTION
 Pack files into an archive, disc image, or ROM\-specific compressed format.
 .PP
@@ -33,6 +33,22 @@ extension, this flag wins and a warning is printed.
 
 Common alternate spellings are accepted, so `7zip` works as well as `7z` and
 `3ds` as well as `z3ds`. The CLI guide lists every alias.
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+zip
+.IP \(bu 2
+7z
+.IP \(bu 2
+chd
+.IP \(bu 2
+rvz
+.IP \(bu 2
+z3ds
+.RE
 .TP
 \fB\-o\fR, \fB\-\-output\fR \fI<PATH>\fR
 Where to write the archive
@@ -49,6 +65,38 @@ Without :level, a codec follows the \-\-level profile.
 
 Only the codec names a format actually supports are accepted; there are no
 cross\-format synonyms. The CLI guide lists them per format.
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+store
+.IP \(bu 2
+deflate
+.IP \(bu 2
+zstd
+.IP \(bu 2
+lzma
+.IP \(bu 2
+lzma2
+.IP \(bu 2
+zlib
+.IP \(bu 2
+huff
+.IP \(bu 2
+flac
+.IP \(bu 2
+cdzs
+.IP \(bu 2
+cdlz
+.IP \(bu 2
+cdzl
+.IP \(bu 2
+cdfl
+.IP \(bu 2
+avhuff
+.RE
 .TP
 \fB\-\-level\fR \fI<LEVEL>\fR [default: max]
 How hard to compress: min, very\-low, low, medium, high, very\-high, or max
@@ -73,6 +121,12 @@ very\-high
 max
 .RE
 .TP
+\fB\-\-force\fR
+Overwrite the output if it already exists (without this, the command stops instead)
+.TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Print the plan (inputs, output, format, codec, level, threads) and stop without writing
+.TP
 \fB\-j\fR, \fB\-\-threads\fR \fI<auto|N>\fR [default: auto]
 How many threads to use at most. auto uses every core; a format may still use fewer
 .TP
@@ -124,3 +178,6 @@ Keep colors even when output is piped
 .TP
 \fB\-\-no\-color\fR
 Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates

package/docs/man/rom-weaver-extract.1

@@ -4,7 +4,7 @@
 .SH NAME
 rom\-weaver\-extract \- Unpack an archive or single\-payload compressed format
 .SH SYNOPSIS
-\fBrom\-weaver extract\fR <\fB\-i\fR|\fB\-\-input\fR> [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] <\fB\-o\fR|\fB\-\-output\fR> [\fB\-\-split\-bin\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-no\-ignore\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-no\-nested\-extract\fR] [\fB\-\-color\fR] [\fB\-\-force\fR] [\fB\-\-checksum\fR] [\fB\-\-no\-color\fR] [\fB\-\-checksum\-rom\fR] [\fB\-\-probe\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-h\fR|\fB\-\-help\fR]
+\fBrom\-weaver extract\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-s\fR|\fB\-\-select\fR] [\fB\-\-filter\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-\-split\-bin\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-\-no\-ignore\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-no\-nested\-extract\fR] [\fB\-\-color\fR] [\fB\-\-force\fR] [\fB\-\-checksum\fR] [\fB\-\-no\-color\fR] [\fB\-\-checksum\-rom\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-\-probe\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fB\-i\fR|\fB\-\-input\fR> <\fB\-o\fR|\fB\-\-output\fR>
 .SH DESCRIPTION
 Unpack an archive or single\-payload compressed format into a directory.
 .PP
@@ -51,9 +51,53 @@ Overwrite files already in the output directory (without this, extraction stops
 .TP
 \fB\-\-checksum\fR \fI<ALGO>\fR
 Also hash every extracted file (repeatable, comma\-separable)
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+crc32
+.IP \(bu 2
+md5
+.IP \(bu 2
+sha1
+.IP \(bu 2
+sha256
+.IP \(bu 2
+blake3
+.IP \(bu 2
+crc32c
+.IP \(bu 2
+crc16
+.IP \(bu 2
+adler32
+.RE
 .TP
 \fB\-\-checksum\-rom\fR \fI<ALGO>\fR
-Like \-\-checksum, but hash only the ROMs and skip sidecar files. Ignored when \-\-checksum is also given
+Like \-\-checksum, but hash only the ROMs and skip sidecar files. Cannot be combined with \-\-checksum
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+crc32
+.IP \(bu 2
+md5
+.IP \(bu 2
+sha1
+.IP \(bu 2
+sha256
+.IP \(bu 2
+blake3
+.IP \(bu 2
+crc32c
+.IP \(bu 2
+crc16
+.IP \(bu 2
+adler32
+.RE
 .TP
 \fB\-\-probe\fR
 Also report the format and platform of what was extracted, and fail if a lone payload matches no known platform
@@ -109,3 +153,6 @@ Keep colors even when output is piped
 .TP
 \fB\-\-no\-color\fR
 Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates

package/docs/man/rom-weaver-formats.1

@@ -0,0 +1,66 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH rom-weaver-formats 1  "rom-weaver-formats "
+.SH NAME
+rom\-weaver\-formats \- List the formats, codecs, and checksum algorithms this build supports
+.SH SYNOPSIS
+\fBrom\-weaver formats\fR [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR]
+.SH DESCRIPTION
+List what this build supports, read straight from its registries: container
+formats (and whether each can be created, extracted, or both), patch formats,
+the codecs each container format accepts, and the checksum algorithms.
+.PP
+Pass \-\-json for the machine\-readable form.
+.SH OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help (see a summary with \*(Aq\-h\*(Aq)
+.SH "GLOBAL OPTIONS"
+.TP
+\fB\-\-json\fR
+Print one JSON object per line instead of human\-readable output
+.TP
+\fB\-\-progress\fR
+Show progress even when output is piped to a file or another program
+.TP
+\fB\-\-no\-progress\fR
+Hide progress
+.TP
+\fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR
+How much rom\-weaver logs to stderr. Separate from the normal output [default: off]
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+off
+.IP \(bu 2
+error
+.IP \(bu 2
+warn
+.IP \(bu 2
+info
+.IP \(bu 2
+debug
+.IP \(bu 2
+trace
+.RE
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+Log more: \-v for info, \-vv for debug, \-vvv for trace
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+Log errors only
+.TP
+\fB\-\-dep\-trace\fR
+Also log trace output from bundled libraries (for bug reports)
+.TP
+\fB\-\-color\fR
+Keep colors even when output is piped
+.TP
+\fB\-\-no\-color\fR
+Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates

package/docs/man/rom-weaver-identify-database-import-redump.1

@@ -0,0 +1,68 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH rom-weaver-identify-database-import-redump 1  "rom-weaver-identify-database-import-redump "
+.SH NAME
+rom\-weaver\-identify\-database\-import\-redump \- Build identify packs from local Redump DAT ZIP files
+.SH SYNOPSIS
+\fBrom\-weaver identify database import\-redump\fR [\fB\-\-database\-dir\fR] [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIZIP\fR>
+.SH DESCRIPTION
+Build identify packs from local Redump DAT ZIP files
+.SH OPTIONS
+.TP
+\fB\-\-database\-dir\fR \fI<DIR>\fR
+Identify database directory. Defaults to the per\-user data directory
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help
+.TP
+<\fIZIP\fR>
+Local Redump DAT ZIP file to import
+.SH "GLOBAL OPTIONS"
+.TP
+\fB\-\-json\fR
+Print one JSON object per line instead of human\-readable output
+.TP
+\fB\-\-progress\fR
+Show progress even when output is piped to a file or another program
+.TP
+\fB\-\-no\-progress\fR
+Hide progress
+.TP
+\fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR
+How much rom\-weaver logs to stderr. Separate from the normal output [default: off]
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+off
+.IP \(bu 2
+error
+.IP \(bu 2
+warn
+.IP \(bu 2
+info
+.IP \(bu 2
+debug
+.IP \(bu 2
+trace
+.RE
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+Log more: \-v for info, \-vv for debug, \-vvv for trace
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+Log errors only
+.TP
+\fB\-\-dep\-trace\fR
+Also log trace output from bundled libraries (for bug reports)
+.TP
+\fB\-\-color\fR
+Keep colors even when output is piped
+.TP
+\fB\-\-no\-color\fR
+Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates

package/docs/man/rom-weaver-identify-database-install-all.1

@@ -0,0 +1,65 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH rom-weaver-identify-database-install-all 1  "rom-weaver-identify-database-install-all "
+.SH NAME
+rom\-weaver\-identify\-database\-install\-all \- Install the full identify database for this rom\-weaver version
+.SH SYNOPSIS
+\fBrom\-weaver identify database install\-all\fR [\fB\-\-database\-dir\fR] [\fB\-\-json\fR] [\fB\-\-progress\fR] [\fB\-\-no\-progress\fR] [\fB\-\-log\-level\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-dep\-trace\fR] [\fB\-\-color\fR] [\fB\-\-no\-color\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-h\fR|\fB\-\-help\fR]
+.SH DESCRIPTION
+Install the full identify database for this rom\-weaver version
+.SH OPTIONS
+.TP
+\fB\-\-database\-dir\fR \fI<DIR>\fR
+Identify database directory. Defaults to the per\-user data directory
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help
+.SH "GLOBAL OPTIONS"
+.TP
+\fB\-\-json\fR
+Print one JSON object per line instead of human\-readable output
+.TP
+\fB\-\-progress\fR
+Show progress even when output is piped to a file or another program
+.TP
+\fB\-\-no\-progress\fR
+Hide progress
+.TP
+\fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR
+How much rom\-weaver logs to stderr. Separate from the normal output [default: off]
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+off
+.IP \(bu 2
+error
+.IP \(bu 2
+warn
+.IP \(bu 2
+info
+.IP \(bu 2
+debug
+.IP \(bu 2
+trace
+.RE
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+Log more: \-v for info, \-vv for debug, \-vvv for trace
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+Log errors only
+.TP
+\fB\-\-dep\-trace\fR
+Also log trace output from bundled libraries (for bug reports)
+.TP
+\fB\-\-color\fR
+Keep colors even when output is piped
+.TP
+\fB\-\-no\-color\fR
+Turn colors off
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Answer yes to every confirmation instead of asking. Does not choose between candidates