Skip to content

Releases

v0.9.1

Choose a tag to compare

@github-actions github-actions released this 14 Nov 14:39
v0.9.1
01aa511

Release Notes - Version 0.9.1

Install

Homebrew (macOS or Linux)

brew install as-foss/mandible/mandible

Fedora / EPEL (COPR repository)

sudo dnf copr enable as-foss/mandible
sudo dnf install mandible

Nix

nix run github:AS-FOSS/mandible

Cargo

cargo binstall mandible
cargo install mandible

Debian and Ubuntu: the signed apt repository carries every released version for amd64 and arm64, with setup instructions.

Or download a binary below. Verify with the accompanying .sha256.


Added

  • When a tool's --help answer gives nothing and quotes the invocation that prints help (try "tc -help"), mandible runs that invocation, at most twice, if every word in it is --help, -help, -h, help, all after --help, or a command the text lists; tc, genl and rtmon show their pages.
  • A NAME := { a | b } production behind a usage form's command position (ip [ OPTIONS ] OBJECT { COMMAND | help }) lists that tool's commands, so ip, tc, bridge, devlink, rdma, dcb and vdpa show them instead of an OBJECT operand; the braced list after a flag in a production is its values (rtmon -f[amily]); a command whose --help gives nothing is asked <command> help once, when the usage form shows help there.

Changed

  • A required value written after = is drawn as written: cp -S, --suffix=SUFFIX, od -j, --skip-bytes=BYTES, rescan-scsi-bus.sh --hosts=LIST. A value written after a space is unchanged.
  • less, zstdless and pager draw --tabs=[N[,...]] and --quotes=[c[c]] with the = outside the bracket, as the tool writes them.
  • curl --http0.9, --http1.0, --tlsv1.3 and the other names with a dotted number are whole flag names, not a name plus a value, and so are node --tls-min-v1.2 and setarch --uname-2.6.
  • genl shows { ctrl etc } as the text of its OBJECT operand.
  • ip lists -force, a flag only its second usage form shows.
  • A flag row whose description follows its spelling after one space (lvmdump -h print this message, xfs_estimate -v prints more verbose messages, rescan-scsi-bus.sh -I SECS issue a ...) shows the sentence as its description instead of taking its first word as a value; ffmpeg -h long -- print more options and tar --ignore-command-error keep their text.
  • A colon after a row's spelling is no longer read as a value (ssh-copy-id -n:, rescan-scsi-bus.sh --alltargets:), --sync/nosync reads as --sync, --nosync, and the description of rescan-scsi-bus.sh no longer repeats its flag rows.
  • ucf and lcf show -d, --debug=[n], -s, --src-dir foo and --state-dir bar with their full descriptions, ucf -p destination as a second usage form, and -p, --purge as one flag; less draws --pattern=[pattern] as written.
  • java -verbose:[class|module|gc|jni] lists class, module, gc and jni as its values.
  • od, nano and autom4te show their description: two spaces after a full stop no longer read as a column gap that drops the paragraph.
  • od -t lists all seven format specifications (d[SIZE], f[SIZE] and the rest), and -j, -N, -S and -w list the whole b, KB, K, MB, M multiplier table instead of its first row.
  • java shows its five usage forms, each (to execute ...) note on its own line under its form; jinfo and jstack draw their note the same way.
  • ip link help and the pages like it: every form of a multi-form usage block belongs to its verb (including add, delete, exec, route add), wrapped form lines no longer become a command's description, and the page no longer lists the verbs' keyword placeholders as operands.
  • where NAME := text legends describe their placeholder on ip macsec and ip l2tp (:= dropped, { none | default } as values), ip l2tp del tunnel and del session are commands of del, bridge fdb show is a command of bridge fdb, a new dash word separates flags in devlink's option production, tc reads { -cf | -conf } path as one flag, and genl no longer lists help as an operand.
  • A value written only as alternatives (y|n, [none|zlib], {auto|manual}) shows as a muted {…} where its name would be, with the values listed once on the values: line, which sits on the flag's own row when it has no description, as in vgchange --activate, ld --compress-debug-sections, sg_inq --block and apt-mark's first operand.

Fixed

  • A sentence that heads an option table (Mandatory arguments to long options are mandatory for short options too. on cp, uniq, du, od and others) ends the description instead of being dropped.
  • ffmpeg is read from ffmpeg -h full, the most complete help it lists, instead of the basic ffmpeg -h.
  • python3 no longer repeats its option table as description text.
  • kernel-install lists add, add-all, remove, inspect and list as commands, each with the operands of its own usage form, and shows its COMMAND line as the first usage form.
  • elfedit and readelf show the sentence under their usage line as description and no longer invent an ELF operand; pngfix shows its description.
  • ip lists -iec, -j[son], -p[retty] and -br[ief] as their own flags instead of text on -h and -l[oops], and -l[oops] takes the value maximum-addr-flush-attempts.
  • git stash no longer lists diff-options and commit: git stash show lists diff-options and git stash store lists commit, and stash drop, pop, apply, git bundle verify and git remote prune list the operand their usage form names.
  • mandible jfr configure keeps the line breaks and indentation of the option=value, event-setting=value and Options for default.jfc: rows in its description.
  • chmod lists MODE[,MODE]..., OCTAL-MODE and FILE..., msgexec its COMMAND-OPTION and sotruss its EXECUTABLE-OPTION... operand.
  • A STYLE is one of: block (nl -b, -f, -h) or a <color>: black blue ... legend (setterm) gives its values to every flag whose value names the placeholder, and setterm --ulcolor and --hbcolor keep [bright] <color> as their value ([S-259]).
  • An Example usage: block of the tool's own command lines (jfr configure ...) is listed under EXAMPLES instead of the description, when a synopsis already sits above it.
  • Prose indented under a Usage: line and running on from it (pigz) is the description, not part of the usage line, and its last line is no longer dropped.
  • A value written straight onto its flag draws that way (-Z<type>, -z#, +<cmd>, -D<name>=<value>, -splash:<imagepath>), --buffers=[N] draws as written, -cp <path> and -verbose:[...] stay whole words, stacked spelling lines and -? -h -help are one flag, ebtables' [!] rows read, and less's -<flag> key is no flag, on java, dpkg-deb, nvim, less, ebtables and the tools that write glued values.
  • Flag rows with a dot leader between the short and long spelling (-a ........ --search-skip-screen) are read as one flag with both names, -nm | -nam[es] and a once-written [-force] stay whole words, and <script> [args...] is one value, on less, tc and nvim -l; less's long-only rows are their own flags, and overstrike no longer leaks into value names.
  • A flag row led by [!] (iptables' invertible flags) is read, and the page draws [!] before its spellings, muted like [no-]; a long-first head (--append -A chain) is one flag with both spellings and its value, on ip6tables-translate.
  • Flag rows read whole: ld's -EB, -Map FILE/DIR, -fini SYMBOL and -h FILENAME, -soname FILENAME, jstack's -? -h --help -help, strip's -M --merge-notes, era_invalidate's {-o <xml file>}, add-apt-repository's -S SOURCESLIST [SOURCESLIST ...] and nl's pBRE choice.
  • Usage-line operands now reach the tree for [option...] [mapfile...], COMMAND [INITIAL-ARGS]..., operation [count], type#[source] destination [-t type] and xfsdev | dir | file ...; option(s) is no longer an operand, and update-ca-certificates shows its two flags.

v0.9.0

Choose a tag to compare

@github-actions github-actions released this 30 Oct 01:42
v0.9.0
82032a8

Release Notes - Version 0.9.0

This release is about how mandible looks and how you move around in it. There is now a settings screen and a set of colour themes, search has been rebuilt, both panes can be sorted, long lines can wrap or scroll sideways, and help pages read more like the tool meant them to. Big help pages are also much faster.

Install

Homebrew (macOS or Linux)

brew install as-foss/mandible/mandible

Fedora / EPEL (COPR repository)

sudo dnf copr enable as-foss/mandible
sudo dnf install mandible

Nix

nix run github:AS-FOSS/mandible

Cargo

cargo binstall mandible
cargo install mandible

Debian and Ubuntu: the signed apt repository carries every released version for amd64 and arm64, with setup instructions.

Or download a binary below. Verify with the accompanying .sha256.


Settings and colour themes

Press ? and then Tab to open the new settings tab. Pick a setting with ↑/↓ and change it with ←/→. A change shows on screen straight away and is saved to ~/.config/mandible/config.toml. Only the line you changed is touched, so your own comments and other settings stay where they are.

Settings and themes

  • Seven built-in themes: default, light (for light terminals), high-contrast, gruvbox-style, nord-style, dracula-style and catppuccin-style.
  • Your own colours: choose custom and set each of the seven colours yourself. Step through the 256 terminal colours with ←/→, or press Enter and type a number or a colour name. Each row shows a sample of what that colour paints.
  • Other settings: open in the tool's own --help view, scroll long lines sideways, show long descriptions as a preview, use ASCII glyphs, and the starting sort order for flags and commands.
  • NO_COLOR and MANDIBLE_ASCII still win over the file. A setting they decide is shown dimmed, with the variable's name next to it.
  • A mistake in config.toml costs only that one line. Everything else still applies, and the footer names the line until you press a key.
  • mandible mandible now uses your theme's colours too.

Search, rebuilt

Search

  • Every word, in any order. no verify finds --no-verify, size finds --blocksize, and a dash is just a character, so --no-squash finds --[no-]squash.
  • A suggestion as you type. A dim hint shows where Enter will land. Tab takes it.
  • n and p step through the matching flags on the page, wrapping at the ends.
  • Matches are marked in both panes. Matching commands are bold, each one shows how many of its flags matched (3 found), and matching rows on the page get a bar in the margin with the matched letters underlined.
  • A better first jump. Enter goes to the best match: an exact name first, then names that start with what you typed. /rebase now lands on git rebase.
  • When nothing matches, the list says No matches for "…" and the cursor goes back to where it was.
  • Esc in the box cancels the search and returns you to the row you started from. / reopens the box with your last search.

Sort either pane

Press s to sort the focused pane by name. On a command's page it cycles through the tool's own order, A–Z within each section, and A–Z over the whole page. The commands list switches between the tool's order and A–Z. The pane title shows which order you are in.

Sorting

Wrap, or scroll sideways

Press w to switch line wrapping off and on in the view on screen. With wrapping off, each line stays on one row, ←/→ scroll sideways, ◀ and ▶ mark lines that continue off screen, and Esc goes back to the first column. Section headings keep their full width however far you scroll.

Wrapping and scrolling

Moving around

  • PgUp/PgDn move ten rows in the commands list and a screenful on the page. Home/End jump to the top or bottom. This works in the parsed and the raw view.
  • The ? pop-up fits its content, uses two columns on a wide terminal, and scrolls when the terminal is short.
  • ▲ and ▼ on the page border tell you there is more above or below.
  • Changing wrap or resizing the terminal keeps the same line at the top of the page.
  • Command keys work with Caps Lock on.
  • A terminal smaller than 30×10 shows a short message asking for more room, instead of a broken screen.

Pages that read better

Several spellings stay readable. A flag with more than one short or long name keeps the first pair on the first line and lists the others below it, after a dim or.

Flags with several spellings

Narrow terminals get a man-page like layout. When a description would get squeezed below 20 columns, the flag goes on its own line with its description indented underneath.

Narrow layout

USAGE is easier to scan. The command path is highlighted at the start of each usage line, and a form that wraps continues indented, so you can see where one form ends and the next begins. The selected row in the commands list is now a full-width bar.

USAGE and the selected row

Examples get their own section. A tool's example lines are collected into an EXAMPLES section at the end of the page, printed exactly as written (tar, jq, bpftrace, gh pr list and more).

EXAMPLES section

Long descriptions don't push the flags away. A description that would fill more than half the page shows as a short preview at the top, with the full text as the last section.

Clear notices. Messages from mandible itself, as opposed to the tool's own help text, are short and drawn in the warning colour when something went wrong. For example, when mandible will not run a name it could not confirm is a real command:

Notices

  • A page with nothing beyond its summary says so and tells you to press t to see what the command printed.
  • A command whose help is still being read says Reading this command's help… instead of showing a blank page.
  • A description that only repeats the summary line, as on most docker commands, is no longer shown twice.
  • Summaries in the commands list show only when they have room. A long name hides its own summary instead of cutting it to a fragment.

Faster on big help pages

Search on ffplay

  • Searching a page with thousands of flags, like mandible ffplay, used to take about a second per key. It now takes under a tenth of a second.
  • Pages with thousands of flags scroll without lag, and an idle screen no longer redraws itself ten times a second.
  • Reloading with r or opening the raw view with t no longer freezes the screen while a slow tool answers.
  • The command under the cursor is read first, ahead of the background walk.

More reliable reading

  • Each command gets 30 seconds to print its help, up from 10. If it takes longer, the page says so and r tries again with two minutes. --doctor and --report take --no-timeout to wait as long as needed.
  • A slow command shows the same page on every launch. git filter-branch used to show different pages on different runs.
  • Quitting mandible while it is reading a tool's help no longer leaves that tool running in the background.
  • r reloads what you are looking at: a command and its subcommands, or the whole tool from its root page.
  • A row opened before the background walk reached it no longer stays ⋯ loading for good.

Parser fixes

  • krb5-config lists its library names under the LIBRARIES operand instead of under --libs.
  • A usage line that names another program, like bpftrace [options] filename under tcpretrans.bt, is shown as printed.
  • A value written --log-file=[PATH] is read as an optional value PATH.
  • Long value names and group headings wrap inside a narrow page instead of running past the border.

Changes to know about

  • The raw view (t) now folds long lines to the pane by default. Set horizontal_scroll = true in config.toml to get sideways scrolling back. That one setting now covers both views.
  • The ? pop-up closes with Esc or ?.

The full list of changes is in the CHANGELOG.

v0.8.4

Choose a tag to compare

@github-actions github-actions released this 12 Oct 19:34
v0.8.4
498ae3d

Release Notes - Version 0.8.4

Install

Homebrew (macOS or Linux)

brew install as-foss/mandible/mandible

Fedora / EPEL (COPR repository)

sudo dnf copr enable as-foss/mandible
sudo dnf install mandible

Nix

nix run github:AS-FOSS/mandible

Cargo

cargo binstall mandible
cargo install mandible

Debian and Ubuntu: the signed apt repository carries every released version for amd64 and arm64, with setup instructions.

Or download a binary below. Verify with the accompanying .sha256.


Fixed

  • A heading word such as Options: is no longer a tool's description: mandible gcc, g++, cpp, ld, thin_check and more than 100 other tools show no description line where the help prints only a heading (a heading like Management Options stays the label of its flags).
  • pnpm and its subcommand pages now show the page's own description first and the Version 11.22.0 line after it, instead of opening with the version.
  • snap get now shows its description with the three $ snap get example blocks and their output, which were dropped.
  • mandible jarsigner shows -providerArg <arg> as its own flag, with configure argument for -addprovider and ... for -providerClass, instead of text inside those two flags' descriptions.
  • mandible cargo-generate-rpm --auto-req lists its values (auto, disabled, builtin, find-requires, /path/to/find-requires) as choices with their descriptions, from the Possible values: dash bullets.
  • mandible speedtest lists the formats printed in its Valid output formats: line (human-readable (default), csv, tsv, json, jsonl, json-pretty) as the values of -f, --format ((default) kept as printed) and the Machine readable formats ... line after it is part of its description.
  • A value placeholder keeps the text printed right after it: mandible pnpm install shows --filter <pattern>... and <pattern>^..., snap get shows --with=<param>=<constraint>, dpkg shows -L <package>....
  • mandible ethtool shows each operation's description and its setting rows (-s|--change lists [ speed %d ] [ duplex half|full ] ...), keeps the 15 operations after -Q (--cable-test, --set-pse, --monitor, ...), and no longer lists EEPROM, RSS, EEE, PHY, FEC and FUNC as operands; --groups offers eth-phy, eth-mac, eth-ctrl, rmon.
  • mandible ssh-keygen shows -h and -U as two flags, not -h with a value U; the same for the two-letter groups of iscsiadm, nfsidmap, preconv and ssh-agent: a glued two-letter group is two switches when the help writes every flag value after a space.
  • mandible linux-version shows compare with VERSION1 OP VERSION2 and sort with optional repeatable VERSION1 VERSION2: numbered upper-case operands of a command's own usage form are read when the same stem recurs with another number.
  • mandible linux-version lists compare, sort and list as commands, with --reverse under sort and --paths under list: usage forms that print the program as /usr/bin/linux-version are read like the bare name.
  • mandible linux-version, fragiso and git worktree no longer repeat their commands' operands and flags on the parent page when every usage form names a command.
  • mandible jfr lists print as a command with its own flags (--xml, --json, --stack-depth), not as the root usage whose flags sat on jfr itself.
  • mandible git log shows its second usage form as printed (git show [<options>] <object>...), not as log git show ....
  • mandible corepack disable and corepack enable show their --install-directory flag: the General commands heading now attests its rows, so their own help pages are read.
  • Prose after the usage line and a blank line is part of the description: mandible automake opens with Generate Makefile.in for configure from Makefile.am., jq and find show their intro paragraphs (Default path is the current directory; default expression is -print.).
  • mandible cd keeps the paragraph after its options (The default is to follow symbolic links ...) and shows Exit Status: as its own paragraph.
  • mandible jfr configure shows the option=value and event-setting=value rows and the Options for default.jfc: keys as description text, not as operands and flags, with the paragraph after them and the wizard and example blocks.
  • A heading word is never the description: mandible xdg-open reads xdg-open - opens a file or URL in the user's preferred application, not Synopsis (ping and tracepath no longer show Usage).
  • Probes run in a scratch directory under ~/.cache/mandible instead of /tmp, so a tool that searches upward for project files (pnpm start --help runs the nearest package.json) can no longer be handed a file another local user planted in /tmp.
  • An existing ~/.cache/mandible is tightened to mode 0700, and probes are refused when it is a symlink, not a directory, or owned by another user, so no other local user can plant files above a probe.
  • When ~/.cache/mandible cannot be created (for example an unwritable HOME), mandible <tool> exits with a one-line reason instead of opening an empty page.
  • A subcommand whose help answer is only the tool's own error is no longer shown as its page (mandible pnpm start, test and exec no longer print [ERR_PNPM_NO_IMPORTER_MANIFEST_FOUND] No package.json ... was found); t still shows it.
  • A root help that says 'git help -a' ... list available subcommands is asked that listing, so mandible git gains every command it lists (remote, stash, worktree, bundle open their own pages) and none of the concept guides.
  • pnpm's and snap's root help point to pnpm help -a and snap help --all, so mandible pnpm gains 27 commands its short list omits (patch, licenses, runtime, self-update, ...) and mandible snap lists all 67 commands with their groups; mandible pnpm shows store and cache with their listed subcommands.
  • Usage forms that each open with a different verb name that command's subcommands, each with its own usage, flags and operands (mandible git bisect lists start, good, bad, run; git stash, remote, worktree, bundle, reflog, commit-graph likewise).
  • A usage flag written --term-(new|bad)=<term>, (-m | --message) <message> or --update-refs=(branches|head) is read as the flags and value it spells (the value keeps its printed (branches|head)), not as a fabricated --term- (new or a value ).
  • A subcommand whose help answer says the word is not a command (git citool where git-gui is not installed) is shown as unreadable, not as help listing the did-you-mean suggestion as a child.
  • Flags in usage synopses keep their own values on git's verb pages: git worktree add --lock and --reason, -b/-B <new-branch>, git remote set-head -a, --mirror=<fetch|push>, reflog expire --single-worktree, and git shortlog no longer gets git log's --pretty.
  • A flag whose spelling overruns its table's description column keeps its description (mandible git clone's --[no-]reject-shallow, git rm's --[no-]ignore-unmatch; capsh, clang, gzip, run-parts, tar).
  • A value spec nested several levels deep is kept as printed (mandible git diff's --stat[=<width>[,<name-width>[,<count>]]], strace --tips, lspci -s, fzf-tmux -p).
  • -NUM is one option, not -N with the value UM, when its description names NUM (mandible grep, git grep).
  • The ( and ) rows of git grep's option table are flags, and the flags after them leave the group named ).
  • A value written (+|-)x is shown whole (mandible git add's --chmod).
  • A punctuation short option beside its long one is one option (mandible nano's -%, --stateflags and -_, --minibar).
  • A value of two plain words keeps both (mandible jq's --arg name value, --slurpfile name file).
  • An option table whose rows are wrapped in brackets, [-keystore <url>] keystore location, shows every option with its value and description (mandible jarsigner, c++filt, krb5-config).
  • -verbose[:suboptions] is one option with an optional value, not -v (mandible jarsigner).
  • A table headed by a usage operand's name lists the values of the flag that names it, with each description (mandible krb5-config's --libs and its Libraries: table).
  • A list of values grouped by label under a heading that names a flag keeps every value, the label as each one's description (mandible speedtest's -u, which lost auto-binary-bits).
  • An llvm =<empty> choice is listed as a choice named <empty>, and each =value choice keeps its description (mandible llc-18's --profile-correlate, llvm-ar-18's --format).
  • A Possible values: list of * name: text bullets is the flag's choices with their descriptions (mandible batcat's --style and --nonprintable-notation).
  • A flag-led example line under a description's one can use: stays in that description instead of opening extra rows (mandible rg's --type-add, which lost the text after its examples).
  • A bare -NUM row is the numeric option even when its description does not repeat NUM (mandible git archive's -NUM, which read as -N with value UM).
  • The [<options>] after a flag in a usage line is the option-list word, not that flag's value (mandible git diff's --no-index).
  • A single usage form's bracketed operands are kept: mandible find shows path... and expression, uconv its file ..., tcpdump its expression, pod2man input and output.
  • An operator-precedence block (find's Operators (decreasing precedence ...)) is shown in the description instead of being dropped.
  • A shell builtin's help (`cd: cd [-L|[-P [-e]]] [-@] ...
Read more

v0.8.3

Choose a tag to compare

@github-actions github-actions released this 07 Oct 09:22
v0.8.3
ec287bd

Release Notes - Version 0.8.3

Install

Homebrew (macOS or Linux)

brew install as-foss/mandible/mandible

Fedora / EPEL (COPR repository)

sudo dnf copr enable as-foss/mandible
sudo dnf install mandible

Nix

nix run github:AS-FOSS/mandible

Cargo

cargo binstall mandible
cargo install mandible

Debian and Ubuntu: the signed apt repository carries every released version for amd64 and arm64, with setup instructions.

Or download a binary below. Verify with the accompanying .sha256.


Fixed

  • A wrapped description line that begins with a flag spelling (-U/--multiline flag.) continues its description instead of opening a row (mandible rg loses about 27 fabricated flag rows, pod2man's --center).
  • Single-dash words such as -Bdynamic, -dy, -call_shared, -Bsymbolic and -Tbss ADDRESS are options of their own, not -B or -T with a value (mandible ld, gold, #102).
  • A list of <tool> <word> ... command rows over their descriptions is the command list, not the usage (mandible corepack gains disable and cache clean, and its usage is $ corepack <command>). Each command shows its own invocation line as usage.
  • A syntax legend (Probe specifier syntax:, Where:) is shown in the description instead of becoming choices of unrelated flags (mandible argdist-bpfcc's -H, -I).
  • An indented example command line ending in a backslash stays in its flag's description (mandible rg's --color and --hyperlink-format examples).
  • A usage row [-n|--notable|--table {<table>|<table_file>}] is two flags, -n|--notable and --table with its value (mandible dmsetup's create).
  • A usage line that names the command and then its aliases (brew search, -S [options] ...) shows as printed instead of with the command's name prepended again (mandible brew's search, info, update).
  • A comma row of independent long options that the help documents again as rows of their own keeps only the spellings it alone documents (mandible ld's --warn-constructors row, #102).
  • A command row whose description starts one space after its operands, at its table's column, is a subcommand (mandible systemctl gains set-property, mount-image, service-log-target).
  • A grid of file names under Files automatically distributed if found: is no longer the choices of --force-missing: it reads in the description (mandible automake; #102).
  • A heading's key=<placeholder> rows are dashless flags with their choices or value (mandible jfr configure: gc, locking-threshold <timespan>, ...).
  • A =FILE row closing a flag's sub-option table is its value form, not a choice: its text joins the flag's description instead of becoming a bare FILE choice (mandible as, -a; #102).
  • A choices block under a heading that names the plural of a flag's value (Warning categories include: for -W, --warnings=CATEGORY) belongs to that flag, not the last one (mandible automake, autoconf, autom4te, autoreconf; #102), and a block under a heading naming a flag's long spelling (Languages include:) is that flag's choices, quoted names included (mandible autom4te).
  • A key=value word in a usage line is an operand: mandible jfr configure shows option=value and event-setting=value with their descriptions.
  • A <no option> row describes the bare invocation and joins the description instead of vanishing (mandible jinfo).
  • A single-dash word that a usage line spells on two or more lines is one option, not a short flag with a fabricated value (mandible cgi-fcgi's -connect, -start, -bind; mandible jarsigner's -verify).
  • A single-dash row whose value is a glued run of placeholders keeps the whole value, and same-spelling rows keep their own (mandible jinfo's -flag [+|-]<name> and -flag <name>=<value>).
  • The operands that close a usage form are read per form, and an operand missing from some forms is no longer required (mandible ssh-keygen gains output_file and file ..., mandible sg_test_rwbuf's SZ is optional, awk gains file ...).
  • A flag that opens several usage forms with a different lowercase word each time owns those words as choices (mandible ssh-keygen's -Y gets sign, verify, find-principals, match-principals, check-novalidate; -M gets generate, screen).
  • A synopsis bracket [-t dsa | ecdsa | rsa] gives -t those words as choices instead of only the first (mandible ssh-keygen's -t, tcpdump's -Q).
  • A description that ends in a labelled value list (available formats: ...) gives its flag those values as choices (mandible grub-mkimage's --format, grub-install's --target, mksquashfs's -Xbcj).
  • A synopsis above an Example usage: label stays the usage, so a help <word> page's flag rows reach their node (mandible jfr's configure and metadata).
  • A line after a backslash-ended line is that line's continuation, never a flag row (mandible jpackage's sample usages, update-xmlcatalog's repeated --id).
  • A one-line banner on stdout no longer hides the real help on stderr (mandible bzless, mandible bzmore show bzip2's 23 flags instead of a ------ flag).
  • A row -u <username> -p <password> reads as two flags instead of -u with the description -p <password> (mandible pastebinit).
  • A wrapped usage line whose continuation opens with a flag at the hanging indent stays one synopsis (mandible pptpsetup gains --delete, --password, --encrypt, --start; mandible ssh-keygen's -Y verify form is whole).
  • A usage form that names one flag and ends in prose gives the flag that prose as its description (mandible vim and mandible nvim describe -t and -q).
  • A flag row whose description starts one space after its value, at the table's column, keeps that description (mandible tcpretrans.bt and the other bpftrace scripts --include, mandible nstat --interval, mandible Xvfb -pixdepths).
  • A usage line that repeats the first form's program word starts its own form (mandible tcpretrans.bt shows three forms and the filename operand).
  • A one-line description indented under the usage form leaves the usage text and heads the description (mandible ranlib gains the archive operand).
  • -COLUMN, --columns=COLUMN is one spelling -COLUMN with value COLUMN, not an invented -C (mandible pr).
  • A +FIRST_PAGE[:LAST_PAGE], --pages=... row is a flag with both spellings (mandible pr's --pages).
  • A command-table row with no flag keeps its [<options>] operand (mandible dmsetup's stats).
  • A usage line brew search, -S [options] ... no longer gives -S the invented value options (#163, mandible brew).
  • A pipe-joined alias group with its description one space after (-? | -h | --help | -help to print this help message) is one value-free flag with its description (mandible jinfo).
  • A spaced-slash alias row (-W / --warn [LINT]) is one flag carrying both spellings and its real value (mandible cargo-clippy's -W, -A, -D, -F).
  • The second -T row of a column-aligned table keeps its own description (mandible lsof's -T fqs TCP/TPI Fl,Q,St (s) info).

v0.8.2

Choose a tag to compare

@github-actions github-actions released this 04 Oct 20:31
v0.8.2
e3ad5e4

Release Notes - Version 0.8.2

Install

Homebrew (macOS or Linux)

brew install as-foss/mandible/mandible

Fedora / EPEL (COPR repository)

sudo dnf copr enable as-foss/mandible
sudo dnf install mandible

Nix

nix run github:AS-FOSS/mandible

Cargo

cargo binstall mandible
cargo install mandible

Debian and Ubuntu: the signed apt repository carries every released version for amd64 and arm64, with setup instructions.

Or download a binary below. Verify with the accompanying .sha256.


Fixed

  • A block printed repeatedly under one heading (ffplay, ffprobe AVOptions, rg, jpackage) shows each identical row once.
  • The usage synopsis [--] merges into the described -- row (lsof, tree, awk, getopt) instead of adding a second one.
  • Rows after a flag's nested choice table stay under their emulation heading (ld's --no-apply-dynamic-relocs, -z force-bti, -z pac-plt under aarch64elf:).
  • A flag that one help text prints in several sections keeps every row on screen after the background refill (mandible ffplay shows 1136 flags instead of 558, mandible lsof shows -T twice).
  • A single-dash row that no usage line names reads as a boolean with its whole row as the description, instead of a value guessed from its first word (mandible host's -A, -s, -U, -4, -6).
  • A value or operand spelled as an alternation of angle placeholders keeps every alternative (mandible numastat's -p <PID>|<pattern>, mandible dmsetup's load).
  • A -1 .. -9 row reads as nine flags instead of -1 with value .. (mandible savelog, mandible bzip2, mandible xz, mandible streamzip).
  • A trailing file ... operand behind valued flag groups or a wrapped usage line reaches the tree (mandible savelog, mandible eqn, mandible chattr, mandible xfs_copy).
  • A usage operand takes its description from a name - text table row (mandible savelog's file).
  • A --name row that mirrors a -name row no longer vetoes a single-dash-long table, so two-letter spellings keep their names (mandible ffplay's -ss, -fs, -an, -vf).
  • A two-word lowercase placeholder closed by a column gap is the value name (mandible ffplay's -window_title window title, -loop loop count, -left x pos).
  • A plus-or-minus row (+|-w, +f|-f, +|-r [t[m<fmt>]]) is one flag carrying both +x and -x spellings with the row's own description (mandible lsof's -e, -f, -L, -M, -r, -w).
  • A packed multi-column row reads +X and -- cells as cells of their own and keeps each cell's value placeholder out of its description (mandible lsof's +c, +d, +D, +m, --, -c c; mandible unzip's -O CHARSET).
  • An AVOptions row takes its <type> token as the value name and keeps the capability column out of the description (mandible ffplay's -framerate, -linespeed).
  • An AVOptions row whose only text is the capability column keeps it as the description (mandible ffplay's -ch_layout, -srtp_in_suite).
  • An AVOptions-shaped row never becomes a choice of the flag above its section: mandible ffplay's libdc1394 -framerate no longer carries 1348 AVFilter option names, and those options show as dashless flags in their own AVFilter AVOptions:-style groups with their values.
  • mandible dmsetup keeps create's -m|--minor beside -j|--major, shows resume's --addnodeonresume and --addnodeoncreate as two flags, and remove, suspend, resume, wipe_table, rename and dmstats create keep their trailing operands (device..., new_name_or_uuid, file_path).
  • mandible chattr shows its [-+=aAcCdDeijPsStTuFx] mode as an operand instead of a fabricated -+ flag.
  • A value-free -c or --copyright text... row is one flag with both spellings and its own description instead of -c taking the word or as a value (mandible icupkg's -c, #142).
  • A value placeholder keeps its comma-list tail (--dhcp-range=<ipaddr>,..., --dhcp-pxe-vendor=<vendor>[,...], --shared-network=<iface>|<addr>,<addr>) instead of showing only the first part (mandible dnsmasq, mandible dpkg, mandible pmap).
  • A trailing operand behind a [--] marker or alone on a wrapped usage line reaches the tree, and a name text table row describes it (mandible lsof's names, mandible icupkg's infilename and outfilename).
  • A [[--] program args...] usage group is an optional separator then positional operands, and the -- program args row describes program instead of being a flag (mandible lldb-server gdbserver).
  • A subcommand that a tool's help names by invocation line gains its flags and descriptions when the same help prints <tool> help <COMMAND>, by asking <tool> help <word> (mandible brew install shows its 50 flags, #163).
  • A headed block of undescribed <tool> <word> invocation lines names its words as subcommands, listed but never probed (mandible brew's search, info, install, update, upgrade, uninstall, list, config, doctor, create, edit, commands, help, #163).
  • A value placeholder whose angle group holds a space keeps the whole group (mandible dnsmasq's --dhcp-mac=set:<tag>,<mac address>, mandible as's -mabi=<abi name>).

Contributors

v0.8.1

Choose a tag to compare

@github-actions github-actions released this 02 Oct 17:28
v0.8.1
ea11ef1

Release Notes - Version 0.8.1

Install

Homebrew (macOS or Linux)

brew install as-foss/mandible/mandible

Fedora / EPEL (COPR repository)

sudo dnf copr enable as-foss/mandible
sudo dnf install mandible

Nix

nix run github:AS-FOSS/mandible

Cargo

cargo binstall mandible
cargo install mandible

Debian and Ubuntu: the signed apt repository carries every released version for amd64 and arm64, with setup instructions.

Or download a binary below. Verify with the accompanying .sha256.


Added

  • --allow-root lets mandible run as root; without it, the TUI, --doctor, and --report refuse before probing anything when effective uid is 0.

Fixed

  • An S-167 node's own USAGE line no longer doubles its name in front of text that already named the tool and the subcommand (mandible lldb-server into gdbserver).
  • A -- end-of-options row whose value is a bare multi-word phrase keeps every word instead of the first (mandible lldb-server gdbserver's -- program args).
  • A node's own short-prefix alias now renders as an alias: line in the detail pane (mandible lldb-server gdbserver shows alias: g).
  • A usage line's [options] no longer refuses a bare operand tail unless the tail word names a real command-table placeholder, so mandible lcf shows dest_file/src_dir and mandible ranlib shows archive.
  • pkcheck's -d, --details=KEY VALUE row keeps KEY VALUE as the value name instead of just KEY (mandible pkcheck).
  • A nested bracket group's own trailing text after its outer close now glues onto the value name too (mandible cpio's -I/-O, lsusb's -s, rustc's -l).
  • A single-dash table row with no placeholder column now reads its flag's real value off the tool's own usage line instead of guessing it from the description's first word (mandible host, mandible kpartx, mandible numastat, mandible savelog, mandible memhog); mandible memhog also gains its size/policy/nodeset positionals (S-177) instead of a swallowed root description.

v0.8.0

Choose a tag to compare

@github-actions github-actions released this 13 Sep 14:43
v0.8.0
87f062b

Release Notes - Version 0.8.0

Summary

This update brings extensive improvements to the help-text parsing engine, significantly hardening how single-dash long options, positional arguments, choice alternations, and command tables are handled across diverse tools like mksquashfs, Xvfb, rustc, nix, and qemu. It also refines the xtask contributor auditing workflow and removes the legacy deprecated-flag visibility toggle in favor of consistent inline tagging.

Install

Homebrew (macOS or Linux)

brew install as-foss/mandible/mandible

Fedora / EPEL (COPR repository)

sudo dnf copr enable as-foss/mandible
sudo dnf install mandible

Nix

nix run github:AS-FOSS/mandible

Cargo

cargo binstall mandible
cargo install mandible

Debian and Ubuntu: the signed apt repository carries every released version for amd64 and arm64, with setup instructions.

Or download a binary below. Verify with the accompanying .sha256.


Changed

  • Contributor Auditing: cargo xtask audit contribute now draws tool names off PATH prior to probing, sampling only drawn tools instead of freezing and classifying the entire PATH upfront. Verdict files also record machine and containment posture (#102).

Removed

  • Deprecated Toggle: Removed the . hidden/deprecated toggle along with the underlying show_hidden configuration state. Deprecated flags now consistently display a (deprecated) tag.

Fixed

Parsing Engine & Usage Synopsis

  • Single-Dash Long Options & Case Sensitivity:

    • Single-dash long options with uppercase letters or mixed casing (e.g., g++'s -Xassembler, mksquashfs's -noI, -Xstrategy) retain their full names and case rather than truncating to single-letter flags.
    • Preserved tab-separated and bare-word value placeholders on single-dash long options in tables lacking -- flags (e.g., mksquashfs, sqfstar, Xvfb).
    • Single-dash long options inside usage line brackets (e.g., lshw's -format, fuser's -SIGNAL) retain full spellings instead of splitting into short flags with fabricated values.
  • Choices, Alternations & Values:

    • Delimited value alternations (e.g., --compression=(xz|none|auto), {c,java,ruby,tcl}) now attach as explicit flag choices instead of opaque placeholders (e.g., grub-mkimage, rustc).
    • Glued bracket-optional groups on required angle placeholders (e.g., -L's [<KIND>=]<PATH> and --emit's <TYPE>[=<FILE>]) are preserved intact (rustc).
    • Value specs with swallowed trailing commas (e.g., -p, --pcts) no longer hide subsequent flag aliases (biolatpcts-bpfcc).
    • Colon-introduced choice lists directly beneath placeholder rows map cleanly as flag choices (Xvfb).
    • Repeated flags across invocation forms now collapse into a single placeholder with unioned choice lists (e.g., lvcreate's --type).
  • Positionals & Bracket Parsing:

    • Nested bracket groups in usage lines no longer incorrectly fuse words into a single operand name (e.g., uniq, env), while flat groups (e.g., mknod) remain unified.
    • Bracketed multi-word ALL-CAPS operands (e.g., gdk-pixbuf-thumbnailer, mknod) parse to exact positional counts rather than splitting per word.
    • Numbered positional sequences (e.g., file1 [file2 ...]) collapse into single repeatable positionals (apt-sortpkgs, apt-mark).
    • Positionals preceding required operands (e.g., mksquashfs's source1 source2 ...) are correctly retained alongside primary operands.
  • Subcommands & Command Tables:

    • Recovered command tables sitting directly under root usage synopses as subcommands with dedicated flags/operands rather than root flag groups (e.g., dmsetup, dmstats).
    • Parsing lowdown man-page formatted help outputs now extracts subcommands and flags correctly (recovering 30 subcommands and 9 flags for nix).
    • Command tables using short-alias-comma rows (i, install) no longer drop tables or invent subcommands from wrapped descriptions (pnpm).
    • Usage lines with bracketed optional-abbreviation suffixes (e.g., v[ersion]) now parse as distinct subcommands with alias tracking (lldb-server).
  • Plus-Prefixed Flags & Complex Rows:

    • +word options and +/--name/[+-]name alternation rows now expand to explicit +name and -name entries with shared choices and values (fzf, Xvfb).
    • Multi-column table headers specifying Argument, Env-variable, and Description now parse at exact column offsets without fabricating flags from prose (qemu-*-static).
  • Layout & Noise Cleanup:

    • Trailing usage labels alone on a line no longer swallow underlying option blocks (fdisk, pkcheck, dmsetup, npm).
    • Option-rejection diagnostics emitted by probed tools are filtered out of root descriptions (fuser, nfsidmap).
    • Suppressed redundant root flag groups and headingless tables that duplicated the tool's primary description (fc-scan, Xvfb).
    • Subcommands showing prefixed program names inside usage lines now render cleanly under the tool's own name (gcc-ranlib-13, perlthanks).
  • Bullet List Wrapping:

    • Bulleted list descriptions (* NAME - VALUE) no longer split at inline dashes into multiple lines per item (e.g., rustc's --emit).

Testing & Internal Tools

  • Subcommand Diffing: xtask sweep-diff now measures and reports subcommand-count gains and losses independently from flag counts.
  • Detector Calibration: xtask detector calibrate prints NOT EVALUABLE instead of DOES NOT PASS when evaluating detector families with zero seed samples.

Contributors

  • @Stiven-Gjekaj — #139 test(tui): state the glyph set instead of reading it from the locale
  • @2gn — reported #138 lix (nix) renders incorrectly

v0.7.0

Choose a tag to compare

@github-actions github-actions released this 05 Sep 20:45
v0.7.0
4c607d2

Release Notes - Version 0.7.0

Summary

This release introduces a new interactive auditing tool for contributors and delivers a massive update to the help-text parsing engine. Across the fleet, dozens of parsing edge cases have been resolved, including correct handling of command headings with placeholders, nested docopt brackets, comma-glued values (e.g., -Wa,<options>), and +-prefixed flags. The UI has also been refined to handle duplicated parent-child help text more elegantly and improve USAGE section soft-wrapping.

Install

Homebrew (macOS or Linux)

brew install as-foss/mandible/mandible

Fedora / EPEL (COPR repository)

sudo dnf copr enable as-foss/mandible
sudo dnf install mandible

Nix

nix run github:AS-FOSS/mandible

Cargo

cargo binstall mandible
cargo install mandible

Debian and Ubuntu: the signed apt repository carries every released version for amd64 and arm64, with setup instructions.

Or download a binary below. Verify with the accompanying .sha256.


Added

  • Contributor Auditing: Added cargo xtask audit contribute, an interactive workflow that walks contributors through auditing mandible against their locally installed tools—handling login, random 20-tool draws (excluding already audited tools), review, and verdict file generation (see CONTRIBUTING.md §2).
  • Smart Ancestor Deduplication: Subcommands whose --help output is a byte-for-byte repetition of their parent command now render a clean description, accepted modifiers, and a notice explaining that t shows the live text, eliminating walls of duplicated raw text (e.g., mandible ar operations r/m/q/t/x).

Fixed

UI & Display

  • Flag Alignment: The detail pane now strictly displays a flag's short spelling before its long one (-d, --decode, never --decode, -d), maintaining visual alignment mid-list.
  • Usage Wrapping & Cleanup: The detail pane's USAGE section now soft-wraps at the pane width instead of forcing horizontal scrolling. It also correctly suppresses internal continuation markers (or:) and doubled tool names (e.g., mandible cp, mandible ar).
  • Inherited Confidence Status: A same-as-ancestor node's status bar now correctly displays same as parent rather than an inaccurate low confidence: 0% parsed.

Parsing Engine & Usage Synopsis

Placeholders & Operands:

  • Recognized command headings followed by argument placeholders (e.g., start UNIT...) now parse correctly as commands with the placeholder retained as a usage line.
  • Blocks directly beneath usage lines that define positional descriptions now properly map to the positionals (e.g., invoke-rc.d).
  • Usage line operands with glued repetition dots ([file...]) are now correctly marked as repeatable, matching standard spaced dots.
  • Trailing runs of two or more operands on a usage line are all captured with their respective optionality and repetition, instead of truncating after the first (e.g., mandible xfs_mkfile, mandible nft).
  • Flags documented exclusively on a usage line (e.g., vim ... -q [errorfile]) now correctly retain their associated operands in the tree.

Complex Flag Shapes:

  • Bare end-of-options markers (--) now successfully reach the parsed tree from both option tables and usage lines (e.g., mandible cargo-fmt, mandible awk).
  • Plus-prefixed option rows (e.g., +, +<lnum>) are no longer dropped when listed beside standard - flags (e.g., mandible vim).
  • Single-dash spellings glued directly to a comma (e.g., -Wa,<options>) parse as standalone flags with the comma correctly attached to the value, rather than truncating to -W (e.g., mandible gcc).
  • Flags completely composed of # characters (e.g., -###) parse natively instead of truncating to -#.
  • Flags containing underscores (--extended_fields) are no longer prematurely truncated with fabricated value names.

Bracket & Parentheses Groups:

  • Double glued bracket groups (-V[N][fname]) and nested bracket groups (-e[CHAR[WIDTH]]) now retain all closing brackets and aliases instead of dropping text at the first closing bracket.
  • Parenthesized spelling qualifiers (-r (with file name)) are safely split: the qualifier names the value where applicable and moves the rest to the description, avoiding truncation.
  • Docopt bracket rows with trailing |-separated choice lists (e.g., --units [Number]r|R|h|...) now correctly attach the choices to the flag instead of discarding them (e.g., mandible pvdisplay and the LVM2 family).

Aliases & Formatting:

  • Generic dashed placeholder tokens in usage lines ([-options]) no longer fabricate short flags with glued value names.
  • Unheaded, heavily indented worked-example lines no longer fold into the preceding flag's description (e.g., mandible nfsslower-bpfcc).
  • Descriptions containing enumerated lists folded into a single paragraph (0 -> ... 1 -> ...) now correctly start a new line at each item, while ignoring standard numeric ranges.
  • Tools that document aliases on separate rows (e.g., mandible icupkg's three -t, --type rows) or joined by the word or (-h or -?) now properly merge into a single flag or retain independent descriptions, rather than fabricating descriptions from the second alias.
  • Spellings duplicated across both the usage line and the option row (e.g., mandible date's --universal) no longer create duplicate nodes.
  • Prose sentences hard-wrapping onto a dash-led word no longer fabricate phantom flags (e.g., mandible zgrep).
  • Usage continuations that spell the tool as a full path (/usr/bin/ar) or append or to a line now correctly open new usage forms instead of corrupting the current block.

Contributors

v0.6.1

Choose a tag to compare

@github-actions github-actions released this 01 Sep 00:58
v0.6.1
144a099

Release Notes - Version 0.6.1 (0.6.0 + crates.io fix)

Install

Homebrew (macOS or Linux)

brew install as-foss/mandible/mandible

Fedora / EPEL (COPR repository)

sudo dnf copr enable as-foss/mandible
sudo dnf install mandible

Nix

nix run github:AS-FOSS/mandible

Cargo

cargo binstall mandible
cargo install mandible

Debian and Ubuntu: the signed apt repository carries every released version for amd64 and arm64, with setup instructions.

Or download a binary below. Verify with the accompanying .sha256.


Fixed

  • cargo install mandible can reach 0.6.x again: the mandible binary crate failed to publish at 0.6.0 (the four library crates went through) because its --shell-init snippets lived under the repo's packaging/shell/, outside the crate root, and cargo publish verifies the build from the packaged tarball, which can only carry files under the crate — the snippets now live in mandible/shell/ inside the crate, and CI packages the whole workspace on every PR so a file referenced from outside its crate fails there rather than at the registry.

v0.6.0

Choose a tag to compare

@github-actions github-actions released this 01 Sep 00:33
v0.6.0
a16abb9

Release Notes - Version 0.6.0

Install

Homebrew (macOS or Linux)

brew install as-foss/mandible/mandible

Fedora / EPEL (COPR repository)

sudo dnf copr enable as-foss/mandible
sudo dnf install mandible

Nix

nix run github:AS-FOSS/mandible

Cargo

cargo binstall mandible
cargo install mandible

Debian and Ubuntu: the signed apt repository carries every released version for amd64 and arm64, with setup instructions.

Or download a binary below. Verify with the accompanying .sha256.


Added

  • mandible llvm-ar now shows its OPERATIONS: table (d, m, p, q, r, s, t, x) as subcommands instead of dropping it: the heading says "operations" rather than "commands", which spec §7 Tier B rule 1's recognized-heading vocabulary is extended to accept as the same kind of evidence, since an operation letter is an invocation verb exactly the way a subcommand name is — ar's own equivalent table was unaffected because its heading already says "commands".

  • mandible bpftrace/mandible node/mandible fzf now show a tool's own documented environment variables (BPFTRACE_BTF, NODE_DEBUG, FZF_DEFAULT_COMMAND, …) in an ENVIRONMENT section of their own: recovered only from a row under an explicitly labeled environment heading (ENVIRONMENT:, Environment variables:, …), never scavenged from ALL_CAPS words in prose or usage placeholders like PATH/FILE/TERM — a tool that documents its env vars only in its man page correctly gets no ENVIRONMENT section here.

  • mandible ar now shows the seventeen single-letter modifiers ar documents ([a], [D], [l <text> ], …) in a MODIFIERS section of their own, instead of dropping every one of them: a modifier is a letter typed glued to an operation letter rather than a flag or a subcommand, so it was recognized as neither — and ar's own command specific modifiers: heading contains the word "command", which sent its rows to the subcommand path to be discarded one by one for not looking like command names. The recognizer reads the row, not the heading (a bracket, exactly one letter, an optional operand, then a real separator and a description, twice in a row), so llvm-ar's differently formatted MODIFIERS: table is read by the same rule with nothing keyed on either tool, and a bracketed reference footnote is refused as one.

  • mandible cargo clippy now opens cargo's tree at clippy instead of failing with "unexpected argument 'clippy' found" (issue #70): a trailing subcommand path is valid and lands exactly where browsing to that node lands, and a subcommand the parent's own help never documents — the cargo-clippy/git-lfs convention — is discovered as an executable named <tool>-<sub> on PATH, shown as a child marked unverified (a filename is evidence about the filesystem and a guess about the tool) and probed against its own binary, so a word read off a filename never becomes an argument to the parent; a path the finished tree turns out not to have is reported in the status line beside the real names rather than refused before the tool opens, and --doctor/--report still take a tool name alone.

  • Browsing can now end on the shell prompt instead of in the clipboard (issue #40): mandible --print-selection <tool> browses exactly as usual but makes Enter print the selected command — plus the flag search landed on, in its long spelling where the tool documents one and always in the affirmative form (--color, never the un-runnable --[no-]color) — to stdout and exit, drawing the UI on stderr so stdout carries that one line and nothing else, and mandible --shell-init bash (or zsh) prints the binding that puts it on the command line ready to edit: Ctrl-X m opens mandible on the word already typed and replaces the line with what you select, leaving it untouched if you quit instead. Without the flag nothing moves — Enter is still one of the three keys that expand a row.

  • Shell completion now offers tool names where mandible expects a tool: the TOOL positional and the values of --doctor and --report complete to the commands on $PATH, so mandible gi<TAB> proposes git rather than the contents of the current directory. Delivered by the existing --completions <shell> generator, so every packaging channel picks it up with no per-channel file; zsh and fish carry it today, while bash keeps its previous filename fallback because clap_complete's ahead-of-time bash generator has no command-name completion to emit.

  • xtask coverage's #fp fingerprint footer now covers every EntityKind (flags, positionals, modifiers, and env-var items) instead of flags alone, keyed generically off the kind enum so a future entity kind needs no edit to the fingerprint writer or reader — ar's 17 modifiers and bpftrace's env vars, previously invisible to xtask sweep-diff, now register as field-level gains or losses; the wire format is versioned (#fp2, the old #fp lines still read as V1) because the two use differently-shaped entity identities, and sweep-diff now refuses outright, naming the mismatch, rather than silently misjoin a V1 scoreboard against a V2 one.

  • mandible's --help parser now keeps every alias a flag row documents instead of only the first short and first long spelling it recognized (issue #30's emission half): tar --help's -A, --catenate, --concatenate keeps all three; jdeprscan/jmod/lsof's -?, -h, --help keep all three; dpkg's --no-act, --dry-run, --simulate keeps all three. A tool's own -r[esolve]-style abbreviation bracket (a prefix a user may type, glued to the rest of the word it abbreviates — one letter or more, short or long dashes: ip's -r[esolve]/-rc[vbuf], --br[ief]) is now read as one spelling naming the full word, rendered back exactly as documented, rather than either discarding the bracket or misreading it as a fabricated value. mandible ffplay's (and ffmpeg's, ffprobe's) own -h topic / -? topic / -help topic / --help topic — the same issue's primary example, four physical rows for one option — now recovers -help's own topic value instead of leaving it a valueless boolean: -help's value is restored only when a run-mate sharing its description already carries the value cleanly and the raw document still contains -help topic as a literal phrase, never invented from a shared description alone (an early version of this fix also merged such rows into one multi-spelling entity; a full-PATH sweep found that too readily fired on unrelated flags sharing boilerplate commentary — as's -w/-X, both "ignored"; lto-dump's -C/-CC, both "[disabled]", repeated 505 times in that one document — so the merge was dropped and only the narrower, evidence-anchored value recovery ships). -h and --help still unify through the existing short/long alias pairing (spec §4.4); -? and -help are correctly separate entities.

  • Search now finds positionals, modifiers, and environment variables, not just flags: typing ar's modifier description or bpftrace's BPFTRACE_BTF in the search box selects the tool and scrolls the detail pane to that entity's own row in its POSITIONALS/MODIFIERS/ENVIRONMENT section, exactly as a flag match already scrolled to FLAGS; the default name-search mode now finds any of these by a word-prefix match on its spelling (d finds a modifier named d, debug finds NODE_DEBUG) rather than admitting entities only in the wider, everything-matches mode.

Changed

  • Corpus fixture format: expected.snap's per-flag short/long/negatable/single_dash keys are replaced by one spellings key holding every documented spelling, rendered and in document order (e.g. ["-h", "--help"], ["--[no-]color"]) — the fixture-visible half of the Entity/Spelling migration landing its snapshot format; every committed fixture was reblessed in the same change, with the mapping (short first, then the long-like form with its dashes/[no-] notation) verified fixture-by-fixture against the pre-change snapshots.

  • The detail pane no longer appends a flag's choices to its description as [a, b, c]; they now render as their own values: a, b, c line under the description, indented two columns past the shared description column in the pane's derived-metadata style, so the description stays the tool's own prose and a placeholder like tar --format's FORMAT keeps the spelling column verbatim.

  • A flag's choices now carry their own per-value description when the tool documents one, instead of smearing it into the flag's own description or dropping it outright: mandible ffplay's -flags row used to fold ffmpeg's whole AVOption sub-table (unaligned, gray, bitexact, …) into -flags' own description as one run-on sentence, and mandible tar's --format/--backup enum values silently lost the one-line explanation next to each — both now render as a values: header followed by one indented name description row per choice.

Fixed

  • mandible ar's descriptions no longer start with a stray - on some rows and not others: ar writes - as the column separator on every row of its tables, and the parser stripped it only on rows whose name overran the column (--target=BFDNAME - specify …) while leaving it on aligned rows (--thin - make a thin archive, @<file> - read options from <file>), so one table rendered two ways; a lone - token opening the description side is now stripped whichever way the column was found, in every tool with that table style.

  • mandible ffplay's -? topic row keeps the space between spelling and value again: the argfile sigil's glued rendering (@<file>) keyed on "first character is not alphanumeric", which also matches the dashed s...

Read more