To zależy od strony człowieka ... Tradycyjnie, że nie zawiera sekcję z przykładów - ale z jakiegoś powodu, który jest zwykle brakuje stron podręcznika pod Linuksem (i zakładam inny pomocą poleceń GNU - które są w większości te dni). Z drugiej strony w systemie Solaris prawie każda strona podręcznika zawiera sekcję Przykład, często z kilkoma przykładami.
Jeśli miałbym zgadywać, FSF / GNU od dawna zniechęcają do korzystania ze man
stron i wolą, aby użytkownicy zamiast tego używali informacji do dokumentacji. info
stron wydają się być bardziej wszechstronny niż strony podręcznika i zazwyczaj nie zawierają przykłady. info
strony są również bardziej „aktualne” - tzn. powiązane polecenia (np. polecenia do wyszukiwania plików) często można znaleźć razem.
Innym powodem może być to, że GNU i jego man
strony są używane w wielu różnych systemach operacyjnych, które mogą się od siebie różnić (w końcu istnieje wiele różnic między poszczególnymi dystrybucjami Linuksa). Być może wydawca dodał przykłady związane z konkretnym systemem operacyjnym / dystrybucją - co oczywiście jest rzadko wykonywane.
Dodałbym również, że man
strony nigdy nie były przeznaczone do „nauczania początkujących”. UNIX został opracowany przez ekspertów komputerowych (dawne określenie „hakerzy”) i przeznaczony do wykorzystania przez ekspertów komputerowych. Strony podręcznika nie zostały więc stworzone, by uczyć nowicjusza, ale aby szybko pomóc ekspertowi komputerowemu, który potrzebował przypomnienia o jakiejś niejasnej opcji lub dziwnym formacie pliku - i znajduje to odzwierciedlenie w sposobie podziału strony podręcznika.
man
-strony są zatem rozumiane jako
- Szybki przegląd, aby odświeżyć pamięć; pokazując, jak należy wywołać polecenie, i wyświetlając dostępne opcje.
- Dogłębny i dokładny - i zazwyczaj bardzo techniczny - opis wszystkich aspektów polecenia. Jest napisany przez ekspertów komputerowych, dla innych ekspertów komputerowych.
- Lista zmiennych środowiskowych i plików (tj. Plików konfiguracyjnych) używanych przez polecenie.
- Odniesienia do innej dokumentacji (np. Książek) i innych
man
stron - np. dla formatu plików konfiguracyjnych i powiązanych / podobnych poleceń.
To powiedziawszy, bardzo się z tobą zgadzam, że man
strony powinny mieć przykłady, ponieważ mogą one lepiej wyjaśnić użycie niż brodzenie przez samą stronę podręcznika. Szkoda, że przykłady na ogół nie są dostępne na man
stronach systemu Linux ...
Przykład przykładowej części strony podręcznika Solaris - zfs (1M):
(...)
PRZYKŁADY
Przykład 1 Tworzenie hierarchii systemu plików ZFS
Następujące polecenia tworzą system plików o nazwie pool / home
oraz system plików o nazwie pool / home / bob. Punkt montowania
/ export / home jest ustawiony dla nadrzędnego systemu plików i ma wartość
automatycznie dziedziczone przez podrzędny system plików.
# zfs create pool / home
# zfs set mountpoint = / export / home pool / home
# zfs create pool / home / bob
Przykład 2 Tworzenie migawki ZFS
Następujące polecenie tworzy migawkę o nazwie wczoraj.
Ta migawka jest montowana na żądanie w .zfs / snapshot
katalog w katalogu głównym systemu plików pool / home / bob.
# zfs snapshot pool / home / bob @ wczoraj
Przykład 3 Tworzenie i niszczenie wielu migawek
Następujące polecenie tworzy migawki o nazwie wczoraj
pool / home i wszystkie jego potomne systemy plików. Każdy
migawka jest montowana na żądanie w katalogu .zfs / snapshot
w katalogu głównym systemu plików. Drugie polecenie niszczy
nowo utworzone migawki.
# migawka zfs -r pool / home @ wczoraj
# zfs destroy -r pool / home @ wczoraj
SunOS 5.11 Ostatnia zmiana: 23 lipca 2012 r. 51
Polecenia administracji systemu zfs (1M)
Przykład 4 Wyłączanie i włączanie kompresji systemu plików
Następujące polecenie wyłącza właściwość kompresji dla
(...)
Ta konkretna strona podręcznika zawiera 16 (!) Takich przykładów ... Uznanie dla Solaris!
(I przyznaję, że sam najczęściej podążałem za tymi przykładami, zamiast czytać całą stronę podręcznika dla tego polecenia ...)