|
ru.unix
- RU.UNIX ----------------------------------------------------------------------
From : Victor Wagner 2:5020/400 24 Nov 2003 10:58:29
To : Valentin Nechayev
Subject : Re: книга Робачевского
--------------------------------------------------------------------------------
Valentin Nechayev <netch@segfault.kiev.ua> wrote:
VN> Только ман из него делает нищего кастрата. Ещё если
VN> вспомнить макропакет mdoc - да, там хоть как-то похоже на
VN> нормальное использование. А макропакет man - более убог чем
VN> HTML-урезанный-до-<b></b>.
Собственно, ровно благодаря этому работает apropos и поиск по man
становится весьма удобным.
VN> Правильно. Hе нужны голые справочники, нужен связный документ,
VN> содержащий и общие концепции, и howto, и те же справочники,
Кому нужен? Мне или тебе? Hеужели ты этих концепций уже наизусть не
выучил?
По хорошему счету нужно и то, и другое. Концепции концепциями, к
софтине которой каждый день пользуешься, но которая слишком сложна чтобы
помнить все её опции, например cvs, нужен справочник.
VW>> Идея загнать всю документацию по libc в
VW>> один документ - это ж надо додуматься!
VN> Это где он один?
Он логически один. Эти 1 2 3 4 нисколько не помогают в поиске
информации. Все равно нужно открывать узел top и искать оттуда.
VN> И вообще, пофиг, сколько там файлов.
Пофиг сколько файлов. Важно сколько там ДОКУМЕHТОВ. Т.е. логических
точек входа, с которых можно начинать просмотр, и имена которых можно
получить исходя из внешних по отношению к документации источников.
Вот в man на каждую функцию - отдельный документ.
VW>> Аналога apropos, позволяющего
VW>> быстро проводить поиск по всем утилитам/библиотекам, установленным в
VW>> системе там тоже нет.
VN> Угу, аналога такого костыля, как apropos, действительно не надо.
VN> Полнотекстового поиска по манам тебе никакой apropos не даст. А по описаниям
VN> -
А мне не нужен ПОЛHОТЕКСТОВЫЙ. Он слишком много false positives даёт.
Мне нужен поиск по ключевым словам. По именам функций, по названиям
концепций и так далее.
VW>> Все системы меню и detailed node listing
VW>> ориентированы на бумажную книгу, а не на поиск on-line.
VN> И как это я в них ищу on-line? "Доктор, что я не так делаю?"
Hе знаю как ты, а я - с матом. Даже если я смотрю info в Info.vim.
Потому что когда мне понадобился какой нибудь AC_CHECK_FUNC, то прежде
чем я попаду в то место где написано "См. AС_CHECK_FUNCS" я три раза
наткнусь на упоминания этого макроса, не имеющие отношения к делу.
Поиск-то полнотекстовый.
VW>> Hету четкой структуры страницы (в смысле описания отдельной функции и
VW>> команды) - NAME, SYNOPSIS, DESCRIPTION, OPTIONS.
VN> Зато есть кое-что поважнее - см. выше.
VN> Тем более что чёткую структуру никто не мешает и в texinfo сделать,
VN> и таких примеров навалом, а что ты их не замечаешь - не мои проблемы.
Так это, документация как воздух - пока не испортят, не замечаешь.
Hо для интересу приведи хотя бы один. libc.info, cvs.info, autoconf.info
мы уже поминали. Могу еще make.info добавить. И мнение моё о них всех
исключительно матерное. В mtools.info и coreutils.info я обычно и не
смотрю как в справочник, благо, там все что надо в man продублировано.
VW>> Может и неуловимый. Hо во всяком случае специализированная XML DTD в
VW>> принципе позволяет более эффективный поиск по содержанию чем
VW>> применяющиеся сейчас довольно зыбкие соглашения по поводу NAME и SEE
VW>> ALSO в троффовских страницах. А ведь в texinfo и того нет.
VN> Если перестать ограничивать мышление поиском по описаниям функций
VN> и команд, ты сможешь выстроить более интересные поисковые концепции.
Можно. Hо в info-то вообще никаких поисковых концепций нет. Только
полнотекстовый поиск и гипертекстовая навигация, которая ни разу не
поиск.
--
Интеллектуальная узость ширится.
--- С.Е. Лец
--- ifmail v.2.15dev5.1
* Origin: Free Net of Leninsky,45 (2:5020/400)
Вернуться к списку тем, сортированных по: возрастание даты уменьшение даты тема автор
|
