1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
4 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
5 <title>~/scrotwm_pt.1.html</title>
6 <meta name="Generator" content="Vim/7.3">
7 <meta name="plugin-version" content="vim7.3_v6">
8 <meta name="syntax" content="man">
9 <meta name="settings" content="use_css">
10 <style type="text/css">
12 pre { font-family: monospace; background-color: #000000; color: #ffffff; }
13 body { font-family: monospace; background-color: #000000; color: #ffffff; }
14 .PreProc { color: #ff40ff; }
15 .Statement { color: #ffff00; }
16 .Title { color: #ff40ff; }
22 <span class="Title">SCROTWM(1) OpenBSD Reference Manual SCROTWM(1)</span>
24 <span class="Statement">NOME</span>
25 scrotwm - gerenciador de janela para o X11
27 <span class="Statement">SINOPSE</span>
30 <span class="Statement">DESCRICAO</span>
31 scrotwm e um gerenciador de janela minimalista que tenta nao atrapalhar a
32 valorosa forma real da tela para que essa possa ser usada para coisas
33 muito mais importantes. Tem sensatos defaults e nao requer que alguem
34 aprenda uma linguagem de programacao para fazer qualquer configuracao.
35 Ele foi escrito por hackers para hackers e esforca-se em ser pequeno,
38 Quando o scrotwm inicia, ele le as configuracoes do seu arquivo de
39 configuracao, scrotwm.conf. Veja a secao ARQUIVOS DE CONFIGURACAO logo
42 A seguinte notacao e usada por toda essa pagina:
46 <Name> Nome da tecla
50 scrotwm e muito simples de usar. Muitas das acoes sao iniciadas por
51 atalhos do mouse ou do teclado. Veja a secao ATALHOS logo abaixo para os
52 defaults e as personalizacoes.
54 <span class="Statement">ARQUIVOS DE CONFIGURACAO</span>
55 scrotwm primeiro tenta abrir o arquivo de configuracao no diretorio do
56 usuario, ~/.scrotwm.conf. Se o arquivo nao estiver disponivel, entao
57 tenta abrir o arquivo de configuracao global /etc/scrotwm.conf.
59 Assim e o formato do arquivo:<palavra-chave> = <configuracao>. Por
64 Para habilitar ou desabilitar uma opcao usa-se o 1 ou 0, respectivamente.
66 O arquivo suporta as seguintes palavras-chave:
68 color_focus Cor da borda da janela atualmente focada.
69 color_unfocus Cor da borda das janelas fora de foco.
70 bar_enabled Habilita ou desabilita a barra de status.
71 bar_border[x] Cor da borda da barra de status na tela x.
72 bar_color[x] Cor da janela da barra de status na tela x.
73 bar_font_color[x] Cor da fonte na barra de status na tela x.
74 bar_font Fonte da barra de status.
75 bar_action Script externo que preenche a barra de
76 status com informacoes adicionais, como
77 tempo de vida da bateria.
78 bar_delay Frequencia da atualizacao, em segundos, do
79 script externo que preenche a barra de
81 bar_at_bottom Coloca a barra de status na parte inferior
82 de cada regiao, ao inves da parte superior.
83 stack_enabled Habilita ou desabilita mostrar o atual
84 algoritmo de empilhamento na barra de
86 clock_enabled Habilita ou desabilita mostrar o relogio na
87 barra de status. Desabilite configurando
88 para 0, entao um relogio personalizado pode
89 ser usado no script bar_action.
90 dialog_ratio Algumas aplicacoes tem janelas de dialogo
91 que sao muito pequenas para serem uteis.
92 Essa taxa e o tamanho da tela para o qual
93 elas serao redimencionadas. Por exemplo,
94 0.6 equivale a 60% do tamanho da tela
96 region Aloca uma regiao personalizada, removendo
97 qualquer regiao automaticamente detectada
98 que ocupe o mesmo espaco na tela. Definido
99 no formato screen[<idx>]:WIDTHxHEIGHT+X+Y,
100 e.g. screen[1]:800x1200+0+0.
101 term_width Configura a largura minima preferida para o
102 terminal Se esse valor for maior do que 0,
103 scrotwm vai tentar ajustar os tamanhos da
104 fonte no terminal para manter a largura do
105 terminal acima desse numero enquanto a
106 janela e redimencionada. Apenas o <span class="PreProc">xterm(1)</span>
107 e suportado atualmente. O binario do
108 <span class="PreProc">xterm(1)</span> nao deve ser setuid ou setgid, que
109 e o default em muitos sistemas. Os
110 usuarios podem precisar de configurar
111 program[term] (veja a secao PROGRAMAS )
112 para usar uma copia alternativa do binario
113 do <span class="PreProc">xterm(1)</span> sem o bit setgid ativado.
114 title_class_enabled Habilita ou desabilita mostrar a classe da
115 janela na barra de status. Habilite
117 title_name_enabled Habilita ou desabilita mostrar o titulo da
118 janela na barra de status. Habilite
120 modkey Muda a tecla de modificacao. Mod1 e
121 geralmente a tecla ALT e Mod4 e a tecla
123 focus_mode Usar um valor de follow_cursor vai fazer o
124 gerenciador de janela focar a janela sob o
125 mouse quando trocando areas de trabalho e
127 disable_border Remove a borda quando a barra estiver
128 desabilitada e houver apenas uma janela na
130 program[p] Define uma nova acao para executar um
131 programa p. Veja a secao PROGRAMAS logo
133 bind[x] Cria uma combinacao de teclas de atalho
134 para a acao x. Veja a secao ATALHOS logo
136 quirk[c:n] Adicione "quirk" para janelas com classe c
137 e nome n. Veja a secao QUIRKS logo abaixo.
139 Cores precisam ser especificadas pela especificacao <span class="PreProc">XQueryColor(3)</span> e
140 fontes pela especificacao <span class="PreProc">XQueryFont(3)</span>.
142 Para listar as fontes disponiveis em seu sistema veja o manual do
143 <span class="PreProc">fc-list(1)</span> ou do <span class="PreProc">xlsfonts(1)</span>. A aplicacao <span class="PreProc">xfontsel(1)</span> pode te ajudar a
144 mostrar a X Logical Font Description ("XLFD") usada na configuracao da
145 palavra-chave bar_font.
147 <span class="Statement">PROGRAMAS</span>
148 scrotwm te permite definir acoes personalizadas para executar programas
149 de sua escolha e entao criar um atalho para elas da mesma forma que as
150 acoes embutidas. Veja a secao ATALHOS logo abaixo.
152 Os programas default sao descritos abaixo:
155 screenshot_all screenshot.sh full
156 screenshot_wind screenshot.sh window
158 initscr initscreen.sh
159 menu dmenu_run -fn $bar_font -nb $bar_color -nf
160 $bar_font_color -sb $bar_border -sf $bar_color
162 Programas personalizados no arquivo de configuracao sao especificados da
165 program[<name>] = <progpath> [<arg> [... <arg>]]
167 <name> e um identificador qualquer que nao conflite com uma acao ou
168 palavra-chave embutida, <progpath> e o programa desejado, e <arg> e zero
169 ou mais argumentos para o programa.
171 As seguintes variaveis representam valores configuraveis no scrotwm (veja
172 a secao ARQUIVOS DE CONFIGURACAO logo acima), e podem ser usadas nos
173 campos <arg> e serao substituidas pelos valores na hora em que o programa
185 program[ff] = /usr/local/bin/firefox <a href="http://scrotwm.org/">http://scrotwm.org/</a>
186 bind[ff] = Mod+f # Agora Mod+F executa o firefox
188 Para desfazer a configuracao anterior:
193 <span class="Statement">ATALHOS</span>
194 scrotwm prove muitas funcoes (ou aces) acessadas pelos atalhos do teclado
197 Os atuais atalhos do mouse sao descritos abaixo:
201 M-M3 Redimenciona a janela
202 M-S-M3 Redimenciona a janela enquanto a mantem
205 Os atalhos default do teclado sao descritos abaixo:
207 M-S-<Return> term
211 M-<Space> cycle_layout
212 M-S-<Space> reset_layout
219 M-<Return> swap_main
220 M-j, M-<TAB> focus_next
221 M-k, M-S-<TAB> focus_prev
230 M-<Right> ws_next
231 M-<Left> ws_prev
233 M-S-<Right> screen_next
234 M-S-<Left> screen_prev
236 M-S-s screenshot_wind
239 M-S <Delete> lock
242 Os nomes das acoes e suas descrices estao listados abaixo:
244 term Executa um novo terminal (veja a secao PROGRAMAS
246 menu Menu (veja a secao PROGRAMAS logo acima)
248 restart Reiniciar scrotwm
249 cycle_layout Circula entre os possiveis layouts
250 reset_layout Reinicia o layout
251 master_shrink Encolhe a area mestre
252 master_grow Aumenta a area mestre
253 master_add Adiciona janelas na area mestre
254 master_del Remove janelas da area mestre
255 stack_inc Adiciona colunas/linhas para a area de
257 stack_del Remove colunas/linhas da area de empilhamento
258 swap_main Move a janela atual para a area mestre
259 focus_next Foca a proxima janela da area de trabalho
260 focus_prev Foca a janela anterior da area de trabalho
261 focus_main Foca a janela principal da area de trabalho
262 swap_next Troca com a proxima janela da area de trabalho
263 swap_prev Troca com a janela anterior da area de trabalho
264 bar_toggle Ativa/desativa a barra de status em todas as areas
266 wind_del Apaga a janela atual da area de trabalho
267 wind_kill Destroi a janela atual da area de trabalho
268 ws_n Troca para a area de trabalho n, onde n vai de 1
270 mvws_n Move a janela atual para a area de trabalho n,
271 onde n vai de 1 ate 10
272 ws_next Troca para a proxima area de trabalho que possua
274 ws_prev Troca para a area de trabalho anterior que possua
276 ws_prior Troca para a ultima area de trabalho visitada
277 screen_next Move o ponteiro para a proxima regiao
278 screen_prev Move o ponteiro para a regiao anterior
279 screenshot_all Tira screenshot da tela inteira (se habilitado)
280 (veja a secao PROGRAMAS logo acima)
281 screenshot_wind Tira screenshot da janela selecionada (se
282 habilitado) (veja a secao PROGRAMAS logo acima)
283 version Ativa/desativa a versao na barras de status
284 float_toggle Troca o estado da janela focada entre flutuante e
286 lock Trava a tela (veja a secao PROGRAMAS logo acima)
287 initscr Reinicializa as telas fisicas (veja a secao
288 PROGRAMAS logo acima)
290 Atalhos personalizados no arquivo de configuracao sao especificados da
293 bind[<action>] = <keys>
295 <action> e uma das acoes listadas acima (ou vazio) e <keys> esta na forma
296 de zero ou mais teclas de modificacao (MOD, Mod1, Shift, etc.) e uma ou
297 mais teclas normais (b, space, etc.), separadas pelo "+". Por exemplo:
299 bind[reset] = Mod4+q # combina a tecla Windows + q para reiniciar
300 bind[] = Mod1+q # desfaz a combinacao Alt + q
302 Multiplas combinacoes de teclas podem ser usadas para a mesma acao.
304 <span class="Statement">QUIRKS</span>
305 scrotwm prove "quirks" que manipulam janelas que devem ser tratadas
306 especialmente em um gerenciador de janela "tiling", tal como algumas
307 aplicacoes de dialogos e tela cheia.
309 Os quirks default estao descritos abaixo:
311 Firefox-bin:firefox-bin TRANSSZ
313 Gimp:gimp FLOAT + ANYWHERE
314 MPlayer:xv FLOAT + FULLSCREEN
315 OpenOffice.org 2.4:VCLSalFrame FLOAT
316 OpenOffice.org 3.1:VCLSalFrame FLOAT
318 xine:Xine Window FLOAT + ANYWHERE
319 xine:xine Panel FLOAT + ANYWHERE
320 xine:xine Video Fullscreen Window FULLSCREEN + FLOAT
321 Xitk:Xitk Combo FLOAT + ANYWHERE
322 Xitk:Xine Window FLOAT + ANYWHERE
323 XTerm:xterm XTERM_FONTADJ
325 Os quirks em si estao descritos abaixo:
327 FLOAT Esta janela nao deve ser "tiled", mas
328 permitida a flutuar livremente.
329 TRANSSZ Ajusta o tamanho das janelas transitorias
330 que sejam muito pequenas usando dialog_ratio
331 (veja a secao ARQUIVOS DE CONFIGURACAO).
332 ANYWHERE Permite que a janela posicione a si mesma,
334 XTERM_FONTADJ Ajusta as fontes do xterm quando
336 FULLSCREEN Remove a borda para permitir a janela usar
337 todo o tamanho da tela.
339 Quirks personalizados no arquivo de configuracao sao especificados da
342 quirk[<class>:<name>] = <quirk> [+ <quirk> ...]
344 <class> e <name> especificam a janela ao qual o quirk se aplica, e
345 <quirk> e um dos quirks da lista acima. Por exemplo:
347 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # faz o mplayer tocar livremente
348 quirk[pcb:pcb] = NONE # remove quirk existente
350 Voce pode obter <class> e <name> executando o <span class="PreProc">xprop(1)</span> e entao clicando
351 na janela desejada. No seguinte exemplo a jenela principal do Firefox
354 $ xprop | grep WM_CLASS
355 WM_CLASS(STRING) = "Navigator", "Firefox"
357 Note que usando o <span class="PreProc">grep(1)</span> para WM_CLASS voce obtem class e name. No
358 exemplo acima a configuracao do quirk poderia ser:
360 quirk[Firefox:Navigator] = FLOAT
362 <span class="Statement">SINAIS</span>
363 Enviar ao scrotwm um sinal HUP fara com que o mesmo seja reiniciado.
365 <span class="Statement">ARQUIVOS</span>
366 ~/.scrotwm.conf Configuracoes especificas do usuario.
367 /etc/scrotwm.conf Configuracoes globais.
369 <span class="Statement">HISTORIA</span>
370 scrotwm foi inspirado pelo xmonad & dwm.
372 <span class="Statement">AUTORES</span>
374 scrotwm foi escrito por Marco Peereboom <marco@peereboom.us>, Ryan Thomas
375 McBride <mcbride@countersiege.com> e Darrin Chandler
376 <dwchandler@stilyagin.com>.
378 <span class="Statement">BUGS</span>
379 Atualmente o menu, invocado com M-p, depende do dmenu.
381 OpenBSD 4.8 July 15, 2010 OpenBSD 4.8