spectrwm_pt.1

.\" 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 SPECTRWM 1
.Os
.Sh NOME
.Nm spectrwm
.Nd gerenciador de janela para o X11
.Sh SINOPSE
.Nm spectrwm
.Sh DESCRI\(,C\(~AO
.Nm
\('e um gerenciador de janela minimalista que tenta n\(~ao atrapalhar a
valorosa forma real da tela para que essa possa
ser usada para coisas muito mais importantes.
Tem sensatos defaults e n\(~ao requer que algu\('em aprenda uma linguagem de
programa\(,c\(~ao para fazer qualquer configura\(,c\(~ao.
Ele foi escrito por hackers para hackers e esfor\(,ca-se em ser pequeno, compacto e 
r\('apido.
.Pp
Quando o
.Nm
inicia, ele l\(^e as configura\(,c\(~oes do seu arquivo de configura\(,c\(~ao,
.Pa spectrwm.conf .
Veja a se\(,c\(~ao
.Sx ARQUIVOS DE CONFIGURA\(,C\(~AO
logo abaixo.
.Pp
A seguinte nota\(,c\(~ao \('e usada por toda essa p\('agina:
.Pp
.Bl -tag -width Ds -offset indent -compact
.It Cm M
Meta
.It Cm S
Shift
.It Aq Cm Name
Nome da tecla
.It Cm M1
Bot\(~ao 1 do mouse
.It Cm M3
Bot\(~ao 3 do mouse
.El
.Pp
.Nm
\('e muito simples de usar.
Muitas das a\(,c\(~oes s\(~ao iniciadas por atalhos do mouse ou do teclado.
Veja a se\(,c\(~ao
.Sx ATALHOS
logo abaixo para os defaults e as personaliza\(,c\(~oes.
.Sh ARQUIVOS DE CONFIGURA\(,C\(~AO
.Nm
primeiro tenta abrir o arquivo de configura\(,c\(~ao no diret\('orio do usu\('ario,
.Pa ~/.spectrwm.conf .
Se o arquivo n\(~ao estiver dispon\('ivel, ent\(~ao tenta abrir o arquivo de
configura\(,c\(~ao global
.Pa /etc/spectrwm.conf .
.Pp
Assim \('e o formato do arquivo:\*(Ltpalavra-chave\*(Gt = \*(Ltconfigura\(,c\(~ao\*(Gt.
Por exemplo:
.Pp
.Dl color_focus = red
.Pp
Para habilitar ou desabilitar uma op\(,c\(~ao usa-se o 1 ou 0, respectivamente. 
.Pp
O arquivo suporta as seguintes palavras-chave:
.Pp
.Bl -tag -width "title_class_enabledXXX" -offset indent -compact
.It Cm color_focus
Cor da borda da janela atualmente focada.
.It Cm color_unfocus
Cor da borda das janelas fora de foco.
.It Cm bar_enabled
Habilita ou desabilita a barra de status.
.It Cm bar_border Ns Bq Ar x
Cor da borda da barra de status na tela
.Ar x .
.It Cm bar_color Ns Bq Ar x
Cor da janela da barra de status na tela
.Ar x .
.It Cm bar_font_color Ns Bq Ar x
Cor da fonte na barra de status na tela
.Ar x .
.It Cm bar_font
Fonte da barra de status.
.It Cm bar_action
Script externo que preenche a barra de status com informa\(,c\(~oes adicionais,
como tempo de vida da bateria.
.It Cm bar_at_bottom
Coloca a barra de status na parte inferior de cada regi\(~ao, ao inv\('es da parte superior.
.It Cm stack_enabled
Habilita ou desabilita mostrar o atual algor\('itmo de empilhamento na barra de status.
.It Cm clock_enabled
Habilita ou desabilita mostrar o rel\('ogio na barra de status.
Desabilite configurando para 0, ent\(~ao um rel\('ogio personalizado pode ser usado no
script bar_action.
.It Cm dialog_ratio
Algumas aplica\(,c\(~oes tem janelas de di\('alogo que s\(~ao muito pequenas para serem \('uteis.
Essa taxa \('e o tamanho da tela para o qual elas ser\(~ao redimencionadas.
Por exemplo, 0.6 equivale a 60% do tamanho da tela f\('isica.
.It Cm region
Aloca uma regi\(~ao personalizada, removendo qualquer regi\(~ao automaticamente detectada
que ocupe o mesmo espa\(,co na tela.
Definido no formato screen[<idx>]:WIDTHxHEIGHT+X+Y,
e.g.\& screen[1]:800x1200+0+0.
.It Cm term_width
Configura a largura m\('inima preferida para o terminal
Se esse valor for maior do que 0,
.Nm
vai tentar ajustar os tamanhos da fonte no terminal para manter a largura
do terminal acima desse n\('umero enquanto a janela \('e redimencionada.
Apenas o
.Xr xterm 1
\('e suportado atualmente.
O bin\('ario do
.Xr xterm 1
n\(~ao deve ser setuid ou setgid, que \('e o default em muitos sistemas.
Os usu\('arios podem precisar de configurar program[term] (veja a se\(,c\(~ao
.Sx PROGRAMAS
) para usar uma c\('opia alternativa do bin\('ario do
.Xr xterm 1
sem o bit setgid ativado.
.It Cm title_class_enabled
Habilita ou desabilita mostrar a classe da janela na barra de status.
Habilite configurando para 1.
.It Cm title_name_enabled
Habilita ou desabilita mostrar o t\('itulo da janela na barra de status.
Habilite configurando para 1.
.It Cm window_name_enabled
Habilita ou desabilita mostrar a nome da janela na barra de status.
Habilite configurando para 1.
.It Cm modkey
Muda a tecla de modifica\(,c\(~ao.
Mod1 \('e geralmente a tecla ALT e Mod4 \('e a tecla windows em um PC.
.It Cm focus_mode
Usar um valor de follow_cursor vai fazer o gerenciador de janela focar
a janela sob o mouse quando trocando \('areas de trabalho e criando janelas.
.It Cm disable_border
Remove a borda quando a barra estiver desabilitada e houver apenas uma janela na tela.
.It Cm program Ns Bq Ar p
Define uma nova a\(,c\(~ao para executar um programa
.Ar p .
Veja a se\(,c\(~ao
.Sx PROGRAMAS
logo abaixo.
.It Cm bind Ns Bq Ar x
Cria uma combina\(,c\(~ao de teclas de atalho para a a\(,c\(~ao
.Ar x .
Veja a se\(,c\(~ao 
.Sx ATALHOS
logo abaixo.
.It Cm quirk Ns Bq Ar c:n
Adicione "quirk" para janelas com classe
.Ar c
e nome
.Ar n .
Veja a se\(,c\(~ao
.Sx QUIRKS
logo abaixo.
.El
.Pp
Cores precisam ser especificadas pela especifica\(,c\(~ao
.Xr XQueryColor 3
e fontes pela especifica\(,c\(~ao
.Xr XQueryFont 3 .
.Pp
Para listar as fontes dispon\('iveis em seu sistema veja o manual do
.Xr fc-list 1
ou do
.Xr xlsfonts 1 .
A aplica\(,c\(~ao 
.Xr xfontsel 1
pode te ajudar a mostrar a X Logical Font Description ("XLFD") usada na
configura\(,c\(~ao da palavra-chave bar_font.
.Sh PROGRAMAS
.Nm
te permite definir a\(,c\(~oes personalizadas para executar programas de sua escolha
e ent\(~ao criar um atalho para elas da mesma forma que as a\(,c\(~oes embutidas.
Veja a se\(,c\(~ao
.Sx ATALHOS
logo abaixo.
.Pp
Os programas default s\(~ao descritos abaixo:
.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
Programas personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
.Pp
.Dl program[<name>] = <progpath> [<arg> [... <arg>]]
.Pp
.Aq name
\('e um identificador qualquer que n\(~ao conflite com uma a\(,c\(~ao ou palavra-chave embutida,
.Aq progpath
\('e o programa desejado, e
.Aq arg
\('e zero ou mais argumentos para o programa.
.Pp
As seguintes vari\('aveis representam valores configur\('aveis no
.Nm
(veja a se\(,c\(~ao
.Sx ARQUIVOS DE CONFIGURA\(,C\(~AO
logo acima),
e podem ser usadas nos campos
.Aq arg
e ser\(~ao substitu\('idas pelos valores na hora em que o programa for executado:
.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
Exemplo:
.Bd -literal -offset indent
program[ff] = /usr/local/bin/firefox http://spectrwm.org/
bind[ff] = Mod+f # Agora Mod+F executa o firefox
.Ed
.Pp
Para desfazer a configura\(,c\(~ao anterior:
.Bd -literal -offset indent
bind[] = Mod+f
program[ff] =
.Ed
.Pp
.Sh ATALHOS
.Nm
prov\(^e muitas fun\(,c\(~oes (ou a\(,cões) acessadas pelos atalhos do teclado ou do mouse.
.Pp
Os atuais atalhos do mouse s\(~ao descritos abaixo:
.Pp
.Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
.It Cm M1
Foca a janela
.It Cm M-M1
Move a janela
.It Cm M-M3
Redimenciona a janela
.It Cm M-S-M3
Redimenciona a janela enquanto a mant\('em centralizada
.El
.Pp
Os atalhos default do teclado s\(~ao descritos abaixo:
.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-a
ws_prior
.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
Os nomes das a\(,c\(~oes e suas descri\(,cões est\(~ao listados abaixo:
.Pp
.Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
.It Cm term
Executa um novo terminal
(veja a se\(,c\(~ao
.Sx PROGRAMAS
logo acima)
.It Cm menu
Menu
(veja a se\(,c\(~ao
.Sx PROGRAMAS
logo acima)
.It Cm quit
Sair
.Nm
.It Cm restart
Reiniciar
.Nm
.It Cm cycle_layout
Circula entre os poss\('iveis layouts
.It Cm reset_layout
Reinicia o layout
.It Cm master_shrink
Encolhe a \('area mestre
.It Cm master_grow
Aumenta a \('area mestre
.It Cm master_add
Adiciona janelas na \('area mestre
.It Cm master_del
Remove janelas da \('area mestre
.It Cm stack_inc
Adiciona colunas/linhas para a \('area de empilhamento
.It Cm stack_del
Remove colunas/linhas da \('area de empilhamento
.It Cm swap_main
Move a janela atual para a \('area mestre
.It Cm focus_next
Foca a pr\('oxima janela da \('area de trabalho
.It Cm focus_prev
Foca a janela anterior da \('area de trabalho
.It Cm focus_main
Foca a janela principal da \('area de trabalho
.It Cm swap_next
Troca com a pr\('oxima janela da \('area de trabalho
.It Cm swap_prev
Troca com a janela anterior da \('area de trabalho
.It Cm bar_toggle
Ativa/desativa a barra de status em todas as \('areas de trabalho
.It Cm wind_del
Apaga a janela atual da \('area de trabalho
.It Cm wind_kill
Destr\('oi a janela atual da \('area de trabalho
.It Cm ws_ Ns Ar n
Troca para a \('area de trabalho
.Ar n ,
onde
.Ar n
vai de 1 at\('e 10
.It Cm mvws_ Ns Ar n
Move a janela atual para a \('area de trabalho
.Ar n ,
onde
.Ar n
vai de 1 at\('e 10
.It Cm ws_next
Troca para a pr\('oxima \('area de trabalho que possua uma janela
.It Cm ws_prev
Troca para a \('area de trabalho anterior que possua uma janela
.It Cm ws_prior
Troca para a \('ultima \('area de trabalho visitada
.It Cm screen_next
Move o ponteiro para a pr\('oxima regi\(~ao
.It Cm screen_prev
Move o ponteiro para a regi\(~ao anterior
.It Cm screenshot_all
Tira screenshot da tela inteira (se habilitado)
(veja a se\(,c\(~ao
.Sx PROGRAMAS
logo acima)
.It Cm screenshot_wind
Tira screenshot da janela selecionada (se habilitado)
(veja a se\(,c\(~ao
.Sx PROGRAMAS
logo acima)
.It Cm version
Ativa/desativa a vers\(~ao na barras de status
.It Cm float_toggle
Troca o estado da janela focada entre flutuante e tiled
.It Cm lock
Trava a tela
(veja a se\(,c\(~ao
.Sx PROGRAMAS
logo acima)
.It Cm initscr
Reinicializa as telas f\('isicas
(veja a se\(,c\(~ao
.Sx PROGRAMAS
logo acima)
.El
.Pp
Atalhos personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
.Pp
.Dl bind[<action>] = <keys>
.Pp
.Aq action
\('e uma das a\(,c\(~oes listadas acima (ou vazio) e
.Aq keys
est\('a na forma de zero ou mais teclas de modifica\(,c\(~ao
(MOD, Mod1, Shift, etc.) e uma ou mais teclas normais
(b, space, etc.), separadas pelo "+".
Por exemplo:
.Bd -literal -offset indent
bind[reset] = Mod4+q # combina a tecla Windows + q para reiniciar
bind[] = Mod1+q # desfaz a combina\(,c\(~ao Alt + q
.Ed
.Pp
M\('ultiplas combina\(,c\(~oes de teclas podem ser usadas para a mesma a\(,c\(~ao.
.Sh QUIRKS
.Nm
prov\(^e "quirks" que manipulam janelas que devem ser tratadas especialmente
em um gerenciador de janela "tiling", tal como algumas aplica\(,c\(~oes de
di\('alogos e tela cheia.
.Pp
Os quirks default est\(~ao descritos abaixo:
.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
Os quirks em si est\(~ao descritos abaixo:
.Pp
.Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
.It FLOAT
Esta janela n\(~ao deve ser "tiled", mas permitida a flutuar livremente.
.It TRANSSZ
Ajusta o tamanho das janelas transit\('orias que sejam muito pequenas
usando dialog_ratio 
(veja a se\(,c\(~ao
.Sx ARQUIVOS DE CONFIGURA\(,C\(~AO ) .
.It ANYWHERE
Permite que a janela posicione a si mesma, n\(~ao-centrada.
.It XTERM_FONTADJ
Ajusta as fontes do xterm quando redimencionando.
.It FULLSCREEN
Remove a borda para permitir a janela usar todo o tamanho da tela.
.El
.Pp
Quirks personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
.Pp
.Dl quirk[<class>:<name>] = <quirk> [ + <quirk> ... ]
.Pp
.Aq class
e
.Aq name
especificam a janela ao qual o quirk se aplica, e
.Aq quirk
\('e um dos quirks da lista acima.
Por exemplo:
.Bd -literal -offset indent
quirk[MPlayer:xv] = FLOAT + FULLSCREEN # faz o mplayer tocar livremente
quirk[pcb:pcb] = NONE  # remove quirk existente
.Ed
.Pp
Voc\(^e pode obter
.Aq class
e
.Aq name
executando o xprop(1) e ent\(~ao clicando na janela desejada.
No seguinte exemplo a jenela principal do Firefox foi clicada:
.Bd -literal -offset indent
$ xprop | grep WM_CLASS
WM_CLASS(STRING) = "Navigator", "Firefox"
.Ed
.Pp
Note que usando o grep(1) para WM_CLASS voc\(^e obt\('em class e name. 
No exemplo acima a configura\(,c\(~ao do quirk poderia ser:
.Bd -literal -offset indent
quirk[Firefox:Navigator] = FLOAT
.Ed
.Sh SINAIS
Enviar ao
.Nm
um sinal HUP far\('a com que o mesmo seja reiniciado.
.Sh ARQUIVOS
.Bl -tag -width "/etc/spectrwm.confXXX" -compact
.It Pa ~/.spectrwm.conf
Configura\(,c\(~oes espec\('ificas do usu\('ario.
.It Pa /etc/spectrwm.conf
Configura\(,c\(~oes globais.
.El
.Sh HIST\('ORIA
.Nm
foi inspirado pelo xmonad & dwm.
.Sh AUTORES
.An -nosplit
.Pp
.Nm
foi escrito por
.An Marco Peereboom Aq marco@peereboom.us ,
.An Ryan Thomas McBride Aq mcbride@countersiege.com
e
.An Darrin Chandler Aq dwchandler@stilyagin.com .
.Sh BUGS
Atualmente o menu, invocado com
.Cm M-p ,
depende do dmenu.