#3189·visidata

Missing man page in v3.4 homebrew install

Author: edwardsnjdCreated Jul 24, 2026Updated Aug 17, 2026
Labelsbug

Small description

Man page seems to be missing (from man vd outside or g Ctrl-H inside)

Data to reproduce

N/A

Steps to reproduce

  1. Open vd
  2. Try to open "Quick reference"
    • Help > Quick reference menu item OR
    • g Ctrl-H binding OR
    • sysopen-help long command

Expected result

Shows the UNIX man page.

Actual result with screenshot

From command line: No man page found

Image

From inside visidata: Left on a blank sheet + when you quit the terminal shows a line about the missing man page

ImageImage
bash
$ ls /opt/homebrew/Cellar/visidata/3.4/libexec/lib/python3.14/site-packages/visidata/man/
parse_options.py

Configuration

  • Does this issue reproduce without any plugins or configuration (using the -N CLI flag)?

    • Yes, same error.
  • Does this issue reproduce with either the latest release, or with the develop branch?

    • Sorry, not tested. Can I do this from homebrew install?

Additional context

  • What platform and version are you using (Linux, MacOS, Windows)?

    • MacOS
    • Installed from homebrew
    • vd --version -> saul.pw/VisiData v3.4
  • Which version of Python?

    • Looks like bundled 3.14.

      bash
      $ ls -l $(which vd)
      lrwxr-xr-x 1 ... .... 29 Jul 24 09:43 /opt/homebrew/bin/vd -> ../Cellar/visidata/3.4/bin/vd
      $ ls /opt/homebrew/Cellar/visidata/3.4/libexec/lib
      python3.14
  • Which terminal are you using (for display and input issues)?

    • Replicated on Ghostty, iTerm2, and Terminal.app.