@rom-weaver/cli 0.14.1 → 0.15.1

package/docs/completions/rom-weaver.elv

@@ -40,6 +40,7 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
             cand extract 'Unpack an archive or single-payload compressed format'
             cand checksum 'Compute checksums for a file, or for a ROM inside an archive'
             cand identify 'Identify a ROM title from its checksums'
+            cand setup 'Install the offline identify database'
             cand ingest 'Sort a file into ROMs and patches, unpacking and hashing along the way'
             cand compress 'Pack files into an archive, disc image, or ROM-specific compressed format'
             cand trim 'Cut the padding off a ROM, or put it back'
@@ -49,6 +50,7 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
             cand plan-extract-batch 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)'
             cand weave 'Apply one or more patches to a ROM, in order (same as `patch apply`)'
             cand completions 'Print a tab-completion script for your shell'
+            cand man 'Print or install the generated CLI man pages'
             cand formats 'List the formats, codecs, and checksum algorithms this build supports'
             cand help 'Print this message or the help of the given subcommand(s)'
         }
@@ -464,6 +466,25 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
         }
         &'rom-weaver;identify;help;help'= {
         }
+        &'rom-weaver;setup'= {
+            cand --database-dir 'Install into this directory instead of the per-user data directory'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --force 'Download the database again even when it is already installed'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -y 'Answer yes to every confirmation instead of asking. Does not choose between candidates'
+            cand --yes 'Answer yes to every confirmation instead of asking. Does not choose between candidates'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
         &'rom-weaver;ingest'= {
             cand -i 'File to sort into ROMs and patches'
             cand --input 'File to sort into ROMs and patches'
@@ -591,11 +612,12 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
         &'rom-weaver;patch;apply'= {
             cand -i 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
             cand --input 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
-            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
-            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows'
+            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows'
             cand --target 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track'
             cand --filter 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
             cand --patch 'Patch to apply. Repeat once per patch; they run in the order given'
+            cand --patch-select 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select'
             cand -o 'Where to write the patched ROM. Optional when a bundle already names the output'
             cand --output 'Where to write the patched ROM. Optional when a bundle already names the output'
             cand --bundle 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL'
@@ -649,11 +671,12 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
         &'rom-weaver;patch;weave'= {
             cand -i 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
             cand --input 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
-            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
-            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows'
+            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows'
             cand --target 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track'
             cand --filter 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
             cand --patch 'Patch to apply. Repeat once per patch; they run in the order given'
+            cand --patch-select 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select'
             cand -o 'Where to write the patched ROM. Optional when a bundle already names the output'
             cand --output 'Where to write the patched ROM. Optional when a bundle already names the output'
             cand --bundle 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL'
@@ -707,10 +730,11 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
         &'rom-weaver;patch;validate'= {
             cand -i 'ROM to check the patches against. May be an archive'
             cand --input 'ROM to check the patches against. May be an archive'
-            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
-            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows'
+            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows'
             cand --filter 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
             cand --patch 'Patch to check. Repeat once per patch; they are checked in the order given'
+            cand --patch-select 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select'
             cand --assume-in 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)'
             cand --expect-in 'Fail unless the ROM matches: a checksum (crc32=1234abcd), an exact size (size=N), or a floor (min-size=N). Repeatable, comma-separable'
             cand --n64-byte-order 'Byte order to put an N64 ROM in before checking: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]'
@@ -1001,11 +1025,12 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
         &'rom-weaver;weave'= {
             cand -i 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
             cand --input 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle'
-            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
-            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)'
+            cand -s 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows'
+            cand --select 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows'
             cand --target 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track'
             cand --filter 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)'
             cand --patch 'Patch to apply. Repeat once per patch; they run in the order given'
+            cand --patch-select 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select'
             cand -o 'Where to write the patched ROM. Optional when a bundle already names the output'
             cand --output 'Where to write the patched ROM. Optional when a bundle already names the output'
             cand --bundle 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL'
@@ -1073,6 +1098,25 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
             cand -h 'Print help (see more with ''--help'')'
             cand --help 'Print help (see more with ''--help'')'
         }
+        &'rom-weaver;man'= {
+            cand --man-dir 'Directory to install pages into'
+            cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
+            cand --install 'Install the generated pages instead of printing one'
+            cand --json 'Print one JSON object per line instead of human-readable output'
+            cand --progress 'Show progress even when output is piped to a file or another program'
+            cand --no-progress 'Hide progress'
+            cand -v 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand --verbose 'Log more: -v for info, -vv for debug, -vvv for trace'
+            cand -q 'Log errors only'
+            cand --quiet 'Log errors only'
+            cand --dep-trace 'Also log trace output from bundled libraries (for bug reports)'
+            cand --color 'Keep colors even when output is piped'
+            cand --no-color 'Turn colors off'
+            cand -y 'Answer yes to every confirmation instead of asking. Does not choose between candidates'
+            cand --yes 'Answer yes to every confirmation instead of asking. Does not choose between candidates'
+            cand -h 'Print help (see more with ''--help'')'
+            cand --help 'Print help (see more with ''--help'')'
+        }
         &'rom-weaver;formats'= {
             cand --log-level 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]'
             cand --json 'Print one JSON object per line instead of human-readable output'
@@ -1095,6 +1139,7 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
             cand extract 'Unpack an archive or single-payload compressed format'
             cand checksum 'Compute checksums for a file, or for a ROM inside an archive'
             cand identify 'Identify a ROM title from its checksums'
+            cand setup 'Install the offline identify database'
             cand ingest 'Sort a file into ROMs and patches, unpacking and hashing along the way'
             cand compress 'Pack files into an archive, disc image, or ROM-specific compressed format'
             cand trim 'Cut the padding off a ROM, or put it back'
@@ -1104,6 +1149,7 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
             cand plan-extract-batch 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)'
             cand weave 'Apply one or more patches to a ROM, in order (same as `patch apply`)'
             cand completions 'Print a tab-completion script for your shell'
+            cand man 'Print or install the generated CLI man pages'
             cand formats 'List the formats, codecs, and checksum algorithms this build supports'
             cand help 'Print this message or the help of the given subcommand(s)'
         }
@@ -1145,6 +1191,8 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
         }
         &'rom-weaver;help;identify;database;update'= {
         }
+        &'rom-weaver;help;setup'= {
+        }
         &'rom-weaver;help;ingest'= {
         }
         &'rom-weaver;help;compress'= {
@@ -1184,6 +1232,8 @@ set edit:completion:arg-completer[rom-weaver] = {|@words|
         }
         &'rom-weaver;help;completions'= {
         }
+        &'rom-weaver;help;man'= {
+        }
         &'rom-weaver;help;formats'= {
         }
         &'rom-weaver;help;help'= {

package/docs/completions/rom-weaver.fish

@@ -46,6 +46,7 @@ complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "inspect" -d '
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "extract" -d 'Unpack an archive or single-payload compressed format'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "checksum" -d 'Compute checksums for a file, or for a ROM inside an archive'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "identify" -d 'Identify a ROM title from its checksums'
+complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "setup" -d 'Install the offline identify database'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "ingest" -d 'Sort a file into ROMs and patches, unpacking and hashing along the way'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "compress" -d 'Pack files into an archive, disc image, or ROM-specific compressed format'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "trim" -d 'Cut the padding off a ROM, or put it back'
@@ -55,6 +56,7 @@ complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "tools" -d 'On
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "plan-extract-batch" -d 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "weave" -d 'Apply one or more patches to a ROM, in order (same as `patch apply`)'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "completions" -d 'Print a tab-completion script for your shell'
+complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "man" -d 'Print or install the generated CLI man pages'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "formats" -d 'List the formats, codecs, and checksum algorithms this build supports'
 complete -c rom-weaver -n "__fish_rom_weaver_needs_command" -f -a "help" -d 'Print this message or the help of the given subcommand(s)'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand probe" -s i -l input -d 'File to identify. Use - to read from stdin' -r -F
@@ -240,6 +242,24 @@ complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand identify; and __fi
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand identify; and __fish_seen_subcommand_from database" -f -a "help" -d 'Print this message or the help of the given subcommand(s)'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand identify; and __fish_seen_subcommand_from help" -f -a "database" -d 'Manage the installed identify database packs'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand identify; and __fish_seen_subcommand_from help" -f -a "help" -d 'Print this message or the help of the given subcommand(s)'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -l database-dir -d 'Install into this directory instead of the per-user data directory' -r -F
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -l log-level -d 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]' -r -f -a "off\t''
+error\t''
+warn\t''
+info\t''
+debug\t''
+trace\t''"
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -l force -d 'Download the database again even when it is already installed'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -l json -d 'Print one JSON object per line instead of human-readable output'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -l progress -d 'Show progress even when output is piped to a file or another program'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -l no-progress -d 'Hide progress'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -s v -l verbose -d 'Log more: -v for info, -vv for debug, -vvv for trace'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -s q -l quiet -d 'Log errors only'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -l dep-trace -d 'Also log trace output from bundled libraries (for bug reports)'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -l color -d 'Keep colors even when output is piped'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -l no-color -d 'Turn colors off'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -s y -l yes -d 'Answer yes to every confirmation instead of asking. Does not choose between candidates'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand setup" -s h -l help -d 'Print help (see more with \'--help\')'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand ingest" -s i -l input -d 'File to sort into ROMs and patches' -r -F
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand ingest" -s o -l output -d 'Directory to write anything unpacked along the way into' -r -F
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand ingest" -s d -l database -d 'RWFP1 identify pack, raw or Brotli, for ROM titles (repeatable; native defaults to built-in data)' -r -F
@@ -373,11 +393,12 @@ complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and not __f
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and not __fish_seen_subcommand_from apply weave validate create help" -f -a "create" -d 'Build a patch from an original ROM and a changed one'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and not __fish_seen_subcommand_from apply weave validate create help" -f -a "help" -d 'Print this message or the help of the given subcommand(s)'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -s i -l input -d 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle' -r -F
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -s s -l select -d 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)' -r
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -s s -l select -d 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -l target -d 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -l filter -d 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)' -r -f -a "rom\t''
 patch\t''"
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -l patch -d 'Patch to apply. Repeat once per patch; they run in the order given' -r -F
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -l patch-select -d 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -s o -l output -d 'Where to write the patched ROM. Optional when a bundle already names the output' -r -F
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -l bundle -d 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL' -r -F
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -l with -d 'Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)' -r
@@ -454,11 +475,12 @@ complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -s y -l yes -d 'Answer yes to every confirmation instead of asking. Does not choose between candidates'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from apply" -s h -l help -d 'Print help (see more with \'--help\')'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -s i -l input -d 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle' -r -F
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -s s -l select -d 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)' -r
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -s s -l select -d 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -l target -d 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -l filter -d 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)' -r -f -a "rom\t''
 patch\t''"
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -l patch -d 'Patch to apply. Repeat once per patch; they run in the order given' -r -F
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -l patch-select -d 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -s o -l output -d 'Where to write the patched ROM. Optional when a bundle already names the output' -r -F
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -l bundle -d 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL' -r -F
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -l with -d 'Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)' -r
@@ -535,10 +557,11 @@ complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -s y -l yes -d 'Answer yes to every confirmation instead of asking. Does not choose between candidates'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from weave" -s h -l help -d 'Print help (see more with \'--help\')'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from validate" -s i -l input -d 'ROM to check the patches against. May be an archive' -r -F
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from validate" -s s -l select -d 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)' -r
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from validate" -s s -l select -d 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from validate" -l filter -d 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)' -r -f -a "rom\t''
 patch\t''"
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from validate" -l patch -d 'Patch to check. Repeat once per patch; they are checked in the order given' -r -F
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from validate" -l patch-select -d 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from validate" -l assume-in -d 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from validate" -l expect-in -d 'Fail unless the ROM matches: a checksum (crc32=1234abcd), an exact size (size=N), or a floor (min-size=N). Repeatable, comma-separable' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand patch; and __fish_seen_subcommand_from validate" -l n64-byte-order -d 'Byte order to put an N64 ROM in before checking: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]' -r -f -a "auto\t''
@@ -803,11 +826,12 @@ complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand plan-extract-batch
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand plan-extract-batch" -s y -l yes -d 'Answer yes to every confirmation instead of asking. Does not choose between candidates'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand plan-extract-batch" -s h -l help -d 'Print help'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand weave" -s i -l input -d 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle' -r -F
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand weave" -s s -l select -d 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)' -r
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand weave" -s s -l select -d 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand weave" -l target -d 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand weave" -l filter -d 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)' -r -f -a "rom\t''
 patch\t''"
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand weave" -l patch -d 'Patch to apply. Repeat once per patch; they run in the order given' -r -F
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand weave" -l patch-select -d 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select' -r
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand weave" -s o -l output -d 'Where to write the patched ROM. Optional when a bundle already names the output' -r -F
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand weave" -l bundle -d 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL' -r -F
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand weave" -l with -d 'Turn on a bundle patch the bundle leaves off by default, matched by name or file name (repeatable)' -r
@@ -899,6 +923,24 @@ complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand completions" -l co
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand completions" -l no-color -d 'Turn colors off'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand completions" -s y -l yes -d 'Answer yes to every confirmation instead of asking. Does not choose between candidates'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand completions" -s h -l help -d 'Print help (see more with \'--help\')'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -l man-dir -d 'Directory to install pages into' -r -F
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -l log-level -d 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]' -r -f -a "off\t''
+error\t''
+warn\t''
+info\t''
+debug\t''
+trace\t''"
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -l install -d 'Install the generated pages instead of printing one'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -l json -d 'Print one JSON object per line instead of human-readable output'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -l progress -d 'Show progress even when output is piped to a file or another program'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -l no-progress -d 'Hide progress'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -s v -l verbose -d 'Log more: -v for info, -vv for debug, -vvv for trace'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -s q -l quiet -d 'Log errors only'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -l dep-trace -d 'Also log trace output from bundled libraries (for bug reports)'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -l color -d 'Keep colors even when output is piped'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -l no-color -d 'Turn colors off'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -s y -l yes -d 'Answer yes to every confirmation instead of asking. Does not choose between candidates'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand man" -s h -l help -d 'Print help (see more with \'--help\')'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand formats" -l log-level -d 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]' -r -f -a "off\t''
 error\t''
 warn\t''
@@ -915,21 +957,23 @@ complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand formats" -l color
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand formats" -l no-color -d 'Turn colors off'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand formats" -s y -l yes -d 'Answer yes to every confirmation instead of asking. Does not choose between candidates'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand formats" -s h -l help -d 'Print help (see more with \'--help\')'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "probe" -d 'Identify a file: its format, its platform, and any header it carries'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "extract" -d 'Unpack an archive or single-payload compressed format'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "checksum" -d 'Compute checksums for a file, or for a ROM inside an archive'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "identify" -d 'Identify a ROM title from its checksums'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "ingest" -d 'Sort a file into ROMs and patches, unpacking and hashing along the way'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "compress" -d 'Pack files into an archive, disc image, or ROM-specific compressed format'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "trim" -d 'Cut the padding off a ROM, or put it back'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "patch" -d 'Apply, create, or check ROM patches'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "bundle" -d 'Build and read rom-weaver-bundle.json patch recipes'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "tools" -d 'One-off recovery tools'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "plan-extract-batch" -d 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "weave" -d 'Apply one or more patches to a ROM, in order (same as `patch apply`)'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "completions" -d 'Print a tab-completion script for your shell'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "formats" -d 'List the formats, codecs, and checksum algorithms this build supports'
-complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify ingest compress trim patch bundle tools plan-extract-batch weave completions formats help" -f -a "help" -d 'Print this message or the help of the given subcommand(s)'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "probe" -d 'Identify a file: its format, its platform, and any header it carries'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "extract" -d 'Unpack an archive or single-payload compressed format'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "checksum" -d 'Compute checksums for a file, or for a ROM inside an archive'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "identify" -d 'Identify a ROM title from its checksums'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "setup" -d 'Install the offline identify database'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "ingest" -d 'Sort a file into ROMs and patches, unpacking and hashing along the way'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "compress" -d 'Pack files into an archive, disc image, or ROM-specific compressed format'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "trim" -d 'Cut the padding off a ROM, or put it back'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "patch" -d 'Apply, create, or check ROM patches'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "bundle" -d 'Build and read rom-weaver-bundle.json patch recipes'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "tools" -d 'One-off recovery tools'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "plan-extract-batch" -d 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "weave" -d 'Apply one or more patches to a ROM, in order (same as `patch apply`)'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "completions" -d 'Print a tab-completion script for your shell'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "man" -d 'Print or install the generated CLI man pages'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "formats" -d 'List the formats, codecs, and checksum algorithms this build supports'
+complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and not __fish_seen_subcommand_from probe extract checksum identify setup ingest compress trim patch bundle tools plan-extract-batch weave completions man formats help" -f -a "help" -d 'Print this message or the help of the given subcommand(s)'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and __fish_seen_subcommand_from identify" -f -a "database" -d 'Manage the installed identify database packs'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and __fish_seen_subcommand_from patch" -f -a "apply" -d 'Apply one or more patches to a ROM, in order'
 complete -c rom-weaver -n "__fish_rom_weaver_using_subcommand help; and __fish_seen_subcommand_from patch" -f -a "validate" -d 'Check that patches would apply cleanly, without writing anything'

package/docs/completions/rom-weaver.ps1

@@ -43,6 +43,7 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('extract', 'extract', [CompletionResultType]::ParameterValue, 'Unpack an archive or single-payload compressed format')
             [CompletionResult]::new('checksum', 'checksum', [CompletionResultType]::ParameterValue, 'Compute checksums for a file, or for a ROM inside an archive')
             [CompletionResult]::new('identify', 'identify', [CompletionResultType]::ParameterValue, 'Identify a ROM title from its checksums')
+            [CompletionResult]::new('setup', 'setup', [CompletionResultType]::ParameterValue, 'Install the offline identify database')
             [CompletionResult]::new('ingest', 'ingest', [CompletionResultType]::ParameterValue, 'Sort a file into ROMs and patches, unpacking and hashing along the way')
             [CompletionResult]::new('compress', 'compress', [CompletionResultType]::ParameterValue, 'Pack files into an archive, disc image, or ROM-specific compressed format')
             [CompletionResult]::new('trim', 'trim', [CompletionResultType]::ParameterValue, 'Cut the padding off a ROM, or put it back')
@@ -52,6 +53,7 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('plan-extract-batch', 'plan-extract-batch', [CompletionResultType]::ParameterValue, 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)')
             [CompletionResult]::new('weave', 'weave', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order (same as `patch apply`)')
             [CompletionResult]::new('completions', 'completions', [CompletionResultType]::ParameterValue, 'Print a tab-completion script for your shell')
+            [CompletionResult]::new('man', 'man', [CompletionResultType]::ParameterValue, 'Print or install the generated CLI man pages')
             [CompletionResult]::new('formats', 'formats', [CompletionResultType]::ParameterValue, 'List the formats, codecs, and checksum algorithms this build supports')
             [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
             break
@@ -506,6 +508,26 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;identify;help;help' {
             break
         }
+        'rom-weaver;setup' {
+            [CompletionResult]::new('--database-dir', '--database-dir', [CompletionResultType]::ParameterName, 'Install into this directory instead of the per-user data directory')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('--force', '--force', [CompletionResultType]::ParameterName, 'Download the database again even when it is already installed')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            break
+        }
         'rom-weaver;ingest' {
             [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'File to sort into ROMs and patches')
             [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'File to sort into ROMs and patches')
@@ -637,11 +659,12 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;patch;apply' {
             [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
             [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
-            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)')
-            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)')
+            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows')
+            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows')
             [CompletionResult]::new('--target', '--target', [CompletionResultType]::ParameterName, 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track')
             [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
             [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to apply. Repeat once per patch; they run in the order given')
+            [CompletionResult]::new('--patch-select', '--patch-select', [CompletionResultType]::ParameterName, 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select')
             [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
             [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
             [CompletionResult]::new('--bundle', '--bundle', [CompletionResultType]::ParameterName, 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL')
@@ -696,11 +719,12 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;patch;weave' {
             [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
             [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
-            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)')
-            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)')
+            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows')
+            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows')
             [CompletionResult]::new('--target', '--target', [CompletionResultType]::ParameterName, 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track')
             [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
             [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to apply. Repeat once per patch; they run in the order given')
+            [CompletionResult]::new('--patch-select', '--patch-select', [CompletionResultType]::ParameterName, 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select')
             [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
             [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
             [CompletionResult]::new('--bundle', '--bundle', [CompletionResultType]::ParameterName, 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL')
@@ -755,10 +779,11 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;patch;validate' {
             [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM to check the patches against. May be an archive')
             [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM to check the patches against. May be an archive')
-            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)')
-            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)')
+            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows')
+            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows')
             [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
             [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to check. Repeat once per patch; they are checked in the order given')
+            [CompletionResult]::new('--patch-select', '--patch-select', [CompletionResultType]::ParameterName, 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select')
             [CompletionResult]::new('--assume-in', '--assume-in', [CompletionResultType]::ParameterName, 'Take this checksum on trust instead of reading the ROM to compute it, as in crc32=1234abcd (repeatable, comma-separable)')
             [CompletionResult]::new('--expect-in', '--expect-in', [CompletionResultType]::ParameterName, 'Fail unless the ROM matches: a checksum (crc32=1234abcd), an exact size (size=N), or a floor (min-size=N). Repeatable, comma-separable')
             [CompletionResult]::new('--n64-byte-order', '--n64-byte-order', [CompletionResultType]::ParameterName, 'Byte order to put an N64 ROM in before checking: auto, keep, big-endian, little-endian, or byte-swapped [default: auto]')
@@ -1071,11 +1096,12 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;weave' {
             [CompletionResult]::new('-i', '-i', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
             [CompletionResult]::new('--input', '--input', [CompletionResultType]::ParameterName, 'ROM to patch. May be an archive, a disc sheet (.cue/.gdi), or a bundle')
-            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)')
-            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable)')
+            [CompletionResult]::new('-s', '-s', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows')
+            [CompletionResult]::new('--select', '--select', [CompletionResultType]::ParameterName, 'Pick which file to use when the ROM or a patch is inside an archive, by exact name, prefix, or glob (repeatable). --patch-select overrides it for the patch it follows')
             [CompletionResult]::new('--target', '--target', [CompletionResultType]::ParameterName, 'For a .cue or .gdi input, which track gets the patch. Matched like --select and must hit exactly one track')
             [CompletionResult]::new('--filter', '--filter', [CompletionResultType]::ParameterName, 'Consider only files that look like a rom or a patch, judged by extension (repeatable, comma-separable)')
             [CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Patch to apply. Repeat once per patch; they run in the order given')
+            [CompletionResult]::new('--patch-select', '--patch-select', [CompletionResultType]::ParameterName, 'Pick which file to use inside the --patch archive before it. Repeatable, one per --patch; falls back to --select')
             [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
             [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Where to write the patched ROM. Optional when a bundle already names the output')
             [CompletionResult]::new('--bundle', '--bundle', [CompletionResultType]::ParameterName, 'Follow a rom-weaver-bundle.json recipe: a file path, or an http(s) URL')
@@ -1145,6 +1171,26 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
             break
         }
+        'rom-weaver;man' {
+            [CompletionResult]::new('--man-dir', '--man-dir', [CompletionResultType]::ParameterName, 'Directory to install pages into')
+            [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
+            [CompletionResult]::new('--install', '--install', [CompletionResultType]::ParameterName, 'Install the generated pages instead of printing one')
+            [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
+            [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Show progress even when output is piped to a file or another program')
+            [CompletionResult]::new('--no-progress', '--no-progress', [CompletionResultType]::ParameterName, 'Hide progress')
+            [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
+            [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Log more: -v for info, -vv for debug, -vvv for trace')
+            [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Log errors only')
+            [CompletionResult]::new('--dep-trace', '--dep-trace', [CompletionResultType]::ParameterName, 'Also log trace output from bundled libraries (for bug reports)')
+            [CompletionResult]::new('--color', '--color', [CompletionResultType]::ParameterName, 'Keep colors even when output is piped')
+            [CompletionResult]::new('--no-color', '--no-color', [CompletionResultType]::ParameterName, 'Turn colors off')
+            [CompletionResult]::new('-y', '-y', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('--yes', '--yes', [CompletionResultType]::ParameterName, 'Answer yes to every confirmation instead of asking. Does not choose between candidates')
+            [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
+            break
+        }
         'rom-weaver;formats' {
             [CompletionResult]::new('--log-level', '--log-level', [CompletionResultType]::ParameterName, 'How much rom-weaver logs to stderr. Separate from the normal output [default: off]')
             [CompletionResult]::new('--json', '--json', [CompletionResultType]::ParameterName, 'Print one JSON object per line instead of human-readable output')
@@ -1168,6 +1214,7 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('extract', 'extract', [CompletionResultType]::ParameterValue, 'Unpack an archive or single-payload compressed format')
             [CompletionResult]::new('checksum', 'checksum', [CompletionResultType]::ParameterValue, 'Compute checksums for a file, or for a ROM inside an archive')
             [CompletionResult]::new('identify', 'identify', [CompletionResultType]::ParameterValue, 'Identify a ROM title from its checksums')
+            [CompletionResult]::new('setup', 'setup', [CompletionResultType]::ParameterValue, 'Install the offline identify database')
             [CompletionResult]::new('ingest', 'ingest', [CompletionResultType]::ParameterValue, 'Sort a file into ROMs and patches, unpacking and hashing along the way')
             [CompletionResult]::new('compress', 'compress', [CompletionResultType]::ParameterValue, 'Pack files into an archive, disc image, or ROM-specific compressed format')
             [CompletionResult]::new('trim', 'trim', [CompletionResultType]::ParameterValue, 'Cut the padding off a ROM, or put it back')
@@ -1177,6 +1224,7 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
             [CompletionResult]::new('plan-extract-batch', 'plan-extract-batch', [CompletionResultType]::ParameterValue, 'Plan a memory-/thread-aware concurrent extraction schedule from per-job source sizes (no I/O)')
             [CompletionResult]::new('weave', 'weave', [CompletionResultType]::ParameterValue, 'Apply one or more patches to a ROM, in order (same as `patch apply`)')
             [CompletionResult]::new('completions', 'completions', [CompletionResultType]::ParameterValue, 'Print a tab-completion script for your shell')
+            [CompletionResult]::new('man', 'man', [CompletionResultType]::ParameterValue, 'Print or install the generated CLI man pages')
             [CompletionResult]::new('formats', 'formats', [CompletionResultType]::ParameterValue, 'List the formats, codecs, and checksum algorithms this build supports')
             [CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
             break
@@ -1233,6 +1281,9 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;help;identify;database;update' {
             break
         }
+        'rom-weaver;help;setup' {
+            break
+        }
         'rom-weaver;help;ingest' {
             break
         }
@@ -1288,6 +1339,9 @@ Register-ArgumentCompleter -Native -CommandName 'rom-weaver' -ScriptBlock {
         'rom-weaver;help;completions' {
             break
         }
+        'rom-weaver;help;man' {
+            break
+        }
         'rom-weaver;help;formats' {
             break
         }