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

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

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

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

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

  • Руководство к быстрому старту;

    Этот документ в печатном виде поставляется в коробочной версии Mandrake Linux. Он служит справочником, облегчающим процесс инсталляции.

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

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

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

    Доступное только он-лайн и в Mandrake Linux ProSuite Edition, это руководство затрагивает вопросы расширенной работы в 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 с помощью браузера, и печатать с помощью PostScript.

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

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

Замечание

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

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

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