man Generator poleceń

## Co to jest man?

`man` to interfejs do systemowych podręczników referencyjnych („stron man”). Pozwala on na wyszukiwanie i wyświetlanie dokumentacji dotyczącej poleceń, wywołań systemowych, funkcji bibliotecznych, plików konfiguracyjnych i wielu innych elementów. Każdy system Unix zawiera strony man, dzięki czemu `man` jest najszybszym sposobem na poznanie flag i zachowania danej komendy.

## Jak korzystać

1. **Ustaw opcje**: Wybierz sekcję, tryb wyszukiwania (apropos/whatis) lub flagę dopasowania wszystkiego. 2. **Wpisz nazwę**: Zapisz nazwę strony (oraz opcjonalnie numer sekcji). 3. **Skopiuj i uruchom**: Wklej wygenerowaną komendę do swojego terminala.

Wewnątrz narzędzia do przeglądania stron: naciśnij `/`, aby wyszukać, oraz `q`, aby wyjść. Nawigacja po stronach odbywa się za pomocą tych samych klawiszy co w `less`.

### Numer sekcji (`1`, `2`, `3`...) Ogranicz wyszukiwanie do konkretnej sekcji podręcznika. Powszechne sekcje to: `1` polecenia użytkownika, `2` wywołania systemowe, `3` funkcje biblioteki, `5` formaty plików, `8` polecenia administracyjne. Przykład: `man 2 open` pokazuje wywołanie systemowe, a nie jakiekolwiek polecenie `open`.

### `-k` Apropos (wyszukiwanie według słowa kluczowego) Wyszukuj w krótkich opisach wszystkich stron — jest to równoznaczne z `apropos`. Użyj tego, gdy pamiętasz temat, ale nie polecenie: `man -k 'copy'`.

### `-f` Whatis (krótki opis) Wyświetl tylko jednozdaniowy opis strony — jest to równoznaczne z `whatis`. Szybsze niż otwieranie pełnej strony.

### `-a` Wszystkie pasujące strony Pokaż każdą pasującą stronę z każdej sekcji, jedną po drugiej. Przydatne przy nazwach występujących w kilku sekcjach (np. `printf`).

### `-S LIST` Lista sekcji Ogranicz kolejność wyszukiwania do listy sekcji oddzielonych przecinkami, np. `-S 1:2:3`.

### `-P PAGER` Niestandardowy pager Użyj innego programu pagera (takiego jak `bat` lub `cat`) zamiast domyślnego `less`.