Check if a roff line is a section header (.SH or .Sh) matching name.

Check if filename is under a standard man page directory. Matches manned.org's is_standard_man_location() logic. Prefers man pages installed

the parser may leave a remainder at the end of the string if it doesn't match any of the rules, mark them as unknowns

True if the stored row matches any of the (mode, model) filter specs.

Build the Responses API input message list.

Top-pad the shorter screenshot with white pixels so both PNGs share the same dimensions. Lets the comparison slider clip cleanly without the

Normalise a paragraph dict so text is a plain string.

Parse a YYYY-MM-DD release date into a sortable tuple. Missing or malformed dates (\\N, empty, non-ISO) collapse to (0, 0, 0) so they always

If *content* is a pure .so redirect, return the target path; else None.

>>> _parse_synopsis('/a/b/c', '/a/b/c: "p-r+o++g - foo bar."') ('p-r+o++g', 'foo bar')

Process a single provider batch: submit -> poll -> collect -> finalize. Never raises for normal batch/file failures — returns FAILED entries

POST one SQL statement to Better Stack ClickHouse, return JSONEachRow rows.

Convert a (YYYY, MM, DD) tuple to UTC epoch seconds. Missing dates (0, 0, 0) collapse to 0, matching the gzip ``mtime=0`` convention for "no

Resolve a .so target string to an actual .gz file under *root*. Handles two formats: - "man<N>/<name>.<N>" → root/<N>/<name>.<N>.gz

return a mapping of `MatchResult`s to their index among all matches, sorted by the start position of the `MatchResult`

Rewrite a symlink *target* for the destination directory layout. Returns the (possibly rewritten) target string, or ``None`` if the symlink s

Run lexgrog on a man page and return the raw synopsis string. Raises FileNotFoundError if the file does not exist, and RuntimeError if lexgro

Print the prefilter classification for each file; no extraction, no writes.

Configure stderr logging only — no run dir, no file handler.

Union of hot tier + s3 archive, restricted to the lookback window. Hot tier retains ~25 min; s3 covers everything older. UNION ALL plus the s

Last-resort split: cut at line boundaries to fit budget.

>>> _substitution_markup('foo') '<a href="/explain?cmd=foo" title="Zoom in to nested command">foo</a>' >>> _substitution_markup('cat <&3'

Insert or replace a RawManpage into the manpages table.

Benchmark the IN (...) query used by _discover_manpage_suggestions.

One place to assemble synopsis, aliases, and detection metadata.

One place to build RawManpage with SHA256. ``mandoc_path`` identifies the mandoc binary used for the extraction and is resolved into ``genera

Manage the explainshell manpage database.

Download all dump files from manned.org.

Extract man pages from the downloaded dump files.

Return three lists of src values for benchmarking. - single_dst: src values that map to exactly 1 destination (common case) - multi_dst: src

Compare two ParsedManpage objects and return a list of structured diff entries. Each entry is a dict with: - "type": "field" | "option_chan