Це залежить від людини сторінок ... Традиційно, вони були включені в розділі з прикладами - але з якоїсь - то причини , що, як правило , відсутні в людино - сторінках під Linux (і я вважаю , інші з допомогою команд GNU - які більшість в ці дні). Що стосується Solaris, з іншого боку, майже кожна людина містить розділ Приклад, часто з кількома прикладами.
Якби я здогадувався, FSF / GNU вже давно не зважає на використання man
сторінок і вважає за краще користувачів використовувати інформацію для документації. info
сторінки , як правило, більш всеосяжним , ніж людина сторінок, і , як правило , дійсно включають в себе приклади. info
сторінки також є більш "актуальними" - тобто пов'язані команди (наприклад, команди для пошуку файлів) часто можна зустріти разом.
Іншою причиною може бути те, що GNU та його man
сторінки використовуються у багатьох різних операційних системах, які можуть відрізнятися одна від одної (адже між різними Linux-дистрибутивами існує багато відмінностей). Можливо, видання видав приклади, що стосуються конкретної ОС / дистрибутива - що, очевидно, робиться рідко.
Я також додам, що man
сторінки ніколи не мали на меті "навчати початківців". UNIX був розроблений комп'ютерними експертами (старий термін "хакери") і призначений для використання комп'ютерними експертами. Сторінки "man" не були створені для навчання новачка, а для швидкої допомоги комп'ютерному експерту, який потребував нагадування про якусь незрозумілу опцію або дивний формат файлу - і це відображається в тому, як розділяється сторінка "man".
man
-сторінки призначені як
- Швидкий довідник для оновлення пам’яті; показує вам, як слід викликати команду, та перелічує доступні параметри.
- Глибокий і ретельний - і, як правило, дуже технічний - опис усіх аспектів команди. Це написано комп'ютерними експертами, для колег-комп'ютерних експертів.
- Список змінних середовища та файлів (тобто файлів конфігурації), що використовуються командою.
- Посилання на іншу документацію (наприклад, книги) та інші
man
сторінки - наприклад. для формату файлів конфігурації та пов'язаних / подібних команд.
З цього man
приводу я дуже згоден з вами, що сторінки повинні мати приклади, оскільки вони можуть пояснити використання краще, ніж переходити через саму сторінку. Занадто погані приклади, як правило, недоступні на man
сторінках Linux ...
Зразок частини прикладу сторінки чоловіка Solaris - zfs (1M):
(...)
ПРИКЛАДИ
Приклад 1 Створення ієрархії файлової системи ZFS
Наступні команди створюють файлову систему з назвою pool / home
і файлова система з назвою pool / home / bob. Точка кріплення
/ експорт / додому встановлено для батьківської файлової системи та є
автоматично успадковується дочірньою файловою системою.
# zfs створює пул / дім
# zfs set mountpoint = / експорт / домашній пул / домашній
# zfs створює пул / дім / bob
Приклад 2 Створення знімка ZFS
Наступна команда створює знімок, названий вчора.
Цей знімок встановлюється на вимогу у .zfs / snapshot
каталог у корені файлової системи pool / home / bob.
# zfs Знімок пул / home / bob @ вчора
Приклад 3 Створення та знищення декількох знімків
Наступна команда створює знімки, названі вчора
пул / дім та всі його спадкові файлові системи. Кожен
Знімок встановлюється на вимогу в каталозі .zfs / snapshot
в корені його файлової системи. Друга команда знищує
новостворені знімки.
# zfs знімок -r басейн / home @ вчора
# zfs знищити -r басейн / home @ вчора
SunOS 5.11 Остання зміна: 23 липня 2012 року 51
Команди системного адміністрування zfs (1М)
Приклад 4 Вимкнення та включення стиснення файлової системи
Наступна команда відключає властивість стиснення для
(...)
Ця конкретна сторінка людини містить 16 (!) Таких прикладів ... Кудос Соляріс!
(І я визнаю, що я в основному дотримувався цих прикладів, замість того, щоб прочитати всю сторінку чоловіка для цієї команди ...)