k001 - man pages

Page Summary

April 2032

				1	2	3
4	5	6	7	8	9	10
11	12	13	14	15	16	17
18	19	20	21	22	23	24
25	26	27	28	29	30

k001

10/9/03 08:54 pm

Leave a comment 4 comments Add to Memories Tell A Friend Link

man pages

А ведь люди, в сущности, совсем не умеют ни мэнпейджи писать, ни troff-ом пользоваться!

Написать, что ли, HOWTO небольшое по этому делу? Я вроде довольно много знаю и умею в этой узкой области.

Update: вспомнил, что есть уже man pages writing howto. Видимо, его никто не читает. Жаль.
Update2: исправил в этом посте ошибку. Кто знает, кто знает, какую? :)

Comments

bobuk@lj

10/9/03, 12:21 pm

Reply Link Thread

А я как то все обходился manedit, который сам формировал troff файл.

k001@lj

10/10/03, 02:12 am

Reply Link Parent

Ну, manedit я не видал, но думаю, что он не всё умеет, напр. таблицы, буллеты, моноширинный шрифт...

Умение написания man-а ещё и в том состоит, что нужно, к примеру, опции выделять жирным шрифтом, а, скажем, параметры типа чисел и имён файлов - италикой. А секцию BUGS располагать примерно между FILES и SEE ALSO... Ну и так далее...

snaky@lj

10/10/03, 05:43 pm

Reply Link Thread

Ну, некоторые, типа "Steven W. Richards"(c) и книжки умудрялись. А некоторые в какой-то момент обнаружили что pod2man в 99% случаев справляется. А еще более некоторые вообще считают что manpages неудобно, а info наоборот. То есть, узок круг потенциальных читателей этого howto, страшно далеки они от народа...

Исправил groff на troff? :)

k001@lj

10/11/03, 07:05 am

Reply Link Parent

1. pod2man - нездоровая тулзень. много чего не может, слишком много своих макросов лепит в начало файла - уже в сущности свой вариант man делает.

2. так и было с самого начала - troff. ибо groff - всего лишь GNU troff.

А книжки, да, можно писать :) Особенно если использовать макросы doc, а не man.