3 .\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
4 .\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
6 .\" Permission to use, copy, modify, and distribute this software for any
7 .\" purpose with or without fee is hereby granted, provided that the above
8 .\" copyright notice and this permission notice appear in all copies.
10 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
23 .Nd gerenciador de janela para o X11
28 \('e um gerenciador de janela minimalista que tenta n\(~ao atrapalhar a
29 valorosa forma real da tela para que essa possa
30 ser usada para coisas muito mais importantes.
31 Tem sensatos defaults e n\(~ao requer que algu\('em aprenda uma linguagem de
32 programa\(,c\(~ao para fazer qualquer configura\(,c\(~ao.
33 Ele foi escrito por hackers para hackers e esfor\(,ca-se em ser pequeno, compacto e
38 inicia, ele l\(^e as configura\(,c\(~oes do seu arquivo de configura\(,c\(~ao,
41 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO
44 A seguinte nota\(,c\(~ao \('e usada por toda essa p\('agina:
46 .Bl -tag -width Ds -offset indent -compact
60 \('e muito simples de usar.
61 Muitas das a\(,c\(~oes s\(~ao iniciadas por atalhos do mouse ou do teclado.
64 logo abaixo para os defaults e as personaliza\(,c\(~oes.
65 .Sh ARQUIVOS DE CONFIGURA\(,C\(~AO
67 primeiro tenta abrir o arquivo de configura\(,c\(~ao no diret\('orio do usu\('ario,
69 Se o arquivo n\(~ao estiver dispon\('ivel, ent\(~ao tenta abrir o arquivo de
70 configura\(,c\(~ao global
71 .Pa /etc/scrotwm.conf .
73 Assim \('e o formato do arquivo:\*(Ltpalavra-chave\*(Gt = \*(Ltconfigura\(,c\(~ao\*(Gt.
78 Para habilitar ou desabilitar uma op\(,c\(~ao usa-se o 1 ou 0, respectivamente.
80 O arquivo suporta as seguintes palavras-chave:
82 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
84 Cor da borda da janela atualmente focada.
86 Cor da borda das janelas fora de foco.
88 Habilita ou desabilita a barra de status.
89 .It Cm bar_border Ns Bq Ar x
90 Cor da borda da barra de status na tela
92 .It Cm bar_color Ns Bq Ar x
93 Cor da janela da barra de status na tela
95 .It Cm bar_font_color Ns Bq Ar x
96 Cor da fonte na barra de status na tela
99 Fonte da barra de status.
101 Script externo que preenche a barra de status com informa\(,c\(~oes adicionais,
102 como tempo de vida da bateria.
104 Freq\(:u\(^encia da atualiza\(,c\(~ao, em segundos, do script externo que preenche
107 Coloca a barra de status na parte inferior de cada regi\(~ao, ao inv\('es da parte superior.
109 Habilita ou desabilita mostrar o atual algor\('itmo de empilhamento na barra de status.
111 Habilita ou desabilita mostrar o rel\('ogio na barra de status.
112 Desabilite configurando para 0, ent\(~ao um rel\('ogio personalizado pode ser usado no
115 Algumas aplica\(,c\(~oes tem janelas de di\('alogo que s\(~ao muito pequenas para serem \('uteis.
116 Essa taxa \('e o tamanho da tela para o qual elas ser\(~ao redimencionadas.
117 Por exemplo, 0.6 equivale a 60% do tamanho da tela f\('isica.
119 Aloca uma regi\(~ao personalizada, removendo qualquer regi\(~ao automaticamente detectada
120 que ocupe o mesmo espa\(,co na tela.
121 Definido no formato screen[<idx>]:WIDTHxHEIGHT+X+Y,
122 e.g.\& screen[1]:800x1200+0+0.
124 Configura a largura m\('inima preferida para o terminal
125 Se esse valor for maior do que 0,
127 vai tentar ajustar os tamanhos da fonte no terminal para manter a largura
128 do terminal acima desse n\('umero enquanto a janela \('e redimencionada.
131 \('e suportado atualmente.
134 n\(~ao deve ser setuid ou setgid, que \('e o default em muitos sistemas.
135 Os usu\('arios podem precisar de configurar program[term] (veja a se\(,c\(~ao
137 ) para usar uma c\('opia alternativa do bin\('ario do
139 sem o bit setgid ativado.
140 .It Cm title_class_enabled
141 Habilita ou desabilita mostrar a classe da janela na barra de status.
142 Habilite configurando para 1.
143 .It Cm title_name_enabled
144 Habilita ou desabilita mostrar o t\('itulo da janela na barra de status.
145 Habilite configurando para 1.
147 Muda a tecla de modifica\(,c\(~ao.
148 Mod1 \('e geralmente a tecla ALT e Mod4 \('e a tecla windows em um PC.
150 Usar um valor de follow_cursor vai fazer o gerenciador de janela focar
151 a janela sob o mouse quando trocando \('areas de trabalho e criando janelas.
152 .It Cm disable_border
153 Remove a borda quando a barra estiver desabilitada e houver apenas uma janela na tela.
154 .It Cm program Ns Bq Ar p
155 Define uma nova a\(,c\(~ao para executar um programa
160 .It Cm bind Ns Bq Ar x
161 Cria uma combina\(,c\(~ao de teclas de atalho para a a\(,c\(~ao
166 .It Cm quirk Ns Bq Ar c:n
167 Adicione "quirk" para janelas com classe
176 Cores precisam ser especificadas pela especifica\(,c\(~ao
178 e fontes pela especifica\(,c\(~ao
181 Para listar as fontes dispon\('iveis em seu sistema veja o manual do
187 pode te ajudar a mostrar a X Logical Font Description ("XLFD") usada na
188 configura\(,c\(~ao da palavra-chave bar_font.
191 te permite definir a\(,c\(~oes personalizadas para executar programas de sua escolha
192 e ent\(~ao criar um atalho para elas da mesma forma que as a\(,c\(~oes embutidas.
197 Os programas default s\(~ao descritos abaixo:
199 .Bl -tag -width "screenshot_wind" -offset indent -compact
202 .It Cm screenshot_all
204 .It Cm screenshot_wind
211 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
214 Programas personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
216 .Dl program[<name>] = <progpath> [<arg> [... <arg>]]
219 \('e um identificador qualquer que n\(~ao conflite com uma a\(,c\(~ao ou palavra-chave embutida,
221 \('e o programa desejado, e
223 \('e zero ou mais argumentos para o programa.
225 As seguintes vari\('aveis representam valores configur\('aveis no
228 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO
230 e podem ser usadas nos campos
232 e ser\(~ao substitu\('idas pelos valores na hora em que o programa for executado:
234 .Bl -tag -width "$bar_font_color" -offset indent -compact
238 .It Cm $bar_font_color
240 .It Cm $color_unfocus
244 .Bd -literal -offset indent
245 program[ff] = /usr/local/bin/firefox http://scrotwm.org/
246 bind[ff] = Mod+f # Agora Mod+F executa o firefox
249 Para desfazer a configura\(,c\(~ao anterior:
250 .Bd -literal -offset indent
257 prov\(^e muitas fun\(,c\(~oes (ou a\(,cões) acessadas pelos atalhos do teclado ou do mouse.
259 Os atuais atalhos do mouse s\(~ao descritos abaixo:
261 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
267 Redimenciona a janela
269 Redimenciona a janela enquanto a mant\('em centralizada
272 Os atalhos default do teclado s\(~ao descritos abaixo:
274 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
275 .It Cm M-S- Ns Aq Cm Return
284 .It Cm M- Ns Aq Cm Space
286 .It Cm M-S- Ns Aq Cm Space
300 .It Cm M- Ns Aq Cm Return
309 .Cm M-S- Ns Aq Cm TAB
326 .It Cm M-S- Ns Aq Ar n
328 .It Cm M- Ns Aq Cm Right
330 .It Cm M- Ns Aq Cm Left
334 .It Cm M-S- Ns Aq Cm Right
336 .It Cm M-S- Ns Aq Cm Left
346 .It Cm M-S Aq Cm Delete
352 Os nomes das a\(,c\(~oes e suas descri\(,cões est\(~ao listados abaixo:
354 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
356 Executa um novo terminal
372 Circula entre os poss\('iveis layouts
376 Encolhe a \('area mestre
378 Aumenta a \('area mestre
380 Adiciona janelas na \('area mestre
382 Remove janelas da \('area mestre
384 Adiciona colunas/linhas para a \('area de empilhamento
386 Remove colunas/linhas da \('area de empilhamento
388 Move a janela atual para a \('area mestre
390 Foca a pr\('oxima janela da \('area de trabalho
392 Foca a janela anterior da \('area de trabalho
394 Foca a janela principal da \('area de trabalho
396 Troca com a pr\('oxima janela da \('area de trabalho
398 Troca com a janela anterior da \('area de trabalho
400 Ativa/desativa a barra de status em todas as \('areas de trabalho
402 Apaga a janela atual da \('area de trabalho
404 Destr\('oi a janela atual da \('area de trabalho
406 Troca para a \('area de trabalho
412 Move a janela atual para a \('area de trabalho
418 Troca para a pr\('oxima \('area de trabalho que possua uma janela
420 Troca para a \('area de trabalho anterior que possua uma janela
422 Troca para a \('ultima \('area de trabalho visitada
424 Move o ponteiro para a pr\('oxima regi\(~ao
426 Move o ponteiro para a regi\(~ao anterior
427 .It Cm screenshot_all
428 Tira screenshot da tela inteira (se habilitado)
432 .It Cm screenshot_wind
433 Tira screenshot da janela selecionada (se habilitado)
438 Ativa/desativa a vers\(~ao na barras de status
440 Troca o estado da janela focada entre flutuante e tiled
447 Reinicializa as telas f\('isicas
453 Atalhos personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
455 .Dl bind[<action>] = <keys>
458 \('e uma das a\(,c\(~oes listadas acima (ou vazio) e
460 est\('a na forma de zero ou mais teclas de modifica\(,c\(~ao
461 (MOD, Mod1, Shift, etc.) e uma ou mais teclas normais
462 (b, space, etc.), separadas pelo "+".
464 .Bd -literal -offset indent
465 bind[reset] = Mod4+q # combina a tecla Windows + q para reiniciar
466 bind[] = Mod1+q # desfaz a combina\(,c\(~ao Alt + q
469 M\('ultiplas combina\(,c\(~oes de teclas podem ser usadas para a mesma a\(,c\(~ao.
472 prov\(^e "quirks" que manipulam janelas que devem ser tratadas especialmente
473 em um gerenciador de janela "tiling", tal como algumas aplica\(,c\(~oes de
474 di\('alogos e tela cheia.
476 Os quirks default est\(~ao descritos abaixo:
478 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
479 .It Firefox\-bin:firefox\-bin
487 .It OpenOffice.org 2.4:VCLSalFrame
489 .It OpenOffice.org 3.1:VCLSalFrame
497 .It xine:xine Video Fullscreen Window
507 Os quirks em si est\(~ao descritos abaixo:
509 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
511 Esta janela n\(~ao deve ser "tiled", mas permitida a flutuar livremente.
513 Ajusta o tamanho das janelas transit\('orias que sejam muito pequenas
516 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO ) .
518 Permite que a janela posicione a si mesma, n\(~ao-centrada.
520 Ajusta as fontes do xterm quando redimencionando.
522 Remove a borda para permitir a janela usar todo o tamanho da tela.
525 Quirks personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
527 .Dl quirk[<class>:<name>] = <quirk> [ + <quirk> ... ]
532 especificam a janela ao qual o quirk se aplica, e
534 \('e um dos quirks da lista acima.
536 .Bd -literal -offset indent
537 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # faz o mplayer tocar livremente
538 quirk[pcb:pcb] = NONE # remove quirk existente
545 executando o xprop(1) e ent\(~ao clicando na janela desejada.
546 No seguinte exemplo a jenela principal do Firefox foi clicada:
547 .Bd -literal -offset indent
548 $ xprop | grep WM_CLASS
549 WM_CLASS(STRING) = "Navigator", "Firefox"
552 Note que usando o grep(1) para WM_CLASS voc\(^e obt\('em class e name.
553 No exemplo acima a configura\(,c\(~ao do quirk poderia ser:
554 .Bd -literal -offset indent
555 quirk[Firefox:Navigator] = FLOAT
560 um sinal HUP far\('a com que o mesmo seja reiniciado.
562 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
563 .It Pa ~/.scrotwm.conf
564 Configura\(,c\(~oes espec\('ificas do usu\('ario.
565 .It Pa /etc/scrotwm.conf
566 Configura\(,c\(~oes globais.
570 foi inspirado pelo xmonad & dwm.
576 .An Marco Peereboom Aq marco@peereboom.us ,
577 .An Ryan Thomas McBride Aq mcbride@countersiege.com
579 .An Darrin Chandler Aq dwchandler@stilyagin.com .
581 Atualmente o menu, invocado com