Tomsk Sysadmins Forum

Unix => Разное => Topic started by: never hood on July 26, 2007, 16:29:08

Title: Написать man
Post by: never hood on July 26, 2007, 16:29:08

Задача простая: к программке нужно сделать небольшое руководство, которое предполагается в виде man-текста под *никс.
Ранее не сталкивался, поэтому прежде чем углублятся в troff'ы, TeX'ы, DocBook'и и прочее, хочу спросить у уважаемой публики, как это сделать проще и быстрее.
Может у кого есть опыт в этом деле?

Заранее спасибо!

Title: Написать man
Post by: demiurg on July 26, 2007, 16:50:07

Quote from: never hood

Задача простая: к программке нужно сделать небольшое руководство, которое предполагается в виде man-текста под *никс.
Ранее не сталкивался, поэтому прежде чем углублятся в troff'ы, TeX'ы, DocBook'и и прочее, хочу спросить у уважаемой публики, как это сделать проще и быстрее.
Может у кого есть опыт в этом деле?

Заранее спасибо!

А может стоит почитать "каки" (howto)?  http://linux.org.ru/books/HOWTO/Man-Page.html (http://linux.org.ru/books/HOWTO/Man-Page.html)

Title: Написать man
Post by: nuclight on July 26, 2007, 17:25:24

Взять какой-нибудь ман за пример. Синтаксис mdoc достаточно простой, весь nroff учить совсем не надо. Что непонятно - спрашивайте.

Title: Написать man
Post by: never hood on July 26, 2007, 19:12:38

Quote from: demiurg

А может стоит почитать "каки" (howto)?  http://linux.org.ru/books/HOWTO/Man-Page.html (http://linux.org.ru/books/HOWTO/Man-Page.html)

видимо, стоит...
спасибо и на этом!