.local-bin/docs/manwhere/Usage.md
2026-02-09 14:06:08 -05:00

1.7 KiB

manwhere

A compiled binary tool for finding different types of man pages.

Description

manwhere searches across man page sections to find documentation for commands, library functions, system calls, and more. It provides advanced filtering capabilities by section number and includes verbose output options.

Usage

manwhere [options] <keyword>

Options

  • -h, --help: Show help message
  • -v, --verbose: Enable verbose output with paths and timing
  • -s, --section NUM: Only show results from section NUM (1-9)
  • --paths: Show full paths to man pages

Man Page Sections

Section Description
1 User commands (executable programs or shell commands)
2 System calls (functions provided by the kernel)
3 Library calls (functions within program libraries)
4 Special files (usually found in /dev)
5 File formats and conventions
6 Games
7 Miscellaneous (including macro packages and conventions)
8 System administration commands
9 Kernel routines (non-standard)

Examples

# Find all man pages mentioning "sleep"
manwhere sleep

# Find only commands (section 1) mentioning "sleep"
manwhere -s 1 sleep

# Detailed search with paths and timing
manwhere -v --paths ssl

# Find only library functions (section 3) for printf
manwhere --section 3 printf

Platform

macOS and Linux - Compiled binary (Mach-O 64-bit for macOS ARM64)

Notes

  • This is a compiled binary tool (not a shell script)
  • The binary searches across all installed man page sections by default
  • Use section filtering to narrow down results to specific types of documentation
  • Verbose mode is useful for debugging man page location issues