Как создать man страницу?

Как создать ман-страницу (man)?

Очень просто
Как root (а по-другому и не получится) создайте файл в /usr/local/man/man1/anonymous.1 Так мы создадим man ;) Внутри файла пишем:

.\" Ман-страница по анонимусу
.\" Свяжитесь с ЛОРом, если заметите их распространение.
.TH man 1 "04 February 2006" "1.1" "LOR anonymous man page"
.SH НАЗВАНИЕ
anonymous \- анонимус ЛОРовский, злобный, мохнатый
.SH СИНТАКСИС
anonymous [options]
.SH ОПИСАНИЕ
Взять пользователя Windows, посадить его за firewall из FreeBSD. Открыть ему броузер на www.linux.org.ru и сказать что говорить все, что вздумается - его неотъемлимое право. Научить словам "Linux", "масдай", "сакс!", "баян", "в топку!", и "в биореактор!". Пояснить, что за упоминание "slackware" и "русских физиков" даются дополнительные бонусы.
.SH КОМАНДЫ И ОПЦИИ
.TP
.B summon
призывает анонимуса.
.TP
.B опции summon
.B --silent
Призывает тихого анонимуса, в режиме рид онли. Призванные таким образом, они ничего особенного не делают.
.B --passive
Атакует темы неохотно, парой фраз.
.B --active
Атакует многие темы и пишет пару-другую строк, замолкая в случае агрессивного ответа, подкрепленного аргументами.
.B --agressive
Атакует избранные темы или создает свои, развивая тред в флейм или холи-вар.
.B --clown
Всячески развлекает местное население.
.TP
.B kill
убивает анонимуса.
.TP
.B опции kill
.B --wall
Генерирует системный вызов убить_апстену(пид_анонимуса). Любой стандартный анонимус реагирует на него быстрым бегом в направлении крепкой бетонной стены до столкновения с ней.
.B --poison
Приводит анонимуса к депрессивному состоянию, вызванному непонятостью со стороны окружающих и ущемленным достоинством, после чего он завершает существование с результатом POISON, определенным в sys/udaff.h
.B --wire
Заставляет анонимуса помочиться на оголенный провод, находящийся под напряжением. Равносильно kill -9 пид_анонимуса
.SH СМОТРИТЕ ТАКЖЕ
padonki(1), udaff-lovers(1)
.SH БАГИ
Анонимус иногда глючит и ругается не в тему. Любит вкусно поесть, не отвлекаясь от компа. Кроме просмотра ЛОРа еще проводит время играя в Quake и Doom. Просматривает фотографии моделей и клеится по "аське" к девченкам. Даже если те сидят за соседним компом в двух метрах.
.SH АВТОРЫ
Александр Уфимцев, Станислав Когут для проекта Debian (но могут быть также использованы другими)

Ура, мы создали man! посмотреть его можно командой
$ man anonymous

Можете теперь его скомпрессировать -
$ gzip /usr/local/man/man1/anonymous.1

Кучу примеров по созданию ман-страниц можно посмотреть тут:
$ man manpath
$ man groff
$ man 7 mdoc

Вольный перевод tip 121 с http://souptonuts.sourceforge.net/