## [manwhere](../../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

```bash
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

```bash
# 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
