Как найти документацию в моей собственной системе GNU / Linux

Многие из новичков в мире GNU / Linux они полны сомнений и не могут найти быстрый ответ на свои проблемы, иногда у них даже нет соединения, через которое можно получить доступ к форуму поддержки, и в конечном итоге они приходят к мысли, что Linux очень труден для них.

Большинство из тех, кто оказался в этой ситуации, не знают, что наша собственная система содержит значительную часть ответов на наши первоначальные проблемы. По сути, в системе есть три источника документации. GNU / Linux: справочные страницы (страницы руководства), информационные страницы (информационные страницы) и руководства приложений, упакованных в / usr / share / doc.

В этой статье мы подробно рассмотрим каждый из этих источников.

---

Страницы руководства

Страницы руководства или «страницы руководства» - это классические формы справочной документации в Linux и Unix. В идеале вы можете искать справочные страницы по любой команде, файлу конфигурации или библиотечной процедуре.

На практике Linux - это бесплатное программное обеспечение, и некоторые страницы не написаны и не показывают их возраст. Однако страницы руководства - это первое место, куда нужно обращаться, когда вам нужна помощь. Чтобы получить доступ к страницам руководства, просто введите человек а затем тема для исследования.

Будет запущен пейджинг, вы нажмете q когда закончу читать. Например, чтобы найти информацию о команде ls, Я бы написал:

$ мужчина лс

Зная части страниц руководства, может быть полезно быстро перейти к нужной вам информации, вы найдете следующие разделы на странице руководства (вставка 1):

Таблица 1: Страницы руководства

ИМЯ	Название и описание команды
СИНТАКСИС	Как пользоваться командой
ОПИСАНИЕ	Подробное объяснение того, как работает команда
ПРИМЕРЫ	Предложения по использованию команды
СМОТРИТЕ ТАКЖЕ	Связанные темы (обычно на страницах руководства)

Разделы страниц руководства

Файлы, составляющие страницы руководства, хранятся в / usr / share / человек (или в / usr / человек на некоторых старых системах). В этом каталоге вы обнаружите, что справочные страницы организованы в следующие разделы (вставка 2).

Таблица 2: Разделы справочных страниц

man1	Пользовательские программы
man2	Системные вызовы
man3	Библиотечные функции
man4	Специальные файлы
man5	Формат файла
man6	Игры
man7	Сборник

Несколько страниц руководства

Некоторые темы существуют более чем в одном разделе. Чтобы продемонстрировать это, мы воспользуемся командой что такое, который показывает все справочные страницы, доступные для этой темы:

$ что такое printf

printf (1) - форматирование и печать данных

printf (3) - преобразование форматированного вывода

В этом случае, мужчина printf он будет на странице в разделе 1 (Пользовательские программы). Если бы мы писали программу на C, нас бы больше интересовала страница в разделе 3 (Функции библиотеки). Вы можете вызвать определенный раздел страниц руководства, указав его в командной строке, чтобы запросить Printf, мы можем написать:

$ человек 3 printf

Поиск правильной страницы руководства

Иногда бывает сложно найти несколько страниц руководства по заданной теме. В этом случае вы можете использовать человек -k чтобы найти раздел NAME на страницах руководства. Знайте, что это поиск подстроки, поэтому что-то вроде человек -k ls даст вам много результатов, вот пример с более конкретным словом:

$ man -k whatis whatis (1) - печатает описания страниц руководства

Все по поводу

Предыдущий пример принес нам еще несколько моментов. Во-первых, команда по поводу в точности эквивалентен человек -k, (Вообще-то, я открою вам секрет. Когда вы запустите человек -k на самом деле запустить по поводу за кулисами).

---

Строка кода MANPATH

Теперь перейдем ко второму типу документации, которую мы найдем в нашей системе GNU / Linux. По умолчанию программа man ищет страницы руководства в / usr / share / man, / usr / местные / человек, / usr / X11R6 / человек и, возможно, / opt / man. иногда вы можете найти то, что вам нужно, добавив дополнительный путь к пути поиска. В таком случае просто отредактируйте /etc/man.conf в текстовом редакторе и добавьте строку, подобную следующей:

MANPATH / opt / man

С этого момента любая страница руководства в каталоге / opt / man будет найден. Помни, тебе нужно снова бежать приготовить чтобы добавить эти новые страницы руководства в базу данных что такое.

---

Информация о GNU

Одним из недостатков справочных страниц является то, что они не поддерживают гипертекст, поэтому вы не можете легко переходить с одной страницы на другую. Друзья GNU признают этот недостаток, поэтому они изобрели другой формат документации: «информационные» страницы.

Многие программы GNU поставляются с обширной документацией в формате информационной страницы. Вы можете начать чтение информационных страниц с помощью команды info:

Таким образом мы составим указатель всех информационных страниц, доступных в системе. Вы можете перемещаться по ним с помощью клавиш со стрелками, переходить по «ссылкам» (обозначенным звездочкой) с помощью клавиши Enter и выходить, нажимая q. Клавиши основаны на Emacs, поэтому вам будет легко ориентироваться, если вы знакомы с этим редактором.

Для получения дополнительной информации с использованием infoпрочтите их информационную страницу. Вы должны иметь возможность перемещаться по ним с помощью клавиш, упомянутых выше:

$ info информация

---

/ usr / share / doc

Есть еще один последний источник, который может помочь вам в системе Linux. Многие программы поставляются с дополнительной документацией в других форматах: текст, PDF, PostScript, HTML и многие другие.

Взгляни на / usr / share / doc (/ usr / doc в старых системах). Вы найдете длинный список каталогов, каждый из которых поставляется с приложениями в вашей системе. Поиск в этой документации часто может обнаружить что-то интересное, например учебные пособия или дополнительную техническую документацию. Быстрая проверка обнаруживает массу материала, доступного для чтения:

$ cd / usr / share / doc

$ найти. -тип f | wc -l

---

В других статьях мы будем ссылаться на внешние источники документации, такие как Проект документации Linux (LDP), списки рассылки и группы новостей.

Источник: статья взята из ГУТЛ и написанный Майкелем Лламаретом Эредиа. Ссылки: https://blog.desdelinux.net, http://www.raybenjamin.com, http://forum.codecall.net, http://www.linfo.org,  http://www.esdebian.org