#/* vim: set filetype=sh : */
# bash_usage - help for self-coded BASH functions
# dimio (http://dimio.org)
# See more: http://dimio.org/bash-born-again-shell-obolochka-komandnoj-stroki.html
# "extglob" BASH option must by  activated!
# VERSION='0.12'
#
# TODO: дополнение параметров usage через bash comletion

usage() {
    case "${1}" in
        ?(-)tmux)
            _usage_tmux;;
        ?(-)mc)
            _usage_mc;;
        ?(-)mplayer)
            _usage_mplayer;;
        ?(-)gps|?(-)gpsbabel)
            _usage_gpsbabel;;
        ?(-)vcsh)
            _usage_vcsh;;
        ?(-)git)
            _usage_git;;
        ?(-)disabled)
            _usage_disabled;;
        *)
            _usage_main;;
    esac
}

_usage_main() {
#cat <  enter repo (vcsh shell mode)
git add .               add all modified files to current repo (see gitignore.d/repo_name)
git status              check added files
git ci -m 'commit desc' make commit
git push origin master  push commit to remote repo

See more: dimio.org?p=1359
EOF
}

_usage_mplayer() {
more < - перемотка назад/ вперед на 10 секунд.
up и down - перемотка вперед/ назад на 1 минуту.
pgup и pgdown - перемотка вперед/ назад на 10 минут.
[ и ] - уменьшает/увеличивает скорость воспроизведения на 10%.
{ и } - вдвое меньшая/большая скорость воспроизведения.
backspace - восстанавливает нормальную скорость воспроизведения.
< и > - перемещение назад/ вперед по списку воспроизведения.
p / SPACE - пауза (повторное нажатие продолжает воспроизведение).
. - кадр вперед, нажать снова - след. кадр и т.д.
q / ESC - остановка воспроизведения и выход и программы.
+ и − изменить задержку аудио на +/− 0.1 секунды.
/ и *, 9 и 0 - уменьшает/ увеличивает громкость.
( и ) - подстраивает баланс, усиливая левый/ правый канал.
m - выключает звук.
_, #, TAB - циклически переключает доступные аудио/видео дорожки.
f - включает полноэкранный режим (смотрите также −fs).
v - изменяет видимость субтитров.
j - циклически меняет доступные субтитры.
s - (только для −vf screenshot) - делает снимок экрана.
EOF
}

_usage_gpsbabel() {
more <
-t -w говорят, что с устройства нужно брать информацию только о треках (-t)
    и точках маршрута (-w);
-x radius,distance=3K,lat=45.058646,lon=6.907375 — это фильтр, отсекающий всё,
    что не входит в круг радиусом 3 км относительно заданной точки (необязательно);
-x track,pack — этот фильтр объединяет треки отдельных переходов в один большой;
-x discard,hdop=3,vdop=3 — этот фильтр выбрасывает из трека точки, для которых
    горизонтальная или вертикальная мера ошибки больше 3;
-x position,distance=15m — объединяет точки, расстояние между которыми меньше 15 м;
-x interpolate,time=60 — интерполирует трек так, чтобы между соседними точками было
    не более 60 секунд (это один из самых полезных фильтров для создания геотегов!);
-o kml,points=0 - выходной формат kml, трек не разбивается на точки;
EOF
}

_usage_mc() {
    echo -E '
Нажатие Esc аналогично нажитию Alt (см. настройки терминала)
Alt+.       - показать/скрыть скрытые файлы
Alt+t       - переключает режим отображения панелей
Alt+o       - открыть в неактивной панели выделенный каталог
Alt+H       - история переходов по каталогам
Alt+,       - вертикальное/горизонтальное расположение панелей
Alt+?       - поиск файла
+           - выбор файлов по регулярному выражению
\           - снять отметку с выбранного
Ctrl+x c    - chmod для выделенного
Ctrl+x o    - chown для выделенного
Ctrl+x s    - ln -s (симлинк)
Crtl+x i    - неактивная панель в режим "информация"
Ctrl+x \    - меню быстрого перехода
Ctrl+x h    - добавить в меню быстрого перехода
Ctrl+Space  - вывод размера каталога
Ctrl+r      - обновить содержимое каталога
Ctrl+x d    - сравнить содержимое каталогов (прав/лев панели)
Ctrl+x,Ctrl+d   - сравнить содержимое файлов (diff)
Ctrl+s      - поиск файла/каталога по имени
Ctrl+V      - вставка из буфера (paste)
Shift+F6    - переименовать файл в текущем каталоге
    '
}

_usage_tmux() {
more <