Repository navigation
Releases
v0.9.1
Release Notes - Version 0.9.1
Install
Homebrew (macOS or Linux)
brew install as-foss/mandible/mandibleFedora / EPEL (COPR repository)
sudo dnf copr enable as-foss/mandible
sudo dnf install mandibleNix
nix run github:AS-FOSS/mandibleCargo
cargo binstall mandible
cargo install mandibleDebian 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
--helpanswer 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,allafter--help, or a command the text lists;tc,genlandrtmonshow their pages. - A
NAME := { a | b }production behind a usage form's command position (ip [ OPTIONS ] OBJECT { COMMAND | help }) lists that tool's commands, soip,tc,bridge,devlink,rdma,dcbandvdpashow them instead of anOBJECToperand; the braced list after a flag in a production is its values (rtmon -f[amily]); a command whose--helpgives nothing is asked<command> helponce, when the usage form showshelpthere.
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,zstdlessandpagerdraw--tabs=[N[,...]]and--quotes=[c[c]]with the=outside the bracket, as the tool writes them.curl --http0.9,--http1.0,--tlsv1.3and the other names with a dotted number are whole flag names, not a name plus a value, and so arenode --tls-min-v1.2andsetarch --uname-2.6.genlshows{ ctrl etc }as the text of itsOBJECToperand.iplists-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 optionsandtar --ignore-command-errorkeep 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/nosyncreads as--sync, --nosync, and the description ofrescan-scsi-bus.shno longer repeats its flag rows. ucfandlcfshow-d, --debug=[n],-s, --src-dir fooand--state-dir barwith their full descriptions,ucf -p destinationas a second usage form, and-p, --purgeas one flag;lessdraws--pattern=[pattern]as written.java -verbose:[class|module|gc|jni]lists class, module, gc and jni as its values.od,nanoandautom4teshow their description: two spaces after a full stop no longer read as a column gap that drops the paragraph.od -tlists all seven format specifications (d[SIZE],f[SIZE]and the rest), and-j,-N,-Sand-wlist the wholeb,KB,K,MB,Mmultiplier table instead of its first row.javashows its five usage forms, each(to execute ...)note on its own line under its form;jinfoandjstackdraw their note the same way.ip link helpand the pages like it: every form of a multi-form usage block belongs to its verb (includingadd,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 := textlegends describe their placeholder onip macsecandip l2tp(:=dropped,{ none | default }as values),ip l2tp del tunnelanddel sessionare commands ofdel,bridge fdb showis a command ofbridge fdb, a new dash word separates flags indevlink's option production,tcreads{ -cf | -conf } pathas one flag, andgenlno longer listshelpas 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 thevalues:line, which sits on the flag's own row when it has no description, as invgchange --activate,ld --compress-debug-sections,sg_inq --blockandapt-mark's first operand.
Fixed
- A sentence that heads an option table (
Mandatory arguments to long options are mandatory for short options too.oncp,uniq,du,odand others) ends the description instead of being dropped. ffmpegis read fromffmpeg -h full, the most complete help it lists, instead of the basicffmpeg -h.python3no longer repeats its option table as description text.kernel-installlistsadd,add-all,remove,inspectandlistas commands, each with the operands of its own usage form, and shows itsCOMMANDline as the first usage form.elfeditandreadelfshow the sentence under their usage line as description and no longer invent anELFoperand;pngfixshows its description.iplists-iec,-j[son],-p[retty]and-br[ief]as their own flags instead of text on-hand-l[oops], and-l[oops]takes the valuemaximum-addr-flush-attempts.git stashno longer listsdiff-optionsandcommit:git stash showlistsdiff-optionsandgit stash storelistscommit, andstash drop,pop,apply,git bundle verifyandgit remote prunelist the operand their usage form names.mandible jfr configurekeeps the line breaks and indentation of theoption=value,event-setting=valueandOptions for default.jfc:rows in its description.chmodlistsMODE[,MODE]...,OCTAL-MODEandFILE...,msgexecitsCOMMAND-OPTIONandsotrussitsEXECUTABLE-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, andsetterm --ulcolorand--hbcolorkeep[bright] <color>as their value ([S-259]). - An
Example usage:block of the tool's own command lines (jfr configure ...) is listed underEXAMPLESinstead 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 -helpare one flag,ebtables'[!]rows read, andless's-<flag>key is no flag, onjava,dpkg-deb,nvim,less,ebtablesand 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, onless,tcandnvim -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, onip6tables-translate. - Flag rows read whole:
ld's-EB,-Map FILE/DIR,-fini SYMBOLand-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 ...]andnl'spBREchoice. - Usage-line operands now reach the tree for
[option...] [mapfile...],COMMAND [INITIAL-ARGS]...,operation [count],type#[source] destination [-t type]andxfsdev | dir | file ...;option(s)is no longer an operand, andupdate-ca-certificatesshows its two flags.
v0.9.0
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/mandibleFedora / EPEL (COPR repository)
sudo dnf copr enable as-foss/mandible
sudo dnf install mandibleNix
nix run github:AS-FOSS/mandibleCargo
cargo binstall mandible
cargo install mandibleDebian 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.
- Seven built-in themes:
default,light(for light terminals),high-contrast,gruvbox-style,nord-style,dracula-styleandcatppuccin-style. - Your own colours: choose
customand set each of the seven colours yourself. Step through the 256 terminal colours with←/→, or pressEnterand 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
--helpview, scroll long lines sideways, show long descriptions as a preview, use ASCII glyphs, and the starting sort order for flags and commands. NO_COLORandMANDIBLE_ASCIIstill win over the file. A setting they decide is shown dimmed, with the variable's name next to it.- A mistake in
config.tomlcosts only that one line. Everything else still applies, and the footer names the line until you press a key. mandible mandiblenow uses your theme's colours too.
Search, rebuilt
- Every word, in any order.
no verifyfinds--no-verify,sizefinds--blocksize, and a dash is just a character, so--no-squashfinds--[no-]squash. - A suggestion as you type. A dim hint shows where
Enterwill land.Tabtakes it. nandpstep 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.
Entergoes to the best match: an exact name first, then names that start with what you typed./rebasenow lands ongit rebase. - When nothing matches, the list says
No matches for "…"and the cursor goes back to where it was. Escin 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.
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.
Moving around
PgUp/PgDnmove ten rows in the commands list and a screenful on the page.Home/Endjump 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.
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.
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.
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).
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:
- A page with nothing beyond its summary says so and tells you to press
tto 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
dockercommands, 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
- 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
ror opening the raw view withtno 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
rtries again with two minutes.--doctorand--reporttake--no-timeoutto wait as long as needed. - A slow command shows the same page on every launch.
git filter-branchused 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.
rreloads 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
⋯ loadingfor good.
Parser fixes
krb5-configlists its library names under theLIBRARIESoperand instead of under--libs.- A usage line that names another program, like
bpftrace [options] filenameundertcpretrans.bt, is shown as printed. - A value written
--log-file=[PATH]is read as an optional valuePATH. - 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. Sethorizontal_scroll = trueinconfig.tomlto get sideways scrolling back. That one setting now covers both views. - The
?pop-up closes withEscor?.
The full list of changes is in the CHANGELOG.
v0.8.4
Release Notes - Version 0.8.4
Install
Homebrew (macOS or Linux)
brew install as-foss/mandible/mandibleFedora / EPEL (COPR repository)
sudo dnf copr enable as-foss/mandible
sudo dnf install mandibleNix
nix run github:AS-FOSS/mandibleCargo
cargo binstall mandible
cargo install mandibleDebian 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_checkand more than 100 other tools show no description line where the help prints only a heading (a heading likeManagement Optionsstays the label of its flags). pnpmand its subcommand pages now show the page's own description first and theVersion 11.22.0line after it, instead of opening with the version.snap getnow shows its description with the three$ snap getexample blocks and their output, which were dropped.mandible jarsignershows-providerArg <arg>as its own flag, withconfigure argument for -addproviderand... for -providerClass, instead of text inside those two flags' descriptions.mandible cargo-generate-rpm --auto-reqlists its values (auto,disabled,builtin,find-requires,/path/to/find-requires) as choices with their descriptions, from thePossible values:dash bullets.mandible speedtestlists the formats printed in itsValid output formats:line (human-readable (default),csv,tsv,json,jsonl,json-pretty) as the values of-f, --format((default)kept as printed) and theMachine readable formats ...line after it is part of its description.- A value placeholder keeps the text printed right after it:
mandible pnpm installshows--filter <pattern>...and<pattern>^...,snap getshows--with=<param>=<constraint>,dpkgshows-L <package>.... mandible ethtoolshows each operation's description and its setting rows (-s|--changelists[ speed %d ] [ duplex half|full ] ...), keeps the 15 operations after-Q(--cable-test,--set-pse,--monitor, ...), and no longer listsEEPROM,RSS,EEE,PHY,FECandFUNCas operands;--groupsofferseth-phy,eth-mac,eth-ctrl,rmon.mandible ssh-keygenshows-hand-Uas two flags, not-hwith a valueU; the same for the two-letter groups ofiscsiadm,nfsidmap,preconvandssh-agent: a glued two-letter group is two switches when the help writes every flag value after a space.mandible linux-versionshowscomparewithVERSION1 OP VERSION2andsortwith optional repeatableVERSION1 VERSION2: numbered upper-case operands of a command's own usage form are read when the same stem recurs with another number.mandible linux-versionlistscompare,sortandlistas commands, with--reverseundersortand--pathsunderlist: usage forms that print the program as/usr/bin/linux-versionare read like the bare name.mandible linux-version,fragisoandgit worktreeno longer repeat their commands' operands and flags on the parent page when every usage form names a command.mandible jfrlistsprintas a command with its own flags (--xml,--json,--stack-depth), not as the root usage whose flags sat onjfritself.mandible git logshows its second usage form as printed (git show [<options>] <object>...), not aslog git show ....mandible corepack disableandcorepack enableshow their--install-directoryflag: theGeneral commandsheading 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 automakeopens withGenerate Makefile.in for configure from Makefile.am.,jqandfindshow their intro paragraphs (Default path is the current directory; default expression is -print.). mandible cdkeeps the paragraph after its options (The default is to follow symbolic links ...) and showsExit Status:as its own paragraph.mandible jfr configureshows theoption=valueandevent-setting=valuerows and theOptions 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-openreadsxdg-open - opens a file or URL in the user's preferred application, notSynopsis(pingandtracepathno longer showUsage). - Probes run in a scratch directory under
~/.cache/mandibleinstead of/tmp, so a tool that searches upward for project files (pnpm start --helpruns the nearestpackage.json) can no longer be handed a file another local user planted in/tmp. - An existing
~/.cache/mandibleis 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/mandiblecannot be created (for example an unwritableHOME),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,testandexecno longer print[ERR_PNPM_NO_IMPORTER_MANIFEST_FOUND] No package.json ... was found);tstill shows it. - A root help that says
'git help -a' ... list available subcommandsis asked that listing, somandible gitgains every command it lists (remote,stash,worktree,bundleopen their own pages) and none of the concept guides. - pnpm's and snap's root help point to
pnpm help -aandsnap help --all, somandible pnpmgains 27 commands its short list omits (patch,licenses,runtime,self-update, ...) andmandible snaplists all 67 commands with their groups;mandible pnpmshowsstoreandcachewith 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 bisectlistsstart,good,bad,run;git stash,remote,worktree,bundle,reflog,commit-graphlikewise). - 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- (newor a value). - A subcommand whose help answer says the word is not a command (
git citoolwhere 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 --lockand--reason,-b/-B <new-branch>,git remote set-head -a,--mirror=<fetch|push>,reflog expire --single-worktree, andgit shortlogno longer getsgit 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). -NUMis one option, not-Nwith the valueUM, when its description namesNUM(mandible grep,git grep).- The
(and)rows ofgit grep's option table are flags, and the flags after them leave the group named). - A value written
(+|-)xis shown whole (mandible git add's--chmod). - A punctuation short option beside its long one is one option (
mandible nano's-%, --stateflagsand-_, --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--libsand itsLibraries: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 lostauto-binary-bits). - An llvm
=<empty>choice is listed as a choice named<empty>, and each=valuechoice keeps its description (mandible llc-18's--profile-correlate,llvm-ar-18's--format). - A
Possible values:list of* name: textbullets is the flag's choices with their descriptions (mandible batcat's--styleand--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
-NUMrow is the numeric option even when its description does not repeatNUM(mandible git archive's-NUM, which read as-Nwith valueUM). - 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 findshowspath...andexpression,uconvitsfile ...,tcpdumpitsexpression,pod2maninputandoutput. - An operator-precedence block (
find'sOperators (decreasing precedence ...)) is shown in the description instead of being dropped. - A shell builtin's help (`cd: cd [-L|[-P [-e]]] [-@] ...
v0.8.3
Release Notes - Version 0.8.3
Install
Homebrew (macOS or Linux)
brew install as-foss/mandible/mandibleFedora / EPEL (COPR repository)
sudo dnf copr enable as-foss/mandible
sudo dnf install mandibleNix
nix run github:AS-FOSS/mandibleCargo
cargo binstall mandible
cargo install mandibleDebian 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 rgloses about 27 fabricated flag rows,pod2man's--center). - Single-dash words such as
-Bdynamic, -dy, -call_shared,-Bsymbolicand-Tbss ADDRESSare options of their own, not-Bor-Twith a value (mandible ld,gold, #102). - A list of
<tool> <word> ...command rows over their descriptions is the command list, not the usage (mandible corepackgainsdisableandcache 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--colorand--hyperlink-formatexamples). - A usage row
[-n|--notable|--table {<table>|<table_file>}]is two flags,-n|--notableand--tablewith its value (mandible dmsetup'screate). - 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'ssearch,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-constructorsrow, #102). - A command row whose description starts one space after its operands, at its table's column, is a subcommand (
mandible systemctlgainsset-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
=FILErow 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 bareFILEchoice (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=valueword in a usage line is an operand:mandible jfr configureshowsoption=valueandevent-setting=valuewith 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-keygengainsoutput_fileandfile ...,mandible sg_test_rwbuf'sSZis optional,awkgainsfile ...). - A flag that opens several usage forms with a different lowercase word each time owns those words as choices (
mandible ssh-keygen's-Ygetssign,verify,find-principals,match-principals,check-novalidate;-Mgetsgenerate,screen). - A synopsis bracket
[-t dsa | ecdsa | rsa]gives-tthose 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 ahelp <word>page's flag rows reach their node (mandible jfr'sconfigureandmetadata). - 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 bzmoreshow bzip2's 23 flags instead of a------flag). - A row
-u <username> -p <password>reads as two flags instead of-uwith the description-p <password>(mandible pastebinit). - A wrapped usage line whose continuation opens with a flag at the hanging indent stays one synopsis (
mandible pptpsetupgains--delete,--password,--encrypt,--start;mandible ssh-keygen's-Y verifyform is whole). - A usage form that names one flag and ends in prose gives the flag that prose as its description (
mandible vimandmandible nvimdescribe-tand-q). - A flag row whose description starts one space after its value, at the table's column, keeps that description (
mandible tcpretrans.btand 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.btshows three forms and thefilenameoperand). - A one-line description indented under the usage form leaves the usage text and heads the description (
mandible ranlibgains thearchiveoperand). -COLUMN, --columns=COLUMNis one spelling-COLUMNwith valueCOLUMN, 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'sstats). - A usage line
brew search, -S [options] ...no longer gives-Sthe invented valueoptions(#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
-Trow of a column-aligned table keeps its own description (mandible lsof's-T fqs TCP/TPI Fl,Q,St (s) info).
v0.8.2
Release Notes - Version 0.8.2
Install
Homebrew (macOS or Linux)
brew install as-foss/mandible/mandibleFedora / EPEL (COPR repository)
sudo dnf copr enable as-foss/mandible
sudo dnf install mandibleNix
nix run github:AS-FOSS/mandibleCargo
cargo binstall mandible
cargo install mandibleDebian 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,ffprobeAVOptions,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-pltunderaarch64elf:). - A flag that one help text prints in several sections keeps every row on screen after the background refill (
mandible ffplayshows 1136 flags instead of 558,mandible lsofshows-Ttwice). - 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'sload). - A
-1 .. -9row reads as nine flags instead of-1with 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 - texttable row (mandible savelog'sfile). - A
--namerow that mirrors a-namerow 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+xand-xspellings with the row's own description (mandible lsof's-e,-f,-L,-M,-r,-w). - A packed multi-column row reads
+Xand--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-framerateno longer carries 1348 AVFilter option names, and those options show as dashless flags in their ownAVFilter AVOptions:-style groups with their values. mandible dmsetupkeepscreate's-m|--minorbeside-j|--major, showsresume's--addnodeonresumeand--addnodeoncreateas two flags, andremove,suspend,resume,wipe_table,renameanddmstats createkeep their trailing operands (device...,new_name_or_uuid,file_path).mandible chattrshows 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-ctaking the wordoras 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 aname texttable row describes it (mandible lsof'snames,mandible icupkg'sinfilenameandoutfilename). - A
[[--] program args...]usage group is an optional separator then positional operands, and the-- program argsrow describesprograminstead 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 installshows 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
Release Notes - Version 0.8.1
Install
Homebrew (macOS or Linux)
brew install as-foss/mandible/mandibleFedora / EPEL (COPR repository)
sudo dnf copr enable as-foss/mandible
sudo dnf install mandibleNix
nix run github:AS-FOSS/mandibleCargo
cargo binstall mandible
cargo install mandibleDebian 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-rootlets mandible run as root; without it, the TUI,--doctor, and--reportrefuse 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-serverintogdbserver). - 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 gdbservershowsalias: g). - A usage line's
[options]no longer refuses a bare operand tail unless the tail word names a real command-table placeholder, somandible lcfshowsdest_file/src_dirandmandible ranlibshowsarchive. pkcheck's-d, --details=KEY VALUErow keepsKEY VALUEas the value name instead of justKEY(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 memhogalso gains itssize/policy/nodesetpositionals (S-177) instead of a swallowed root description.
v0.8.0
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 contributenow draws tool names offPATHprior to probing, sampling only drawn tools instead of freezing and classifying the entirePATHupfront. Verdict files also record machine and containment posture (#102).
Removed
- Deprecated Toggle: Removed the
.hidden/deprecated toggle along with the underlyingshow_hiddenconfiguration 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.
- Single-dash long options with uppercase letters or mixed casing (e.g.,
-
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).
- Delimited value alternations (e.g.,
-
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'ssource1 source2 ...) are correctly retained alongside primary operands.
- Nested bracket groups in usage lines no longer incorrectly fuse words into a single operand name (e.g.,
-
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).
- Recovered command tables sitting directly under root usage synopses as subcommands with dedicated flags/operands rather than root flag groups (e.g.,
-
Plus-Prefixed Flags & Complex Rows:
+wordoptions and+/--name/[+-]namealternation rows now expand to explicit+nameand-nameentries with shared choices and values (fzf,Xvfb).- Multi-column table headers specifying
Argument,Env-variable, andDescriptionnow 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).
- Trailing usage labels alone on a line no longer swallow underlying option blocks (
-
Bullet List Wrapping:
- Bulleted list descriptions (
* NAME - VALUE) no longer split at inline dashes into multiple lines per item (e.g.,rustc's--emit).
- Bulleted list descriptions (
Testing & Internal Tools
- Subcommand Diffing:
xtask sweep-diffnow measures and reports subcommand-count gains and losses independently from flag counts. - Detector Calibration:
xtask detector calibrateprintsNOT EVALUABLEinstead ofDOES NOT PASSwhen 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
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
--helpoutput is a byte-for-byte repetition of their parent command now render a clean description, accepted modifiers, and a notice explaining thattshows the live text, eliminating walls of duplicated raw text (e.g.,mandible aroperationsr/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 parentrather than an inaccuratelow 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
10BC8
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 pvdisplayand 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, --typerows) or joined by the wordor(-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 appendorto a line now correctly open new usage forms instead of corrupting the current block.
Contributors
- Thanks to @kiliankoe for reporting the pnpm help loop (#114) and to @Daniele-Cangi for the ancestor guard that fixed it (#118).
v0.6.1
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 mandiblecan reach 0.6.x again: themandiblebinary crate failed to publish at 0.6.0 (the four library crates went through) because its--shell-initsnippets lived under the repo'spackaging/shell/, outside the crate root, andcargo publishverifies the build from the packaged tarball, which can only carry files under the crate — the snippets now live inmandible/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
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-arnow shows itsOPERATIONS: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 fzfnow show a tool's own documented environment variables (BPFTRACE_BTF,NODE_DEBUG,FZF_DEFAULT_COMMAND, …) in anENVIRONMENTsection of their own: recovered only from a row under an explicitly labeled environment heading (ENVIRONMENT:,Environment variables:, …), never scavenged fromALL_CAPSwords in prose or usage placeholders likePATH/FILE/TERM— a tool that documents its env vars only in its man page correctly gets noENVIRONMENTsection here. -
mandible arnow shows the seventeen single-letter modifiersardocuments ([a],[D],[l <text> ], …) in aMODIFIERSsection 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 — andar's owncommand 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), sollvm-ar's differently formattedMODIFIERS:table is read by the same rule with nothing keyed on either tool, and a bracketed reference footnote is refused as one. -
mandible cargo clippynow opens cargo's tree atclippyinstead 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 — thecargo-clippy/git-lfsconvention — is discovered as an executable named<tool>-<sub>onPATH, shown as a child markedunverified(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/--reportstill 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 makesEnterprint 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, andmandible --shell-init bash(orzsh) prints the binding that puts it on the command line ready to edit:Ctrl-X mopens 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 —Enteris still one of the three keys that expand a row. -
Shell completion now offers tool names where mandible expects a tool: the
TOOLpositional and the values of--doctorand--reportcomplete to the commands on$PATH, somandible gi<TAB>proposesgitrather 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#fpfingerprint footer now covers everyEntityKind(flags, positionals, modifiers, and env-var items) instead of flags alone, keyed generically off the 5A66 kind enum so a future entity kind needs no edit to the fingerprint writer or reader —ar's 17 modifiers andbpftrace's env vars, previously invisible toxtask sweep-diff, now register as field-level gains or losses; the wire format is versioned (#fp2, the old#fplines still read asV1) because the two use differently-shaped entity identities, andsweep-diffnow refuses outright, naming the mismatch, rather than silently misjoin aV1scoreboard against aV2one. -
mandible's--helpparser 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, --concatenatekeeps all three;jdeprscan/jmod/lsof's-?, -h, --helpkeep all three;dpkg's--no-act, --dry-run, --simulatekeeps 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 (andffmpeg'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 owntopicvalue 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 topicas 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-PATHsweep 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).-hand--helpstill unify through the existing short/long alias pairing (spec §4.4);-?and-helpare correctly separate entities. -
Search now finds positionals, modifiers, and environment variables, not just flags: typing
ar's modifier description orbpftrace'sBPFTRACE_BTFin the search box selects the tool and scrolls the detail pane to that entity's own row in itsPOSITIONALS/MODIFIERS/ENVIRONMENTsection, exactly as a flag match already scrolled toFLAGS; the default name-search mode now finds any of these by a word-prefix match on its spelling (dfinds a modifier namedd,debugfindsNODE_DEBUG) rather than admitting entities only in the wider, everything-matches mode.
Changed
-
Corpus fixture format:
expected.snap's per-flagshort/long/negatable/single_dashkeys are replaced by onespellingskey holding every documented spelling, rendered and in document order (e.g.["-h", "--help"],["--[no-]color"]) — the fixture-visible half of theEntity/Spellingmigration 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
choicesto its description as[a, b, c]; they now render as their ownvalues: a, b, cline 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 liketar --format'sFORMATkeeps the spelling column verbatim. -
A flag's
choicesnow 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-flagsrow used to fold ffmpeg's whole AVOption sub-table (unaligned,gray,bitexact, …) into-flags' own description as one run-on sentence, andmandible tar's--format/--backupenum values silently lost the one-line explanation next to each — both now render as avalues:header followed by one indentedname descriptionrow per choice.
Fixed
-
mandible ar's descriptions no longer start with a stray-on some rows and not others:arwrites-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-? topicrow 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...