Re: =?koi8-r?B?RFREIMTM0SDOwdDJ08HOydEgzcEgzs/X?=

[Michael Sobolev <mss@transas.com>]

On Wed, Dec 30, 1998 at 04:27:57PM +0300, Boris Tobotras wrote:
> > На мой взгляд, структура и назначение man pages несколько отличаются
> > от того, что делается на DocBook, т.е. от книги.
> 
> 	Вот и я о том же.
Не согласен.  Существуют разные книги.  И есть такие, которые обычно имеют
название "Что-то там Refernce Manual".  Последние обычно суть ни что иное
как набор этих самых RefEntry-s (ies:), объединенных в главы, раздели и
тому подобное.

Теперь о назначении.  На мой взгляд, книга -- это то, что хочется иметь на
полке, читать в свободное от компутера время (в электричке там, или еще где
получится), использовать в режиме "все и сразу".  Страница руководства -- это
то, что мы используем во время общения с компутером, при написании программ,
при отсутствии свободного от компутера времени, при неожиданном желании узнать
что-то новое.  Информация, которую я хочу почерпнуть в том и другом случае, не
должна отличаться.

> > Man pages есть
> > неупорядоченный словарь отдельных страниц, связанных между собой
> > гиперссылками. Поэтому обычно документация на программный продукт
> > включает в себя как руководство в виде книги, так и отдельный набор
> > man pages. Единственная трудность -- необходимо разбираться в формате

В точности, но я еще раз хочу подчеркнуть, что в книге я хочу получить по
крайней мере то же, что и в странице руководства, а страница руководства должна
мне дать не менее полную информацию (это уже моя проблема пойму я все и сразу
или нет), что и книга.

> 	Угу. Там этот вопрос раз в пару месяцев всплывает. И тонет 
> обратно. Я искал по архивам. Пусто.

Не совсем.  На домашней странице давенпорта есть некий конвертер...  Но он
расчитан на более старую версия докбука.

> 	В-общем, я наваял нечто в составе TEItools. Желаю критики.
:)  Теи -- это не то, что нужно использовать при написании текстов, связанных
с компутерами. :)

--
Миша