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

Что-то часто тебя бомбить стало… (^ ^)

Нет. Мне не нравится, что вместо списка необходимых опций, программа выдает мне телегу, которая должна быть первой секцией в мануале.

Я просто человек-баттхерт, вот и все. Это норма.

Опция --help должна выводить полный список опций с кратким описанием. В man - более подробное описание. То, что ты предлагаешь - неюзабельное говно. С таким же успехом опцию --help можно вообще убрать.

Думаю всё-таки --help важнее man. Man в системе может вообще не быть (знаешь, есть системы кроме линукса и БСД) и что тогда делать?

есть системы кроме линукса и БСД

Я про это не подумал. Окей.

/?

subj

Короч - я не понимаю, какого черта в, например, qemu, ключ --help выводит километр опций. Для этого есть ман

Ман нужен для другого.

То, что ты хочешь, должно быть в man в EXAMPLES.

Если уж так мешает, то отрезать лишнее не проблема

% f1 () { $1 --help 2>&1 | head; }
% f1 man
% f1 cp

и т.д. А вот дописать недостающее - будет задачка посложнее.

то, что ты хочешь - это tab + *sh-completion + твоя фантазия.
посмотрел хелп qemu-kvm, да, как ни старайся, а получается простыня
посмотрел ман qemu, гораздо удобней для глаз, чем хелп

Это не только к qemu. Это gcc, clang и make help к ядру тоже грешат.

в системе может вообще не быть

1. В семёрочке уже было нечто похожее на ман. А экспишечка всё.

2. Проблемы негров шерифа не волнуют.

3. Конкретно у qemu автор отложил на потом написание --help, потом не случилось, он забил на проект, а красноглазым имх пофиг.

4. гнуисизмы типа --help - сакс.

1) О! У нас, оказывается, лишь 3 ОС: линь, бсдинь и вынь. Ок.
2) Проблемы шерифа не волнуют вооружённых белых людей.
3) И что? Поэтому надо доломать?
4) А мужики-то и не знали. Оказывается параметры командной строки — это плохо. Хм. Какая глубокая мысль.

1) О! У нас, оказывается, лишь 3 ОС: линь, бсдинь и вынь. Ок.

Ви забыли гей ос. Маны в ней есть.

2) Проблемы шерифа не волнуют вооружённых белых людей.

Да как сказать, 45 colt остановит кого угодно, тем более шериф имеет право стрелять без предупреждения.

3) И что? Поэтому надо доломать?

Задай этот вопрос red hat. Потому как сейчас qemu пилиться под крылом этой канторы.

4) А мужики-то и не знали. Оказывается параметры командной строки — это плохо. Хм. Какая глубокая мысль.

Вот и выросло покАление не знающее, что "--" появилось в гнутых утилитах. 20 лет до обходились просто "-".

И блин что?
Ну вот что ты хочешь сказать?
Что - хорошо, а — плохо?
А при куче мелких параметров будешь набирать - перед каждым?
Или ты просто упорот и у тебя от — глаза вытекают?

Да ну тебя нахрен. Не хочу с тобой разговаривать.

О! У нас, оказывается, лишь 3 ОС: линь, бсдинь и вынь. Ок.

nix-like (linux, mac, bsd*, solaris, основная масса не-виндовых и используемых, в общем), плюс plan9 умеют в маны, разве нет?

Можно кстати где-нибудь найти список хост-машин, которые поддерживают куэму?

Да ну тебя нахрен. Не хочу с тобой разговаривать.

Успокоительного купите.

А при куче мелких параметров будешь набирать - перед каждым?

Само собой удобнее набрать -sdkfg чем --somethn1 --somethn2 --somethn3 --somethn4 и так далее. Даже тот же --help удобнее набрать как -h, но в этих гнутых утилитах очень часто -h не значит --help.

Убожество, что ещё я могу сказать.

Man в системе может вообще не быть (знаешь, есть системы кроме линукса и БСД) и что тогда делать?

Открыть pdf-ку из папки с документацией?

Но нахрена все эти сложности если у программы УЖЕ есть встроенный хелп?
Вы тут все укуренные или это просто возражение ради возражения?

--help и полновесная документация на несколько тысяч страниц это несколько разные вещи. Если конечно речь не про какой-нибудь очередной хелоуворлд с маном на пол странички

Лорчую. Весь ман утилитки qpdf — это четыре строки о том, что это вообще в общих чертах такое, и «for a summary of qpdf's options, please run qpdf --help». Зато qpdf --help даёт выхлоп в 202 строки.

Я просто человек-баттхерт, вот и все.

До местных ассов тебе пока далеко.

Ассы — это те, которые задницы?

Это ещё что. =)

Меня вот бесят GNU-маны, которые на 146-и станицах описывают, как RMS боролся за справедливость, как ему пришла в говову чудная идея, как он сел всё это писать. В общем часто лучше чем Агата Кристи. =) А вот описание опций с лупой искать приходится.

Краткое и ясное описание, что же какая опция делает — это я только в BSD манах встречал.

В принцепе от туда и проблемы. Маны писать не умеют, всё в --help засовывают.

Т.ч. поддерживаю, BSD-way мне нравится больше:

по '-h' очень короткая справка, какие опции вообще есть. И _чёткое_ и _ясное_ описание всего остального, но уже в мане.

Я имел в виду мастеров баттхёрта.

по '-h' очень короткая справка, какие опции вообще есть

В qemu так и сделано. Просто опций у него ну уж очень дофига.

Сравните просто качество манов тут: http://linux.die.net/man/1/ls и тут: http://www.openbsd.org/cgi-bin/man.cgi?query=ls&sektion=

А так же выхлоп «ls -?» на BSD:

usage: ls [-1AaCcdFfgHhikLlmnopqRrSsTtux] [file ...]

А на Linux ls --help и сами посмотреть и ужаснуться можете.

GNU-маны, которые на 146-и станицах описывают, как RMS боролся за справедливость, как ему пришла в говову чудная идея, как он сел всё это писать

Это в каком так?

Да куча их, тот же man emacs графоман какой-то писал.

В общем, моя теза:

• Должно было быть: по ключу в командной строке только кратий список. Описание опций в мане.
• Что имеем: по ключу описание всего и вся. В манах графоманские высеры.

Я кончил и закурил.

Ну так-то я понял, но петросяна из себя не изжить.