+++ /dev/null
-.\" 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.