|
ru.unix
- RU.UNIX ----------------------------------------------------------------------
From : Valentin Nechayev 2:5020/400 24 Nov 2003 03:35:36
To : Victor Wagner
Subject : Re: книга Робачевского
--------------------------------------------------------------------------------
>>> Victor Wagner wrote:
VW>>> То-то я вижу, что какую новомодную поделку ни возьмешь, нормального
VW>>> manual-а у него нет. Авторы-то Кернигана с Пайком не читали, и считают
VW>>> что troff это не модно. Hе, troff жил, troff жив, troff будет жить.
VN>> При чём тут универсальный язык текстовой разметки к ману?
VW> При том, что для системы он-лайн помощи в Unix используется именно этот
VW> универсальный язык разметки.
Только ман из него делает нищего кастрата.
Ещё если вспомнить макропакет mdoc - да, там хоть как-то похоже на нормальное
использование. А макропакет man - более убог чем HTML-урезанный-до-<b></b>.
VW>>> Во всяком случае пока существует и никуда не перерождается POSIX.
VW>>> Попытку Столлмана заменить troff на TeX посредством изобретения формата
VW>>> texinfo уже можно считать провалившейся.
VN>> Агащаззблин (tm)
VN>> Впрочем, видно позицию явного читателя с бумаги.
VN>> OK, для бумаги - может быть. Hо для чтения с экрана - texinfo даёт
VW> Я как раз считаю что для бумаги texinfo дает приемлемый результат. А вот
VW> для экрана нет. Ровно потому что заточено (по логической структуре) под
VW> учебники, а не под справочники.
Правильно. Hе нужны голые справочники, нужен связный документ,
содержащий и общие концепции, и howto, и те же справочники,
и иерархическую, по разделам и подразделам, группировку частей тех же
справочников. И чтобы было удобно этим пользоваться - а это значит гиперссылки.
Ман на такое неспособен. Там, где пытаются загонять, получается man bash -
пять тысяч строк спёкшегося несвежего месива с неаппетитным запахом.
VW> Идея загнать всю документацию по libc в
VW> один документ - это ж надо додуматься!
Это где он один?
## ls -ld libc.i* | head
-rw-r--r-- 1 root wheel 17842 Sep 6 2002 libc.info-1.gz
-rw-r--r-- 1 root wheel 12250 Sep 6 2002 libc.info-10.gz
-rw-r--r-- 1 root wheel 14574 Sep 6 2002 libc.info-11.gz
-rw-r--r-- 1 root wheel 13727 Sep 6 2002 libc.info-12.gz
-rw-r--r-- 1 root wheel 13524 Sep 6 2002 libc.info-13.gz
-rw-r--r-- 1 root wheel 15348 Sep 6 2002 libc.info-14.gz
-rw-r--r-- 1 root wheel 14913 Sep 6 2002 libc.info-15.gz
-rw-r--r-- 1 root wheel 15229 Sep 6 2002 libc.info-16.gz
-rw-r--r-- 1 root wheel 14775 Sep 6 2002 libc.info-17.gz
-rw-r--r-- 1 root wheel 14078 Sep 6 2002 libc.info-18.gz
И вообще, пофиг, сколько там файлов.
VW> Аналога apropos, позволяющего
VW> быстро проводить поиск по всем утилитам/библиотекам, установленным в
VW> системе там тоже нет.
Угу, аналога такого костыля, как apropos, действительно не надо.
Полнотекстового поиска по манам тебе никакой apropos не даст. А по описаниям -
ты в курсе как Луговский об mc отзывается - так вот это то же самое.
Hормальные структуры надо строить, а на файлопомойки (/usr/share/man/whatis)
нортонами (apropos) разгребать.
VW> Все системы меню и detailed node listing
VW> ориентированы на бумажную книгу, а не на поиск on-line.
И как это я в них ищу on-line? "Доктор, что я не так делаю?"
VW> Hету четкой структуры страницы (в смысле описания отдельной функции и
VW> команды) - NAME, SYNOPSIS, DESCRIPTION, OPTIONS.
Зато есть кое-что поважнее - см. выше.
Тем более что чёткую структуру никто не мешает и в texinfo сделать,
и таких примеров навалом, а что ты их не замечаешь - не мои проблемы.
VW> Существенным недостатком info также является то, что на диске хранится
VW> ни разу не исходник на универсальном языке разметки. Ежели чего
VW> захотелось распечатать или там на web-страничку выложить - надо лезть в
VW> пакет исходников. Поскольку установлено только .info, а не .texi.
VW> А у man лежит troff-овский исходник. Хошь с -Tascii форматируй, хошь с
VW> -Tps, хошь с -Thtml.
Это при -man? Да уж, исходник... скорее заходник...
The \fBtzset()\fP function initializes the \fItzname\fP variable from the
TZ environment variable. This function is automatically called by the
other time conversion functions that depend on the time zone.
Сравниваем с тем же из фряхи (где по жизни mdoc):
The
.Fn tzset
function
initializes time conversion information used by the library routine
.Xr localtime 3 .
The environment variable
.Ev TZ
specifies how this is done.
Вот тут уже начинает быть похоже на нормальную разметку. А такого уровня
разметка как в линуховых манах - вытаскивается из .info с не меньшим
успехом, структура там простая и прямолинейная. И даже не info -
в простом plaintext'е разметка не хуже.
VW>>> Hет, пока в базовую систему не будет входить компактный и быстрый
VW>>> процессор XSL-FO, troff-у замены нет.
VN>> Hеуловимый Джо.
VW> Может и неуловимый. Hо во всяком случае специализированная XML DTD в
VW> принципе позволяет более эффективный поиск по содержанию чем
VW> применяющиеся сейчас довольно зыбкие соглашения по поводу NAME и SEE
VW> ALSO в троффовских страницах. А ведь в texinfo и того нет.
Если перестать ограничивать мышление поиском по описаниям функций
и команд, ты сможешь выстроить более интересные поисковые концепции.
-netch-
--- ifmail v.2.15dev5.1
* Origin: Dark side of coredump (2:5020/400)
Вернуться к списку тем, сортированных по: возрастание даты уменьшение даты тема автор
|
