Мануалы (те, что man, да и не только) - это ...

2. Плохая дока, но лучше ничего нет.

я давно уже заметил, что для пользования манами надо знать что ищешь заранее.

0. Отличная дока, но только для тех, кто умеет читать.

1.

Маны лишь краткое напоминалка как использовать программу. Если вам нужно подробное описание, или вообще тутуориал, то откройте для себя файлы инфо.

маны НетБСД прекрасны и понятны. маны линукса гораздо хуже.

инфо маст гореть в аду

Завидовать нехорошо. Иди дальше некрофиль.

>Если вам нужно подробное описание, или вообще тутуориал, то откройте для себя файлы инфо.

Ага, откройте. Не для всех прог есть info, а для тех что есть часть "информашек" представляют из себя всё те же man'ы ;)

>Маны лишь краткое напоминалка как использовать программу.

Когда возникает ситуация, что известен ключ и нужно найти его значение? Обычно даже для справки нужно _найти_ ключ по некой функции. То есть "инвертировать" man. Или хотя бы сделать сортировку по функциям, а не по алфавиту.

> инфо маст гореть в аду

Обоснуете?

+1. в openbsd тоже прекрасные маны, с примерами. есть маны по драйверам.

> Про полноту молчу - да, подробные.

Не все :(

> сортировка по алфавиту

Не всегда. Иногда по назначению. Иногда вообще нету. Но, если man вызывает less, есть поиск.

> нет разделения популярных ключиков и не очень

Опять не всегда. Кроме того, популярные часто можно узнать сказав программе -h или --help.

> примеров так мало

Скажи спасибо, если вообще есть.

> нет краткого описания _возможностей_

Ещё раз как повезёт.

> нигде нет описания матчасти, а есть лишь дока по реализации

Несколько раз видел. Но крайне редко.

> Во всём этом что, есть сакральный смысл?

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

> И неужели это всем нравится, судя по тому, что именно в man посылают? Или нужда, ибо нет ничего лучше?

Именно. Нету.

Уже сказали. В каком-нибудь NetBSD есть небольшая хорошо скоординированная команда, которая делает документацию единообразно. А более популярный гну-линукс -- как мозаика, каждый что-нибудь норовит добавить, игнорируя мнение окружающих. Зато программ больше.

> Когда возникает ситуация, что известен ключ и нужно найти его значение? Обычно даже для справки нужно _найти_ ключ по некой функции. То есть "инвертировать" man. Или хотя бы сделать сортировку по функциям, а не по алфавиту.

man grep | grep -A 10 after-context

Linux - 4, Net/OpenBSD - 0, остальное X3

А в чём разница между 2 и 3?

>А в чём разница между 2 и 3?

2 - остальное тоже плохо, то есть выбор есть. 3 - остальное ужасно, то есть выбора нет.

>man grep | grep -A 10 after-context

И? что это даст? ну выдадут линии, а нужны термины, применимые к ключу. Словарь наоборот: термин - ключ. А уже потом - подробное объяснение.

Во-вторых, это просто кошмар, когда _в самом популярном случае_ использования справки уже нужно использовать дополнительные средства.

> инфо маст гореть в аду

info получше чем html и намного лучше pdf. man — справочник, а не подробная дока.

дока на ту же netbsd в html, а не в man'ах.

А ты не читай ман сплошным текстом. Я вот вообще ни разу не читал ман от начала до конца. Волшебная кнопка / подсвечивает мне все, что надо.

0 man'ы не читают, а вкуривают до полного просветления сознания.

1 что-бы знать, что искать, можно сначала почитать всякие wiki и погуглить в поисках аналогичной проблемы. Можно даже запостить вопрос на ЛОР'е.

2 Этой системе документации ~30 лет. И от неё за этот промежуток времени не отказались.

anonymous> Во-вторых, это просто кошмар, когда _в самом популярном случае_ использования справки уже нужно использовать дополнительные средства.

Маны - это напоминалка и краткая документация. Это не основы пользования системой - для этих целей книжки существуют типа "Инсталляция Linux и первые шаги" М. Уэлша.

Man это не учебник по программе или файлу, а лишь расширенная (--help) справка. Забыл - подсмотрел.

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

> НетБСД

Это не там, где по "программа --help" вываливается что-то типа "программа -ABTHSsdhjsfh"? Это идиотизм и мудачество.

> Это идиотизм и мудачество.

в BSD'ах принято читать мануал перед тем как запускать команду. Там за качеством man'ов следят, в отличие от каши GNU'тых утилит с у*бишным маном, кой посылает читать info.

--help и прочие long-option-nuisance — верх идиотизма. Они может и понятные, но набирать их одно мучение.

> Они может и понятные, но набирать их одно мучение.

use zsh, Luke

$ du --exclude=
--all               -a  -- write counts for all files
--apparent-size         -- print apparent sizes rather than disc usage
--block-size        -B  -- specify block size
--bytes             -b  -- equivalent to --apparent-size --block-size=1
--count-links       -l  -- count sizes many times if hard linked
--dereference       -L  -- dereference all symlinks
--dereference-args  -D  -- dereference arguments that are symlinks
--exclude               -- exclude files matching pattern
--exclude-from      -X  -- exclude files matching any pattern in file
--help                  -- display help information
--human-readable    -h  -- print sizes in human readable format
-k                      -- use block size of 1k
--max-depth             -- maximum levels to recurse
--one-file-system   -x  -- skip directories on different filesystems
--seperate-dirs     -S  -- do not include size of subdirectories
--si                -H  -- human readable form using powers of 1000
--summarize         -s  -- only display total for each argument
--total             -c  -- produce a grand total
--version               -- display version information


И всё это как меню, по которому можно перемещаться стрелками

>Волшебная кнопка / подсвечивает мне все, что надо.

То есть искать нужно что-то конкретное? Это уже не справочник. И опять же, обзор это не даёт.

> Обычно даже для справки нужно _найти_ ключ по некой функции. То есть "инвертировать" man. Или хотя бы сделать сортировку по функциям, а не по алфавиту.

apropos

Меню, с сортировкой ключей по алфавиту. Какой смысл в сортировке _ключей_, до сих пор не ответил никто. Видимо, так проще писать доку, а то, что её сложнее понять - так и фиг с ним. ;(

> Во-вторых, это просто кошмар, когда _в самом популярном случае_ использования справки уже нужно использовать дополнительные средства.

Unix-way

>apropos

И что даст apropos? Опять, нужно изначально знать, что искать. Матчасть- то apropos не даёт. Как и _краткий_ список _возможностей_ программы, чтобы потом удобнее в нужном мане ориентироваться...

Кстати, это ничего, что apropos работает только для установленных программ? man, по крайней мере, можно найти в сети.

o_O

> Меню, с сортировкой ключей по алфавиту. Какой смысл в сортировке _ключей_, до сих пор не ответил никто.

Давай ты спросишь об этом авторов соответствующих программ? Если не дадут вразумительный ответ, отправь им новые версии мануалов, с правильной сортировкой. И сообщи о результатах, скажем, через месяц.

Если проблемы с английским -- могу помочь.

> Опять, нужно изначально знать, что искать.

Когда ищешь то, не знаешь что -- это уже клиника. Тут даже Гугль не поможет.

> Матчасть- то apropos не даёт. Как и _краткий_ список _возможностей_ программы, чтобы потом удобнее в нужном мане ориентироваться...

А оно и не должно. Об этом уже написали. Матчасть в Гугле ищут обычно.

> man, по крайней мере, можно найти в сети.

Даю подсказку: в Сети можно найти не только маны.

Вдогонку: маны незаменимы для расшифровки "однострочников на шелле", найденных в сомнительных местах вроде ЛОРа.

> Меню, с сортировкой ключей по алфавиту.

Это было к "учить".

Да, и краткая справка к ключам в том "меню" есть.

>Когда ищешь то, не знаешь что -- это уже клиника.

Да неужели? Вот я хочу фильм перекодировать. Знаю, что есть ffmpeg. Матчасти не знаю. В нормальной доке последнюю узнаю вместе с тем, как и пользоваться самой прогой. А что мне нужно знать для man ffmpeg, чтобы искать в нём?

>Матчасть в Гугле ищут обычно.

Вопрос тот же - какую искать матчасть, чтобы воспользоваться ffmpeg. При этом нужно учесть, что юзер инглиш на "нужном" уровне не знает. То есть читать на инглише может, а вот писать (запросы давать) - нет. В том числе и потому, что не знает матчасти, особенно на инглише. Приведите пример действий, которые приведут к матчасти на _одном_ сайте.

>Даю подсказку: в Сети можно найти не только маны.

Можно, отсюда и опрос - что же такое маны. И зачем в них посылают.

>Вдогонку: маны незаменимы для расшифровки "однострочников на шелле", найденных в сомнительных местах вроде ЛОРа.

Вот единственное, для чего они годятся... Но таких случаем применения много?

>Да, и краткая справка к ключам в том "меню" есть.

А когда ключей огромное количество, читать справа налево, причём последовательно из-за "хорошей" сортировки?

>читать справа налево

Тренируйся на манге :)

> А что мне нужно знать для man ffmpeg, чтобы искать в нём?

links /usr/share/doc/ffmpeg-doc-11656/ffmpeg-doc.html

Используйте инструмент под задачу, это Unix, здесь универсальные комбайны не приветствуются.

> Приведите пример действий, которые приведут к матчасти на _одном_ сайте.

google "ffmpeg documentation"

Результат:

http://ffmpeg.mplayerhq.hu/ffmpeg-doc.html

Удовлетворены?

Просто

google ffmpeg

Дает:

http://ffmpeg.mplayerhq.hu/

Откуда уже один клик до

http://ffmpeg.mplayerhq.hu/documentation.html

И тут уже хоть зачитайся этой самой матчастью.

> Можно, отсюда и опрос - что же такое маны. И зачем в них посылают.

Да потому что это простейшая подсказка для тех, кто вообще не знает, что ищет. По крайней мере, из мана можно набрать ключевых слов для Гугла :-).

Кстати:

man ffmpeg|grep -A 100 EX|less

Вы бы постыдились, что-ли... :-)

> Вот единственное, для чего они годятся...

Не единственное, но общее для всех манов. Как тут уже писали, есть вменяемые маны :-).

> Но таких случаем применения много?

Вы даже не представляете себе, как их много :-). Особенно, когда ковыряешь системные скрипты :-).

>links /usr/share/doc/ffmpeg-doc-11656/ffmpeg-doc.html

Команда по сравнению с man ffmpeg сама краткость и понятность. ;)

>google "ffmpeg documentation" Результат: ...........

Где матчасть ? Я вообще матчасти не вижу! Да, быстрый старт есть гуд. Но где матчасть? Где строение видеофайлов? Где перечисление _принципиальных_ возможностей по их обработке? Где сравнение форматов? Где общая техника перекодировки? Где матчасть-то? Справка по программе и только...

>Кстати: man ffmpeg|grep -A 100 EX|less Вы бы постыдились, что-ли... :-)

Да, у ffmpeg хорошие примеры. Но! Их всё-таки мало и что это за костыль посёредине? Это нужно самому догадаться, или этому где-то учат?

> И что даст apropos? Опять, нужно изначально знать, что искать. Матчасть- то apropos не даёт. Как и _краткий_ список _возможностей_ программы, чтобы потом удобнее в нужном мане ориентироваться...

Поэтому и придумали windows-way, где программы может не столь гибкие, зато осваиваются одним взглядом на окошко с опциями. Выбирать из готового списка проще чем придумать своё, на любом даже самом "бытовом" уровне. Особенность человеческой психики, ничего не поделаешь.

> Команда по сравнению с man ffmpeg сама краткость и понятность. ;)

Алиасы не осилили?

> Где матчасть ? Я вообще матчасти не вижу!

Сходите к окулисту.

> Но где матчасть? Где строение видеофайлов? Где перечисление _принципиальных_ возможностей по их обработке? Где сравнение форматов? Где общая техника перекодировки? Где матчасть-то?

Купите книжку хорошую, если хотите в этом специализироваться. Лично мне для перекодирования файлов манов за глаза хватило.

> Их всё-таки мало и что это за костыль посёредине?

Это Вы про что?

> Это нужно самому догадаться, или этому где-то учат?

Да. Английскому языку учат в средней школе, как правило.

> Поэтому и придумали windows-way, где программы может не столь гибкие, зато осваиваются одним взглядом на окошко с опциями. Выбирать из готового списка проще чем придумать своё, на любом даже самом "бытовом" уровне. Особенность человеческой психики, ничего не поделаешь.

Тонкий троллинг оценил.

Извините, еда закончилась...

> Тонкий троллинг оценил.

Почему троллинг? Разгони, чем копание в манах (а копаться приходится, сколько тут народу отписалось ваше?) и последующая РУЧНАЯ копипаста увиденного лучше одного взгляда и двух кликов?

> Разгони, чем копание в манах (а копаться приходится, сколько тут народу отписалось ваше?) и последующая РУЧНАЯ копипаста увиденного лучше одного взгляда и двух кликов?

Да потому что

"UNIX - дружелюбная операционная система, вот только она сама выбирает себе друзей." (C)

Не нравятся Вам маны -- не пользуйтесь, есть десятки других способов -- начиная инфо, и заканчивая Гуглем.

>Справка по программе и только...

А что, в мане к bc должен быть учебник матана? Нужно знание по кодированию видео, их и гуглите. На том же мплейере есть неплохое руководство по рипанью.

>Команда по сравнению с man ffmpeg сама краткость и понятность. ;)

Несколько длиннее, но для человека, хотя бы второй день в консоле понятная и очевидная.

>Их всё-таки мало и что это за костыль посёредине? Это нужно самому догадаться, или этому где-то учат?

Про grep? Да, учат. "Запуская линукс", к примеру.

>Поэтому и придумали windows-way

Может, не windows-way, а GUI?

>Алиасы не осилили?

И с чем "алиасировать"? С каждой докой в /usr/share/doc? Руками?

Остальное без аргументации...