Яка різниця між документацією "людина" та "інформація"?


92

Щодо довідкових документів та інформаційної довідкової інформації:

Чому існують два подібних джерела документації?
Іноді доступна довідкова сторінка, а інформації немає; або навпаки.
Я ще не причепився до рими та розуму, що стоїть за цим.

Можливо, між ними є значна різниця, але навіть якщо є, чому вони обидва існують? Здається, непотрібне подвоєння.


1
GNU-Info Погано, людина (1) Добре від смішного читання 2003 року. Flat is better than nested.
n611x007

Спробуйте робити info infoі man info. man infoпоказує барвисті приклади. Я більш візуальна людина, використання одного і того ж кольору робить мене сонним. Синтаксис людини з невеликим кольором робить його зрозумілим швидко.
randomin substanceOfLivingThing

Відповіді:


80

Сторінки людини - це традиційний спосіб поширення документації про програми UNIX. Сам термін "man page" є скороченням "manual page", оскільки вони відповідають сторінкам друкованого посібника; "розділи" підручних сторінок (1 для команд, 2 для системних викликів тощо) відповідають розділам у повному посібнику UNIX. Підтримка все ще існує, якщо ви хочете роздрукувати чоловічу сторінку на папері, хоча це рідко робиться в наші дні, і велика кількість довідкових сторінок унеможливлює зв'язати їх усіх в одну книгу.

На початку 90-х проект GNU вирішив, що система документації "man" є застарілою, і написав команду info для її заміни: інформація має основні функції гіперпосилання та більш просту мову для розмітки (порівняно з системою "troff", що використовується для сторінки людини). Крім того, GNU виступає проти взагалі використання підручних сторінок і стверджує, що складні програмні системи повинні мати повну і вичерпну документацію, а не просто набір коротких сторінок.

Насправді використовуються інші системи документації, окрім людини та інформації : GNOME та KDE мають власну систему на базі HTML тощо.

Зрештою, форма, в якій ви отримуєте документацію, залежить від внутрішньої політики проекту, який надав програмне забезпечення в першу чергу - загальновизнаного стандарту немає.


14
infoніколи насправді не знімав, чи не так?
UncleZeiv

9
@UncleZeiv: запустіть infoбез параметрів, щоб отримати уявлення про те, скільки додатків використовують документацію у форматі інформації.
JanC

24

Інформація - це стандартний формат документації в рамках проекту GNU, людина - набагато старший традиційний формат для UNIX.

Інформація використовує Texinfo як вихідний формат, який є купою макросів для TeX, і це значно спрощує створення «гарних» друкованих версій або PDF-файлів.

Як правило, підручники - це приблизно одна конкретна тема (команда, конфігураційний файл, системна функція, ...), в той час як інформація зазвичай має більше структури комбінованого посібника, більше схожого на книгу.


14

man використовує менше для відображення сторінки вручну, яка, в свою чергу, використовує прив'язки клавіш vim, в той час як інформація використовує прив'язки клавіш emacs і стандартні команди emacs для пошуку, виходу з програми тощо.


3
Випуск клавіатурних infoзв'язків цікавий (тому я гуглив) ... Схоже, є опція VI клавіатурних зв'язків: --vi-клавіші (Використовуйте vi-подібні та менш схожі клавіші) ... $ alias info = 'info - vi-ключі '... можливо?
Пітер.О
Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.