--- /dev/null
+.\" $scrotwm$
+.\"
+.\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
+.\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate$
+.Dt SCROTWM 1
+.Os
+.Sh НАЗВАНИЕ
+.Nm scrotwm
+.Nd Оконный менеджер для X11
+.Sh ИСПОЛЬЗОВАНИЕ
+.Nm scrotwm
+.Sh ОПИСАНИЕ
+.Nm
+это минималистичный менеджер окон, ставящий своей целью не мешать вам и не
+занимать ценное пространство экрана. Его настройки по-умолчанию разумны и,
+кроме того, он не требует знания языков программирования для работы с
+конфигурационным файлом. Он написан хакерами для хакеров и старается быть
+легким, компактным и быстрым.
+.Pp
+Когда
+.Nm
+запускается, он читает настройки из своего конфигурационного файла,
+.Pa scrotwm.conf .
+Смотрите секцию
+.Sx КОНФИГУРАЦИОННЫЕ ФАЙЛЫ
+ниже.
+.Pp
+На этой странице используются следующие обозначения:
+.Pp
+.Bl -tag -width Ds -offset indent -compact
+.It Cm M
+Мета-клавиша
+.It Cm S
+Shift
+.It Aq Cm Name
+Имя клавиши
+.It Cm M1
+Кнопка мыши 1
+.It Cm M3
+Кнопка мыши 3
+.El
+.Pp
+.Nm
+должен быть понятным и очевидным.
+Большинство действий выполняется комбинациями клавиш.
+Смотрите секцию
+.Sx ПРИВЯЗКИ
+ниже, чтобы узнать о стандартных настройках.
+.Sh КОНФИГУРАЦИОННЫЕ ФАЙЛЫ
+.Nm
+пытается прочитать файл в домашнем каталоге,
+.Pa ~/.scrotwm.conf .
+В случае, если он недоступен,
+происходит обращение к глобальному файлу настроек,
+.Pa /etc/scrotwm.conf .
+.Pp
+Формат файла следующий: \*(Ltключ\*(Gt = \*(Ltзначение\*(Gt.
+Например:
+.Pp
+.Dl color_focus = red
+.Pp
+Однозначное включение и выключение задается значениями 1 и 0.
+.Pp
+Поддерживаются следующие ключевые слова:
+.Pp
+.Bl -tag -width "title_class_enabledXXX" -offset indent -compact
+.It Cm color_focus
+Цвет рамки окна в фокусе.
+.It Cm color_unfocus
+Цвет рамки окон не в фокусе.
+.It Cm bar_enabled
+Включение статусной строки.
+.It Cm bar_border Ns Bq Ar x
+Цвет рамки статусной строки
+.Ar x .
+.It Cm bar_color Ns Bq Ar x
+Цвет статусной строки
+.Ar x .
+.It Cm bar_font_color Ns Bq Ar x
+Цвет шрифта статусной строки
+.Ar x .
+.It Cm bar_font
+Тип шрифта статусной строки.
+.It Cm bar_action
+Внешний файл скрипта для статусной строки, выводящий туда информацию,
+например, уровень заряда батарей.
+.It Cm bar_delay
+Частота выполнения внешнего скрипта статусной строки, секунды.
+.It Cm stack_enabled
+Включить отображение способа укладки окон в статусной строке.
+.It Cm clock_enabled
+Включить часы в статусной строке.
+Можно отключить, установив 0, и Вы сможете использовать
+собственные часы из внешнего скрипта.
+.It Cm dialog_ratio
+Ряд приложений имеет слишком маленькие диалоговые окна.
+Это значение - доля размера экрана, к которой они будут приведены.
+Например, значение 0.6 будет соответствовать 60% от реального размера экрана.
+.It Cm region
+Выделяет область экрана на Ваше усмотрение, уничтожает все перекрытые области
+экрана, определенные автоматически.
+Формат: screen[<idx>]:WIDTHxHEIGHT+X+Y,
+например\& screen[1]:1280x800+0+0.
+.It Cm term_width
+Установить минимальную допустимую ширину эмулятора терминала.
+Если это значение больше 0,
+.Nm
+попытается отмасштабировать шрифты в терминале, чтобы ширина
+была больше этого значения
+.
+Поодерживается только
+.Xr xterm 1
+.
+Также
+.Xr xterm 1
+не может быть с setuid или setgid, хотя это так на многих системах.
+Возможно необходимо задать program[term] (Смотрите секцию
+.Sx ПРОГРАММЫ
+) чтобы использовалась другая копия
+.Xr xterm 1
+без заданного бита setgid.
+.It Cm title_class_enabled
+Отображать класс окна в статусной строке.
+Обычно выключено
+.It Cm title_name_enabled
+Отображать заголовок окна в статусной строке.
+Обычно выключено
+.It Cm modkey
+Назначить Мета-клавишу, клавишу-модификатор.
+Mod1 соответствует клавише ALT, а Mod4 соответствует клавише WIN на PC.
+.It Cm program Ns Bq Ar p
+Добавить пользовательскую программу для назначения привязки
+.Ar p .
+Смотрите секцию
+.Sx ПРОГРАММЫ
+ниже.
+.It Cm bind Ns Bq Ar x
+Назначить привязку на действие
+.Ar x .
+Смотрите секцию
+.Sx ПРИВЯЗКИ
+ниже.
+.It Cm quirk Ns Bq Ar c:n
+Добавить костыль для окон с классом
+.Ar c
+и именем
+.Ar n .
+Смотрите секцию
+.Sx КОСТЫЛИ
+ниже.
+.El
+.Pp
+Цвета задаются с помощью
+.Xr XQueryColor 3
+А шрифты задаются с использованием
+.Xr XQueryFont 3
+.
+.Sh ПРОГРАММЫ
+.Nm
+позволяет Вам добавлять Ваши собственные действия для запуска
+программ и делать к ним привязки как ко всем остальным действиям
+Смотрите секцию
+.Sx ПРИВЯЗКИ
+ниже.
+.Pp
+Стандартные программы:
+.Pp
+.Bl -tag -width "screenshot_wind" -offset indent -compact
+.It Cm term
+xterm
+.It Cm screenshot_all
+screenshot.sh full
+.It Cm screenshot_wind
+screenshot.sh window
+.It Cm lock
+xlock
+.It Cm initscr
+initscreen.sh
+.It Cm menu
+dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
+.El
+.Pp
+Ваши собственные программы задаются следующим образом:
+.Pp
+.Dl program[<name>] = <progpath> [<arg> [... <arg>]]
+.Pp
+.Aq name
+это любой идентификатор, не мешающийся с уже существующими,
+.Aq progpath
+это собственно путь к программе,
+.Aq arg
+это список передаваемых аргументов или оставьте пустым.
+.Pp
+Следующие переменные можно получать из
+.Nm
+(Смотрите секцию
+.Sx КОНФИГУРАЦИОННЫЕ ФАЙЛЫ
+выше),
+и их можно использовать как
+.Aq arg
+(в момент запуска программы будет выполнена подстановка значений):
+.Pp
+.Bl -tag -width "$bar_font_color" -offset indent -compact
+.It Cm $bar_border
+.It Cm $bar_color
+.It Cm $bar_font
+.It Cm $bar_font_color
+.It Cm $color_focus
+.It Cm $color_unfocus
+.El
+.Pp
+Например:
+.Bd -literal -offset indent
+program[ff] = /usr/local/bin/firefox http://scrotwm.org/
+bind[ff] = Mod+f # Значит Mod+F запускает firefox
+.Ed
+.Pp
+Чтобы отменить назначение:
+.Bd -literal -offset indent
+bind[] = Mod+f
+program[ff] =
+.Ed
+.Pp
+.Sh ПРИВЯЗКИ
+.Nm
+предоставляет доступ к действиям с помощью клавиатурных комбинаций.
+.Pp
+Установленные привязки для мыши:
+.Pp
+.Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
+.It Cm M1
+Сфокусироваться на окне
+.It Cm M-M1
+Переместить окно
+.It Cm M-M3
+Изменить размер окна
+.It Cm M-S-M3
+Изменить размер окна, удерживая его в центре
+.El
+.Pp
+Стандартные клавиатурные привязки:
+.Pp
+.Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
+.It Cm M-S- Ns Aq Cm Return
+term
+.It Cm M-p
+menu
+.It Cm M-S-q
+quit
+.It Cm M-q
+restart
+.Nm
+.It Cm M- Ns Aq Cm Space
+cycle_layout
+.It Cm M-S- Ns Aq Cm Space
+reset_layout
+.It Cm M-h
+master_shrink
+.It Cm M-l
+master_grow
+.It Cm M-,
+master_add
+.It Cm M-.
+master_del
+.It Cm M-S-,
+stack_inc
+.It Cm M-S-.
+stack_del
+.It Cm M- Ns Aq Cm Return
+swap_main
+.It Xo
+.Cm M-j ,
+.Cm M- Ns Aq Cm TAB
+.Xc
+focus_next
+.It Xo
+.Cm M-k ,
+.Cm M-S- Ns Aq Cm TAB
+.Xc
+focus_prev
+.It Cm M-m
+focus_main
+.It Cm M-S-j
+swap_next
+.It Cm M-S-k
+swap_prev
+.It Cm M-b
+bar_toggle
+.It Cm M-x
+wind_del
+.It Cm M-S-x
+wind_kill
+.It Cm M- Ns Aq Ar n
+.Ns ws_ Ns Ar n
+.It Cm M-S- Ns Aq Ar n
+.Ns mvws_ Ns Ar n
+.It Cm M- Ns Aq Cm Right
+ws_next
+.It Cm M- Ns Aq Cm Left
+ws_prev
+.It Cm M-S- Ns Aq Cm Right
+screen_next
+.It Cm M-S- Ns Aq Cm Left
+screen_prev
+.It Cm M-s
+screenshot_all
+.It Cm M-S-s
+screenshot_wind
+.It Cm M-S-v
+version
+.It Cm M-t
+float_toggle
+.It Cm M-S Aq Cm Delete
+lock
+.It Cm M-S-i
+initscr
+.El
+.Pp
+Описания действий перечислены ниже:
+.Pp
+.Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
+.It Cm term
+Запустить эмулятор терминала
+(Смотрите секцию
+.Sx ПРОГРАММЫ
+выше)
+.It Cm menu
+Меню
+(Смотрите секцию
+.Sx ПРОГРАММЫ
+выше)
+.It Cm quit
+Выйти
+.Nm
+.It Cm restart
+Перезапустить
+.Nm
+.It Cm cycle_layout
+Менять укладку окон
+.It Cm reset_layout
+Стандартная укладка
+.It Cm master_shrink
+Сжать область главного окна
+.It Cm master_grow
+Расширить область главного окна
+.It Cm master_add
+Добавить окна в главную область
+.It Cm master_del
+Убрать окна из главной области
+.It Cm stack_inc
+Увеличить число столбцов или рядов в текущей укладке
+.It Cm stack_del
+Уменьшить число столбцов или рядов в текущей укладке
+.It Cm swap_main
+Отправить текущее окно в главную область, сделать главным
+.It Cm focus_next
+Фокусироваться на следующем окне
+.It Cm focus_prev
+Фокусироваться на предыдущем окне
+.It Cm focus_main
+Фокусироваться на главном окне
+.It Cm swap_next
+Поменять со следующим окном
+.It Cm swap_prev
+Поменять со предыдущим окном
+.It Cm bar_toggle
+Выключить статусную строку на всех рабочих столах
+.It Cm wind_del
+Закрыть фокусированное окно
+.It Cm wind_kill
+Грохнуть фокусированное окно
+.It Cm ws_ Ns Ar n
+Переключиться на рабочий стол
+.Ar n ,
+где
+.Ar n
+от 1 до 10
+.It Cm mvws_ Ns Ar n
+Переместить фокусированное окно в рабочий стол
+.Ar n ,
+где
+.Ar n
+от 1 до 10
+.It Cm ws_next
+Перейти к следующему не пустому рабочему столу
+.It Cm ws_prev
+Перейти к следующему не пустому рабочему столу
+.It Cm screen_next
+Переместить указатель в следующую область
+.It Cm screen_prev
+Переместить указатель в следующую область
+.It Cm screenshot_all
+Сделать снимок всего экрана (если возможно)
+(Смотрите секцию
+.Sx ПРОГРАММЫ
+выше)
+.It Cm screenshot_wind
+Сделать снимок окна (если возможно)
+(Смотрите секцию
+.Sx ПРОГРАММЫ
+выше)
+.It Cm version
+Показать версию в статусной строке
+.It Cm float_toggle
+Переключить окно в фокусе в плавающий режим, float
+.It Cm lock
+Заблокировать экран
+(Смотрите секцию
+.Sx ПРОГРАММЫ
+выше)
+.It Cm initscr
+Инициализировать экран еще раз
+(Смотрите секцию
+.Sx ПРОГРАММЫ
+выше)
+.El
+.Pp
+Собственные привязки назначаются следующим образом:
+.Pp
+.Dl bind[<action>] = <keys>
+.Pp
+.Aq action
+это действие из списка программ
+.Aq keys
+это не более одной клавиши-модификатора
+(MOD, Mod1, Shift, и.т.п.) и обычные клавиши
+(b, space, и.т.п.), разделенные "+".
+Например:
+.Bd -literal -offset indent
+bind[reset] = Mod4+q # назначить WIN + q на действие reset
+bind[] = Mod1+q # снять все действия с Alt + q
+.Ed
+.Pp
+На одно действие можно назначить несколько комбинаций.
+.Sh КОСТЫЛИ
+.Nm
+позволяет настроить костыли, нужные для специальной работы scrotwm
+с рядом приложений, который вы определяете сами. То есть, Вы можете
+принудительно установить способ тайлинга для какого-нибудь приложения
+.Pp
+Список стандартных костылей:
+.Pp
+.Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
+.It Firefox\-bin:firefox\-bin
+TRANSSZ
+.It Firefox:Dialog
+FLOAT
+.It Gimp:gimp
+FLOAT + ANYWHERE
+.It MPlayer:xv
+FLOAT + FULLSCREEN
+.It OpenOffice.org 2.4:VCLSalFrame
+FLOAT
+.It OpenOffice.org 3.1:VCLSalFrame
+FLOAT
+.It pcb:pcb
+FLOAT
+.It xine:Xine Window
+FLOAT + ANYWHERE
+.It xine:xine Panel
+FLOAT + ANYWHERE
+.It xine:xine Video Fullscreen Window
+FULLSCREEN + FLOAT
+.It Xitk:Xitk Combo
+FLOAT + ANYWHERE
+.It Xitk:Xine Window
+FLOAT + ANYWHERE
+.It XTerm:xterm
+XTERM_FONTADJ
+.El
+.Pp
+Описание:
+.Pp
+.Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
+.It FLOAT
+Такое окно не нужно тайлить вообще, разрешить ему float
+.It TRANSSZ
+Тразиентое окно
+(Смотрите секцию
+.Sx КОНФИГУРАЦИОННЫЕ ФАЙЛЫ) .
+.It ANYWHERE
+Позволить окну самостоятельно выбрать местоположение
+.It XTERM_FONTADJ
+Изменять шрифты xterm при изменении размеров окна
+.It FULLSCREEN
+Позволить окну запускаться в полноэкранном режиме
+.El
+.Pp
+Назначать костыли можно следующим образом:
+.Pp
+.Dl quirk[<class>:<name>] = <quirk> [ + <quirk> ... ]
+.Pp
+.Aq class
+и
+.Aq name
+определяют к какому окну будет применяться костыль, а
+.Aq quirk
+один из вышеперечисленных способов.
+Например:
+.Bd -literal -offset indent
+quirk[MPlayer:xv] = FLOAT + FULLSCREEN # mplayer настроен
+quirk[pcb:pcb] = NONE # убрать существующий костыль
+.Ed
+.Pp
+Вы можете узнать
+.Aq class
+и
+.Aq name
+запустив xprop и нажав в интересующее окно.
+Вот как будет выглядеть вывод для Firefox:
+.Bd -literal -offset indent
+$ xprop | grep WM_CLASS
+WM_CLASS(STRING) = "Navigator", "Firefox"
+.Ed
+.Pp
+Обратите внимание, класс и имя меняются местами,
+правильный костыль будет выглядеть так:
+.Bd -literal -offset indent
+quirk[Firefox:Navigator] = FLOAT
+.Ed
+.Sh ФАЙЛЫ
+.Bl -tag -width "/etc/scrotwm.confXXX" -compact
+.It Pa ~/.scrotwm.conf
+.Nm
+Личные настройки пользователя.
+.It Pa /etc/scrotwm.conf
+.Nm
+Глобавльные настройки.
+.El
+.Sh ИСТОРИЯ
+.Nm
+идейно основан на dwm и xmonad
+.Sh АВТОРЫ
+.An -nosplit
+.Pp
+.Nm
+написан:
+.An Marco Peereboom Aq marco@peereboom.us ,
+.An Ryan Thomas McBride Aq mcbride@countersiege.com
+and
+.An Darrin Chandler Aq dwchandler@stilyagin.com .
+.Sh БАГИ
+При вызове меню с помощью
+.Cm M-p ,
+необходима корректная работа dmenu.
Got questions, comments, patches, etc.? Contact Jason Woofenden