Документация, поставляемая с Mandrake Linux

Собственная документация Mandrakesoft

В этом разделе представлен список всей документации, которая создана MandrakeSoft для текущего релиза:

  • Наши обновленные онлайновые версии ищите на: страницах документации.

    Если во время инсталляции вы выбрали группу документации, тогда, выбрав в главном меню пункт Читать документацию, вы найдете всю доступную документацию на тех языках, которые вы выбрали в процессе инсталляции.

  • Стартовое руководство пользователя;

    Это руководство предназначено для того, чтобы глубже познакомить вас с Mandrakelinux. В нем содержатся основные темы для начинающих пользователей GNU/Linux, а также расширенные инструкции по процедурам настройки основных элементов.

  • Справочное руководство;

    Доступное в он-лайн и в Mandrake Linux –– PowerPack ProSuite Edition™, данное руководство затрагивает вопросы расширенной работы в GNU/Linux и системного администрирования.

Страницы руководств (man pages)

Они являются первичным источником получения информации на каждый день. Практически все команды имеют соответствующие им страницы руководств. Некоторые конфигурационные файлы, функции библиотек для программистов и другие также имеют свои собственные страницы руководств.

Их содержимое располагается по различным секциям. Ссылки на эти секции сделаны следующим образом: например, open(2), fstab(5) соответственно ссылаются на страницу open в разделе 2 и страницу fstab в разделе 5.

Чтобы почитать страницу руководства, напишите man. Синтаксис команды следующий:

man [options] [section] <manual page>

Для самой man доступна команда man man. Страницы руководств форматированы и по умолчанию отображаются с помощью пейджера less.

Названия страниц руководств и относящихся к ним разделов отображаются в начале каждой страницы. В конце даются ссылки на другие разделы, имеющие отношение к теме (в общем случае это раздел SEE ALSO).

Вы можете начать с изучения страниц, относящихся к различным командам, которые встречаются в этом руководстве: ls(1), chmod(1), и т.д.

Если вы не можете найти подходящую станицу руководства, например, вы хотите использовать в одной из своих программ функцию mknod, но застряли на странице команды mknod, тогда проверьте, правильно ли вы указали раздел. В нашем примере: mknod(2). Если вы забыли, как правильно указать раздел, тогда man -a mknod пробежится по всем разделам и поищет страницы с названием mknod.

Страницы Info

Страницы info дополняют документацию, включенную в страницы руководств. Команда для доступа к страницам info это info.

Страницы info имеют древовидную структуру, верхушка которой называется dir. С этого места вы можете добраться до любой из страниц info.

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

info emacs

В страницах info:

* Buffers::

будет показывать ссылку. Перемещение курсора на эту ссылку (используя клавиши со стрелками) и нажатие Enter приведет вас к нужной странице info.

Вы можете использовать следующие сочетания клавиш:

  • u: это Up (вверх), переместит вас на один уровень выше;

  • n: это Next (далее), для перехода на следующую страницу info на том же самом уровне древовидной структуры;

  • p: это Prev (назад), вернет вас на предыдущую страницу info.

  • q: это Quit (выйти), для выхода из просмотрщика страницы info.

Список множества команд можно получить, написав «?».

HOWTOs

HOWTOs, опубликованные проектом TLDP (The Linux Documentation Project) и доступные на многих языках, помогут вам настроить многие аспекты вашей системы. Если установлены нужные пакеты (пакет howto-html-en для английской версии), HOWTOs предоставит вам ответы на специфические вопросы или решения проблем. Документация размещается в каталоге /usr/share/doc/HOWTO/HTML/en/. Это HTML-файлы, которые можно читать и печатать с помощью любого веб-браузера.

Список файлов HOWTOs весьма внушительный. Советуем ознакомиться с его индексом, зайдя в главное меню: Читать документацию->Английские HOWTOs. Если вы столкнулись со сложной проблемой, начните с чтения соответствующего HOWTO (если он существует, конечно!). Вы найдете не только решение своей проблемы, но к тому же узнаете много нового. Среди других, можно привести такие полезные документы, как сетевые вопросы (NET-3-HOWTO), настройка звуковой карты (Sound-HOWTO), запись носителей CD (CD-Writing-HOWTO), а также настройка NIS и NFS и многое другое.

Важным шагом является проверка даты документов HOWTO, то есть даты публикации документа, которая приводится в начале каждого документа. Это нужно для того, чтобы удостовериться, что документ еще не устарел. Иначе содержимое документа может быть неверным. Остерегайтесь устаревших HOWTOs, в особенности касающихся настройки оборудования, так как Linux развивается очень быстро в этой области. Помните также, что в мире свободного ПО значение «устаревший» имеет значительно больший вес, чем в области IT вообще: свободное ПО может рассматриваться как устаревшее уже через две недели после выхода!

[Note]Замечание

HOWTOs доступны в сети на web-сайте TLDP и там они практически всегда самые новые. Взгляните также и сюда: HOWTOs , классифицированные по категориям; и FAQs (ЧАсто задаваемые ВОпросы).

Каталог /usr/share/doc

Некоторые пакеты поставляются со своей собственной документацией, которая хранится в одном из каталогов, названном по имени пакета, в каталоге /usr/share/doc.