Кристапс Джонсонс (Kristaps Dzonsons), один из разработчиков mandoc (http://mdocml.bsd.lv/), выложил в открытый доступ свою книгу "Practical UNIX Manuals (http://manpages.bsd.lv/)", посвященную созданию man-страниц. По словам (http://undeadly.org/cgi?action=article&sid=20110827115056) автора, он видел немало справочной информации по формату mdoc, но ни одного полноценного (корректного и освещающего все основные нюансы) руководства для начинающих. Теперь такое руководство есть и доступно для всех желающих.
Проект (http://manpages.bsd.lv/cgi-bin/cvsweb/?cvsroot=manpages) открыт для принятия дополнений и исправлений. Сама книга представляет собой простой набор XHTML-страниц, поэтому написание патчей не должно составить труда для любого IT-специалиста.
URL: http://undeadly.org/cgi?action=article&sid=20110827115056
Новость: http://www.opennet.me/opennews/art.shtml?num=31612
чтоб написать мануал - прочитайте мануал.
когда выйдете из рекурсии, скажите;)
Ну так пишутся и читаются разные мануалы.
> Ну так пишутся и читаются разные мануалы.И кстати, да, дайшь _книгу "Чтение man-ов для иди^Wманекенов".:D
>> Ну так пишутся и читаются разные мануалы.
> И кстати, да, дайшь _книгу "Чтение man-ов для иди^Wманекенов".:DДа что там манекены, если уж для предметов быта пишут: то ли для кофейников, то ли для кастрюль, не помню... ;)
>Да что там манекены, если уж для предметов быта пишут: то ли для кофейников, то ли для кастрюль, не помню... ;)И очень правильно делают.
Вы никогда не слышали про pkunzip.zip? :)
Давно пора перевести мануалы на HTML, а раздел "SEE ALSO" сделать ссылками.
> Давно пора перевести мануалы на HTML1. Для тех, у кого браузер смысл жизни - http://linuxmanpages.com/
2. Для фетиша на локальной машине:
# cd /usr/share/man;
# for i in `find . -name *.gz`; do zcat $i | man2html > $i.html; rm $i; done;# firefox /usr/share/man/man7/socket.gz.html
>а раздел "SEE ALSO" сделать ссылками.
Для тех у кого не забанили Гугла
http://www.google.com/search?q=SEE+ALSO---
Сиди в своём браузере, отъ...бись от UNIX Way
И обязательно что-нибкдь на js сделать надо в манах!
> И обязательно что-нибкдь на js сделать надо в манах!На VRML. :)
HTML, HTML... Уж тогда в SGML сразу...
> Давно пора перевести мануалы на HTML, а раздел "SEE ALSO" сделать ссылками.Будет неудобно при восстановлении системы, например. И на серверах.
> Давно пора перевести мануалы на HTML, а раздел "SEE ALSO" сделать ссылками.«mandoc -Thtml» работает ничуть не хуже, чем «mandoc -Tascii». Почему не сразу в HTML? Да потому что HTML не сохраняет семантику. Тогда уж в монстроидальный docbook скорее переводить надо. Вот только кому?..
>а раздел "SEE ALSO" сделать ссылкамиs/man/info/ и будет тебе счастье!
> Давно пора перевести мануалы на HTML, а раздел "SEE ALSO" сделать ссылками.Use pinfo, Luke!
>Pinfo also supports viewing of manual pages -- they're colorised like in the midnight commander's viewer, and additionaly they are hypertextualized (i.e. when pinfo encounters a reference of form manualname (n), then you can press enter there, and voila -- you're on the page for `manualname'.
alias man='pinfo -m'
маны без полноценной поддержки opengl и javascript никто читать не будет
Может кто подскажет по комманде info, почему-то русский поиск не работает? =\ дебиан utf8
По линку на не-белом фоне стилизация под маны совершенно нечитаема. А еще называть "язык mdoc", когда он на самом деле nroff, несколько, гм, некорректно.
> По линку на не-белом фоне стилизация под маны совершенно нечитаема. А еще
> называть "язык mdoc", когда он на самом деле nroff, несколько, гм,
> некорректно.У него официального названия вообще нет. :) nroff — лишь одна из (самая известная на данный момент) утилит, кушающих ROFF с -mdoc. Да и man-страницы, в которых обсуждается этот макроязык, везде называются mdoc(7), и в *BSD, и в Linux... :)
>> По линку на не-белом фоне стилизация под маны совершенно нечитаема. А еще
>> называть "язык mdoc", когда он на самом деле nroff, несколько, гм,
>> некорректно.
> У него официального названия вообще нет. :) nroff — лишь одна из
> (самая известная на данный момент) утилит, кушающих ROFF с -mdoc. Да
> и man-страницы, в которых обсуждается этот макроязык, везде называются mdoc(7), и
> в *BSD, и в Linux... :)Ну это ж не язык, а пакет макросов просто. А то так и до языка ms(7) докатиться можно :)
>>> По линку на не-белом фоне стилизация под маны совершенно нечитаема. А еще
>>> называть "язык mdoc", когда он на самом деле nroff, несколько, гм,
>>> некорректно.
>> У него официального названия вообще нет. :) nroff — лишь одна из
>> (самая известная на данный момент) утилит, кушающих ROFF с -mdoc. Да
>> и man-страницы, в которых обсуждается этот макроязык, везде называются mdoc(7), и
>> в *BSD, и в Linux... :)
> Ну это ж не язык, а пакет макросов просто. А то так
> и до языка ms(7) докатиться можно :)Сторгуемся на «макроязыке»? ;)