JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
Add portugese from Alicornio <alicornio@ig.com.br>
[spectrwm.git] / scrotwm_pt.1
1 .\"    $scrotwm$
2 .\"
3 .\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
4 .\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
5 .\"
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.
9 .\"
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.
17 .\"
18 .Dd $Mdocdate$
19 .Dt SCROTWM 1
20 .Os
21 .Sh NOME
22 .Nm scrotwm
23 .Nd gerenciador de janela para o X11
24 .Sh SINOPSE
25 .Nm scrotwm
26 .Sh DESCRI\(,C\(~AO
27 .Nm
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 
34 r\('apido.
35 .Pp
36 Quando o
37 .Nm
38 inicia, ele l\(^e as configura\(,c\(~oes do seu arquivo de configura\(,c\(~ao,
39 .Pa scrotwm.conf .
40 Veja a se\(,c\(~ao
41 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO
42 logo abaixo.
43 .Pp
44 A seguinte nota\(,c\(~ao \('e usada por toda essa p\('agina:
45 .Pp
46 .Bl -tag -width Ds -offset indent -compact
47 .It Cm M
48 Meta
49 .It Cm S
50 Shift
51 .It Aq Cm Name
52 Nome da tecla
53 .It Cm M1
54 Bot\(~ao 1 do mouse
55 .It Cm M3
56 Bot\(~ao 3 do mouse
57 .El
58 .Pp
59 .Nm
60 \('e muito simples de usar.
61 Muitas das a\(,c\(~oes s\(~ao iniciadas por atalhos do mouse ou do teclado.
62 Veja a se\(,c\(~ao
63 .Sx ATALHOS
64 logo abaixo para os defaults e as personaliza\(,c\(~oes.
65 .Sh ARQUIVOS DE CONFIGURA\(,C\(~AO
66 .Nm
67 primeiro tenta abrir o arquivo de configura\(,c\(~ao no diret\('orio do usu\('ario,
68 .Pa ~/.scrotwm.conf .
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 .
72 .Pp
73 Assim \('e o formato do arquivo:\*(Ltpalavra-chave\*(Gt = \*(Ltconfigura\(,c\(~ao\*(Gt.
74 Por exemplo:
75 .Pp
76 .Dl color_focus = red
77 .Pp
78 Para habilitar ou desabilitar uma op\(,c\(~ao usa-se o 1 ou 0, respectivamente. 
79 .Pp
80 O arquivo suporta as seguintes palavras-chave:
81 .Pp
82 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
83 .It Cm color_focus
84 Cor da borda da janela atualmente focada.
85 .It Cm color_unfocus
86 Cor da borda das janelas fora de foco.
87 .It Cm bar_enabled
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
91 .Ar x .
92 .It Cm bar_color Ns Bq Ar x
93 Cor da janela da barra de status na tela
94 .Ar x .
95 .It Cm bar_font_color Ns Bq Ar x
96 Cor da fonte na barra de status na tela
97 .Ar x .
98 .It Cm bar_font
99 Fonte da barra de status.
100 .It Cm bar_action
101 Script externo que preenche a barra de status com informa\(,c\(~oes adicionais,
102 como tempo de vida da bateria.
103 .It Cm bar_delay
104 Freq\(:u\(^encia da atualiza\(,c\(~ao, em segundos, do script externo que preenche
105 a barra de status.
106 .It Cm bar_at_bottom
107 Coloca a barra de status na parte inferior de cada regi\(~ao, ao inv\('es da parte superior.
108 .It Cm stack_enabled
109 Habilita ou desabilita mostrar o atual algor\('itmo de empilhamento na barra de status.
110 .It Cm clock_enabled
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
113 script bar_action.
114 .It Cm dialog_ratio
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.
118 .It Cm region
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.
123 .It Cm term_width
124 Configura a largura m\('inima preferida para o terminal
125 Se esse valor for maior do que 0,
126 .Nm
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.
129 Apenas o
130 .Xr xterm 1
131 \('e suportado atualmente.
132 O bin\('ario do
133 .Xr xterm 1
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
136 .Sx PROGRAMAS
137 ) para usar uma c\('opia alternativa do bin\('ario do
138 .Xr xterm 1
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.
146 .It Cm modkey
147 Muda a tecla de modifica\(,c\(~ao.
148 Mod1 \('e geralmente a tecla ALT e Mod4 \('e a tecla windows em um PC.
149 .It Cm focus_mode
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
156 .Ar p .
157 Veja a se\(,c\(~ao
158 .Sx PROGRAMAS
159 logo abaixo.
160 .It Cm bind Ns Bq Ar x
161 Cria uma combina\(,c\(~ao de teclas de atalho para a a\(,c\(~ao
162 .Ar x .
163 Veja a se\(,c\(~ao 
164 .Sx ATALHOS
165 logo abaixo.
166 .It Cm quirk Ns Bq Ar c:n
167 Adicione "quirk" para janelas com classe
168 .Ar c
169 e nome
170 .Ar n .
171 Veja a se\(,c\(~ao
172 .Sx QUIRKS
173 logo abaixo.
174 .El
175 .Pp
176 Cores precisam ser especificadas pela especifica\(,c\(~ao
177 .Xr XQueryColor 3
178 e fontes pela especifica\(,c\(~ao
179 .Xr XQueryFont 3 .
180 .Pp
181 Para listar as fontes dispon\('iveis em seu sistema veja o manual do
182 .Xr fc-list 1
183 ou do
184 .Xr xlsfonts 1 .
185 A aplica\(,c\(~ao 
186 .Xr xfontsel 1
187 pode te ajudar a mostrar a X Logical Font Description ("XLFD") usada na
188 configura\(,c\(~ao da palavra-chave bar_font.
189 .Sh PROGRAMAS
190 .Nm
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.
193 Veja a se\(,c\(~ao
194 .Sx ATALHOS
195 logo abaixo.
196 .Pp
197 Os programas default s\(~ao descritos abaixo:
198 .Pp
199 .Bl -tag -width "screenshot_wind" -offset indent -compact
200 .It Cm term
201 xterm
202 .It Cm screenshot_all
203 screenshot.sh full
204 .It Cm screenshot_wind
205 screenshot.sh window
206 .It Cm lock
207 xlock
208 .It Cm initscr
209 initscreen.sh
210 .It Cm menu
211 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
212 .El
213 .Pp
214 Programas personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
215 .Pp
216 .Dl program[<name>] = <progpath> [<arg> [... <arg>]]
217 .Pp
218 .Aq name
219 \('e um identificador qualquer que n\(~ao conflite com uma a\(,c\(~ao ou palavra-chave embutida,
220 .Aq progpath
221 \('e o programa desejado, e
222 .Aq arg
223 \('e zero ou mais argumentos para o programa.
224 .Pp
225 As seguintes vari\('aveis representam valores configur\('aveis no
226 .Nm
227 (veja a se\(,c\(~ao
228 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO
229 logo acima),
230 e podem ser usadas nos campos
231 .Aq arg
232 e ser\(~ao substitu\('idas pelos valores na hora em que o programa for executado:
233 .Pp
234 .Bl -tag -width "$bar_font_color" -offset indent -compact
235 .It Cm $bar_border
236 .It Cm $bar_color
237 .It Cm $bar_font
238 .It Cm $bar_font_color
239 .It Cm $color_focus
240 .It Cm $color_unfocus
241 .El
242 .Pp
243 Exemplo:
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
247 .Ed
248 .Pp
249 Para desfazer a configura\(,c\(~ao anterior:
250 .Bd -literal -offset indent
251 bind[] = Mod+f
252 program[ff] =
253 .Ed
254 .Pp
255 .Sh ATALHOS
256 .Nm
257 prov\(^e muitas fun\(,c\(~oes (ou a\(,cões) acessadas pelos atalhos do teclado ou do mouse.
258 .Pp
259 Os atuais atalhos do mouse s\(~ao descritos abaixo:
260 .Pp
261 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
262 .It Cm M1
263 Foca a janela
264 .It Cm M-M1
265 Move a janela
266 .It Cm M-M3
267 Redimenciona a janela
268 .It Cm M-S-M3
269 Redimenciona a janela enquanto a mant\('em centralizada
270 .El
271 .Pp
272 Os atalhos default do teclado s\(~ao descritos abaixo:
273 .Pp
274 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
275 .It Cm M-S- Ns Aq Cm Return
276 term
277 .It Cm M-p
278 menu
279 .It Cm M-S-q
280 quit
281 .It Cm M-q
282 restart
283 .Nm
284 .It Cm M- Ns Aq Cm Space
285 cycle_layout
286 .It Cm M-S- Ns Aq Cm Space
287 reset_layout
288 .It Cm M-h
289 master_shrink
290 .It Cm M-l
291 master_grow
292 .It Cm M-,
293 master_add
294 .It Cm M-.
295 master_del
296 .It Cm M-S-,
297 stack_inc
298 .It Cm M-S-.
299 stack_del
300 .It Cm M- Ns Aq Cm Return
301 swap_main
302 .It Xo
303 .Cm M-j ,
304 .Cm M- Ns Aq Cm TAB
305 .Xc
306 focus_next
307 .It Xo
308 .Cm M-k ,
309 .Cm M-S- Ns Aq Cm TAB
310 .Xc
311 focus_prev
312 .It Cm M-m
313 focus_main
314 .It Cm M-S-j
315 swap_next
316 .It Cm M-S-k
317 swap_prev
318 .It Cm M-b
319 bar_toggle
320 .It Cm M-x
321 wind_del
322 .It Cm M-S-x
323 wind_kill
324 .It Cm M- Ns Aq Ar n
325 .Ns ws_ Ns Ar n
326 .It Cm M-S- Ns Aq Ar n
327 .Ns mvws_ Ns Ar n
328 .It Cm M- Ns Aq Cm Right
329 ws_next
330 .It Cm M- Ns Aq Cm Left
331 ws_prev
332 .It Cm M-a
333 ws_prior
334 .It Cm M-S- Ns Aq Cm Right
335 screen_next
336 .It Cm M-S- Ns Aq Cm Left
337 screen_prev
338 .It Cm M-s
339 screenshot_all
340 .It Cm M-S-s
341 screenshot_wind
342 .It Cm M-S-v
343 version
344 .It Cm M-t
345 float_toggle
346 .It Cm M-S Aq Cm Delete
347 lock
348 .It Cm M-S-i
349 initscr
350 .El
351 .Pp
352 Os nomes das a\(,c\(~oes e suas descri\(,cões est\(~ao listados abaixo:
353 .Pp
354 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
355 .It Cm term
356 Executa um novo terminal
357 (veja a se\(,c\(~ao
358 .Sx PROGRAMAS
359 logo acima)
360 .It Cm menu
361 Menu
362 (veja a se\(,c\(~ao
363 .Sx PROGRAMAS
364 logo acima)
365 .It Cm quit
366 Sair
367 .Nm
368 .It Cm restart
369 Reiniciar
370 .Nm
371 .It Cm cycle_layout
372 Circula entre os poss\('iveis layouts
373 .It Cm reset_layout
374 Reinicia o layout
375 .It Cm master_shrink
376 Encolhe a \('area mestre
377 .It Cm master_grow
378 Aumenta a \('area mestre
379 .It Cm master_add
380 Adiciona janelas na \('area mestre
381 .It Cm master_del
382 Remove janelas da \('area mestre
383 .It Cm stack_inc
384 Adiciona colunas/linhas para a \('area de empilhamento
385 .It Cm stack_del
386 Remove colunas/linhas da \('area de empilhamento
387 .It Cm swap_main
388 Move a janela atual para a \('area mestre
389 .It Cm focus_next
390 Foca a pr\('oxima janela da \('area de trabalho
391 .It Cm focus_prev
392 Foca a janela anterior da \('area de trabalho
393 .It Cm focus_main
394 Foca a janela principal da \('area de trabalho
395 .It Cm swap_next
396 Troca com a pr\('oxima janela da \('area de trabalho
397 .It Cm swap_prev
398 Troca com a janela anterior da \('area de trabalho
399 .It Cm bar_toggle
400 Ativa/desativa a barra de status em todas as \('areas de trabalho
401 .It Cm wind_del
402 Apaga a janela atual da \('area de trabalho
403 .It Cm wind_kill
404 Destr\('oi a janela atual da \('area de trabalho
405 .It Cm ws_ Ns Ar n
406 Troca para a \('area de trabalho
407 .Ar n ,
408 onde
409 .Ar n
410 vai de 1 at\('e 10
411 .It Cm mvws_ Ns Ar n
412 Move a janela atual para a \('area de trabalho
413 .Ar n ,
414 onde
415 .Ar n
416 vai de 1 at\('e 10
417 .It Cm ws_next
418 Troca para a pr\('oxima \('area de trabalho que possua uma janela
419 .It Cm ws_prev
420 Troca para a \('area de trabalho anterior que possua uma janela
421 .It Cm ws_prior
422 Troca para a \('ultima \('area de trabalho visitada
423 .It Cm screen_next
424 Move o ponteiro para a pr\('oxima regi\(~ao
425 .It Cm screen_prev
426 Move o ponteiro para a regi\(~ao anterior
427 .It Cm screenshot_all
428 Tira screenshot da tela inteira (se habilitado)
429 (veja a se\(,c\(~ao
430 .Sx PROGRAMAS
431 logo acima)
432 .It Cm screenshot_wind
433 Tira screenshot da janela selecionada (se habilitado)
434 (veja a se\(,c\(~ao
435 .Sx PROGRAMAS
436 logo acima)
437 .It Cm version
438 Ativa/desativa a vers\(~ao na barras de status
439 .It Cm float_toggle
440 Troca o estado da janela focada entre flutuante e tiled
441 .It Cm lock
442 Trava a tela
443 (veja a se\(,c\(~ao
444 .Sx PROGRAMAS
445 logo acima)
446 .It Cm initscr
447 Reinicializa as telas f\('isicas
448 (veja a se\(,c\(~ao
449 .Sx PROGRAMAS
450 logo acima)
451 .El
452 .Pp
453 Atalhos personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
454 .Pp
455 .Dl bind[<action>] = <keys>
456 .Pp
457 .Aq action
458 \('e uma das a\(,c\(~oes listadas acima (ou vazio) e
459 .Aq keys
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 "+".
463 Por exemplo:
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
467 .Ed
468 .Pp
469 M\('ultiplas combina\(,c\(~oes de teclas podem ser usadas para a mesma a\(,c\(~ao.
470 .Sh QUIRKS
471 .Nm
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.
475 .Pp
476 Os quirks default est\(~ao descritos abaixo:
477 .Pp
478 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
479 .It Firefox\-bin:firefox\-bin
480 TRANSSZ
481 .It Firefox:Dialog
482 FLOAT
483 .It Gimp:gimp
484 FLOAT + ANYWHERE
485 .It MPlayer:xv
486 FLOAT + FULLSCREEN
487 .It OpenOffice.org 2.4:VCLSalFrame
488 FLOAT
489 .It OpenOffice.org 3.1:VCLSalFrame
490 FLOAT
491 .It pcb:pcb
492 FLOAT
493 .It xine:Xine Window
494 FLOAT + ANYWHERE
495 .It xine:xine Panel
496 FLOAT + ANYWHERE
497 .It xine:xine Video Fullscreen Window
498 FULLSCREEN + FLOAT
499 .It Xitk:Xitk Combo
500 FLOAT + ANYWHERE
501 .It Xitk:Xine Window
502 FLOAT + ANYWHERE
503 .It XTerm:xterm
504 XTERM_FONTADJ
505 .El
506 .Pp
507 Os quirks em si est\(~ao descritos abaixo:
508 .Pp
509 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
510 .It FLOAT
511 Esta janela n\(~ao deve ser "tiled", mas permitida a flutuar livremente.
512 .It TRANSSZ
513 Ajusta o tamanho das janelas transit\('orias que sejam muito pequenas
514 usando dialog_ratio 
515 (veja a se\(,c\(~ao
516 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO ) .
517 .It ANYWHERE
518 Permite que a janela posicione a si mesma, n\(~ao-centrada.
519 .It XTERM_FONTADJ
520 Ajusta as fontes do xterm quando redimencionando.
521 .It FULLSCREEN
522 Remove a borda para permitir a janela usar todo o tamanho da tela.
523 .El
524 .Pp
525 Quirks personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
526 .Pp
527 .Dl quirk[<class>:<name>] = <quirk> [ + <quirk> ... ]
528 .Pp
529 .Aq class
530 e
531 .Aq name
532 especificam a janela ao qual o quirk se aplica, e
533 .Aq quirk
534 \('e um dos quirks da lista acima.
535 Por exemplo:
536 .Bd -literal -offset indent
537 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # faz o mplayer tocar livremente
538 quirk[pcb:pcb] = NONE  # remove quirk existente
539 .Ed
540 .Pp
541 Voc\(^e pode obter
542 .Aq class
543 e
544 .Aq name
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"
550 .Ed
551 .Pp
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
556 .Ed
557 .Sh SINAIS
558 Enviar ao
559 .Nm
560 um sinal HUP far\('a com que o mesmo seja reiniciado.
561 .Sh ARQUIVOS
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.
567 .El
568 .Sh HIST\('ORIA
569 .Nm
570 foi inspirado pelo xmonad & dwm.
571 .Sh AUTORES
572 .An -nosplit
573 .Pp
574 .Nm
575 foi escrito por
576 .An Marco Peereboom Aq marco@peereboom.us ,
577 .An Ryan Thomas McBride Aq mcbride@countersiege.com
578 e
579 .An Darrin Chandler Aq dwchandler@stilyagin.com .
580 .Sh BUGS
581 Atualmente o menu, invocado com
582 .Cm M-p ,
583 depende do dmenu.