]> code.delx.au - spectrwm/blob - spectrwm_pt.1
Fixed bug in man page.
[spectrwm] / spectrwm_pt.1
1 .\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
2 .\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
3 .\"
4 .\" Permission to use, copy, modify, and distribute this software for any
5 .\" purpose with or without fee is hereby granted, provided that the above
6 .\" copyright notice and this permission notice appear in all copies.
7 .\"
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 .\"
16 .Dd $Mdocdate$
17 .Dt SPECTRWM 1
18 .Os
19 .Sh NOME
20 .Nm spectrwm
21 .Nd gerenciador de janela para o X11
22 .Sh SINOPSE
23 .Nm spectrwm
24 .Sh DESCRI\(,C\(~AO
25 .Nm
26 \('e um gerenciador de janela minimalista que tenta n\(~ao atrapalhar a
27 valorosa forma real da tela para que essa possa
28 ser usada para coisas muito mais importantes.
29 Tem sensatos defaults e n\(~ao requer que algu\('em aprenda uma linguagem de
30 programa\(,c\(~ao para fazer qualquer configura\(,c\(~ao.
31 Ele foi escrito por hackers para hackers e esfor\(,ca-se em ser pequeno, compacto e
32 r\('apido.
33 .Pp
34 Quando o
35 .Nm
36 inicia, ele l\(^e as configura\(,c\(~oes do seu arquivo de configura\(,c\(~ao,
37 .Pa spectrwm.conf .
38 Veja a se\(,c\(~ao
39 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO
40 logo abaixo.
41 .Pp
42 A seguinte nota\(,c\(~ao \('e usada por toda essa p\('agina:
43 .Pp
44 .Bl -tag -width Ds -offset indent -compact
45 .It Cm M
46 Meta
47 .It Cm S
48 Shift
49 .It Aq Cm Name
50 Nome da tecla
51 .It Cm M1
52 Bot\(~ao 1 do mouse
53 .It Cm M3
54 Bot\(~ao 3 do mouse
55 .El
56 .Pp
57 .Nm
58 \('e muito simples de usar.
59 Muitas das a\(,c\(~oes s\(~ao iniciadas por atalhos do mouse ou do teclado.
60 Veja a se\(,c\(~ao
61 .Sx ATALHOS
62 logo abaixo para os defaults e as personaliza\(,c\(~oes.
63 .Sh ARQUIVOS DE CONFIGURA\(,C\(~AO
64 .Nm
65 primeiro tenta abrir o arquivo de configura\(,c\(~ao no diret\('orio do usu\('ario,
66 .Pa ~/.spectrwm.conf .
67 Se o arquivo n\(~ao estiver dispon\('ivel, ent\(~ao tenta abrir o arquivo de
68 configura\(,c\(~ao global
69 .Pa /etc/spectrwm.conf .
70 .Pp
71 Assim \('e o formato do arquivo:\*(Ltpalavra-chave\*(Gt = \*(Ltconfigura\(,c\(~ao\*(Gt.
72 Por exemplo:
73 .Pp
74 .Dl color_focus = red
75 .Pp
76 Para habilitar ou desabilitar uma op\(,c\(~ao usa-se o 1 ou 0, respectivamente.
77 .Pp
78 O arquivo suporta as seguintes palavras-chave:
79 .Pp
80 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
81 .It Cm color_focus
82 Cor da borda da janela atualmente focada.
83 .It Cm color_unfocus
84 Cor da borda das janelas fora de foco.
85 .It Cm bar_enabled
86 Habilita ou desabilita a barra de status.
87 .It Cm bar_border Ns Bq Ar x
88 Cor da borda da barra de status na tela
89 .Ar x .
90 .It Cm bar_color Ns Bq Ar x
91 Cor da janela da barra de status na tela
92 .Ar x .
93 .It Cm bar_font_color Ns Bq Ar x
94 Cor da fonte na barra de status na tela
95 .Ar x .
96 .It Cm bar_font
97 Fonte da barra de status.
98 .It Cm bar_action
99 Script externo que preenche a barra de status com informa\(,c\(~oes adicionais,
100 como tempo de vida da bateria.
101 .It Cm bar_at_bottom
102 Coloca a barra de status na parte inferior de cada regi\(~ao, ao inv\('es da parte superior.
103 .It Cm stack_enabled
104 Habilita ou desabilita mostrar o atual algor\('itmo de empilhamento na barra de status.
105 .It Cm clock_enabled
106 Habilita ou desabilita mostrar o rel\('ogio na barra de status.
107 Desabilite configurando para 0, ent\(~ao um rel\('ogio personalizado pode ser usado no
108 script bar_action.
109 .It Cm dialog_ratio
110 Algumas aplica\(,c\(~oes tem janelas de di\('alogo que s\(~ao muito pequenas para serem \('uteis.
111 Essa taxa \('e o tamanho da tela para o qual elas ser\(~ao redimencionadas.
112 Por exemplo, 0.6 equivale a 60% do tamanho da tela f\('isica.
113 .It Cm region
114 Aloca uma regi\(~ao personalizada, removendo qualquer regi\(~ao automaticamente detectada
115 que ocupe o mesmo espa\(,co na tela.
116 Definido no formato screen[<idx>]:WIDTHxHEIGHT+X+Y,
117 e.g.\& screen[1]:800x1200+0+0.
118 .It Cm term_width
119 Configura a largura m\('inima preferida para o terminal
120 Se esse valor for maior do que 0,
121 .Nm
122 vai tentar ajustar os tamanhos da fonte no terminal para manter a largura
123 do terminal acima desse n\('umero enquanto a janela \('e redimencionada.
124 Apenas o
125 .Xr xterm 1
126 \('e suportado atualmente.
127 O bin\('ario do
128 .Xr xterm 1
129 n\(~ao deve ser setuid ou setgid, que \('e o default em muitos sistemas.
130 Os usu\('arios podem precisar de configurar program[term] (veja a se\(,c\(~ao
131 .Sx PROGRAMAS
132 ) para usar uma c\('opia alternativa do bin\('ario do
133 .Xr xterm 1
134 sem o bit setgid ativado.
135 .It Cm title_class_enabled
136 Habilita ou desabilita mostrar a classe da janela na barra de status.
137 Habilite configurando para 1.
138 .It Cm title_name_enabled
139 Habilita ou desabilita mostrar o t\('itulo da janela na barra de status.
140 Habilite configurando para 1.
141 .It Cm window_name_enabled
142 Habilita ou desabilita mostrar a nome da janela na barra de status.
143 Habilite configurando para 1.
144 .It Cm modkey
145 Muda a tecla de modifica\(,c\(~ao.
146 Mod1 \('e geralmente a tecla ALT e Mod4 \('e a tecla windows em um PC.
147 .It Cm focus_mode
148 Usar um valor de follow_cursor vai fazer o gerenciador de janela focar
149 a janela sob o mouse quando trocando \('areas de trabalho e criando janelas.
150 .It Cm disable_border
151 Remove a borda quando a barra estiver desabilitada e houver apenas uma janela na tela.
152 .It Cm program Ns Bq Ar p
153 Define uma nova a\(,c\(~ao para executar um programa
154 .Ar p .
155 Veja a se\(,c\(~ao
156 .Sx PROGRAMAS
157 logo abaixo.
158 .It Cm bind Ns Bq Ar x
159 Cria uma combina\(,c\(~ao de teclas de atalho para a a\(,c\(~ao
160 .Ar x .
161 Veja a se\(,c\(~ao
162 .Sx ATALHOS
163 logo abaixo.
164 .It Cm quirk Ns Bq Ar c:n
165 Adicione "quirk" para janelas com classe
166 .Ar c
167 e nome
168 .Ar n .
169 Veja a se\(,c\(~ao
170 .Sx QUIRKS
171 logo abaixo.
172 .El
173 .Pp
174 Cores precisam ser especificadas pela especifica\(,c\(~ao
175 .Xr XQueryColor 3
176 e fontes pela especifica\(,c\(~ao
177 .Xr XQueryFont 3 .
178 .Pp
179 Para listar as fontes dispon\('iveis em seu sistema veja o manual do
180 .Xr fc-list 1
181 ou do
182 .Xr xlsfonts 1 .
183 A aplica\(,c\(~ao
184 .Xr xfontsel 1
185 pode te ajudar a mostrar a X Logical Font Description ("XLFD") usada na
186 configura\(,c\(~ao da palavra-chave bar_font.
187 .Sh PROGRAMAS
188 .Nm
189 te permite definir a\(,c\(~oes personalizadas para executar programas de sua escolha
190 e ent\(~ao criar um atalho para elas da mesma forma que as a\(,c\(~oes embutidas.
191 Veja a se\(,c\(~ao
192 .Sx ATALHOS
193 logo abaixo.
194 .Pp
195 Os programas default s\(~ao descritos abaixo:
196 .Pp
197 .Bl -tag -width "screenshot_wind" -offset indent -compact
198 .It Cm term
199 xterm
200 .It Cm screenshot_all
201 screenshot.sh full
202 .It Cm screenshot_wind
203 screenshot.sh window
204 .It Cm lock
205 xlock
206 .It Cm initscr
207 initscreen.sh
208 .It Cm menu
209 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
210 .El
211 .Pp
212 Programas personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
213 .Pp
214 .Dl program[<name>] = <progpath> [<arg> [... <arg>]]
215 .Pp
216 .Aq name
217 \('e um identificador qualquer que n\(~ao conflite com uma a\(,c\(~ao ou palavra-chave embutida,
218 .Aq progpath
219 \('e o programa desejado, e
220 .Aq arg
221 \('e zero ou mais argumentos para o programa.
222 .Pp
223 As seguintes vari\('aveis representam valores configur\('aveis no
224 .Nm
225 (veja a se\(,c\(~ao
226 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO
227 logo acima),
228 e podem ser usadas nos campos
229 .Aq arg
230 e ser\(~ao substitu\('idas pelos valores na hora em que o programa for executado:
231 .Pp
232 .Bl -tag -width "$bar_font_color" -offset indent -compact
233 .It Cm $bar_border
234 .It Cm $bar_color
235 .It Cm $bar_font
236 .It Cm $bar_font_color
237 .It Cm $color_focus
238 .It Cm $color_unfocus
239 .El
240 .Pp
241 Exemplo:
242 .Bd -literal -offset indent
243 program[ff] = /usr/local/bin/firefox http://spectrwm.org/
244 bind[ff] = Mod+f # Agora Mod+F executa o firefox
245 .Ed
246 .Pp
247 Para desfazer a configura\(,c\(~ao anterior:
248 .Bd -literal -offset indent
249 bind[] = Mod+f
250 program[ff] =
251 .Ed
252 .Pp
253 .Sh ATALHOS
254 .Nm
255 prov\(^e muitas fun\(,c\(~oes (ou a\(,cões) acessadas pelos atalhos do teclado ou do mouse.
256 .Pp
257 Os atuais atalhos do mouse s\(~ao descritos abaixo:
258 .Pp
259 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
260 .It Cm M1
261 Foca a janela
262 .It Cm M-M1
263 Move a janela
264 .It Cm M-M3
265 Redimenciona a janela
266 .It Cm M-S-M3
267 Redimenciona a janela enquanto a mant\('em centralizada
268 .El
269 .Pp
270 Os atalhos default do teclado s\(~ao descritos abaixo:
271 .Pp
272 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
273 .It Cm M-S- Ns Aq Cm Return
274 term
275 .It Cm M-p
276 menu
277 .It Cm M-S-q
278 quit
279 .It Cm M-q
280 restart
281 .Nm
282 .It Cm M- Ns Aq Cm Space
283 cycle_layout
284 .It Cm M-S- Ns Aq Cm Space
285 reset_layout
286 .It Cm M-h
287 master_shrink
288 .It Cm M-l
289 master_grow
290 .It Cm M-,
291 master_add
292 .It Cm M-.
293 master_del
294 .It Cm M-S-,
295 stack_inc
296 .It Cm M-S-.
297 stack_del
298 .It Cm M- Ns Aq Cm Return
299 swap_main
300 .It Xo
301 .Cm M-j ,
302 .Cm M- Ns Aq Cm TAB
303 .Xc
304 focus_next
305 .It Xo
306 .Cm M-k ,
307 .Cm M-S- Ns Aq Cm TAB
308 .Xc
309 focus_prev
310 .It Cm M-m
311 focus_main
312 .It Cm M-S-j
313 swap_next
314 .It Cm M-S-k
315 swap_prev
316 .It Cm M-b
317 bar_toggle
318 .It Cm M-x
319 wind_del
320 .It Cm M-S-x
321 wind_kill
322 .It Cm M- Ns Aq Ar n
323 .Ns ws_ Ns Ar n
324 .It Cm M-S- Ns Aq Ar n
325 .Ns mvws_ Ns Ar n
326 .It Cm M- Ns Aq Cm Right
327 ws_next
328 .It Cm M- Ns Aq Cm Left
329 ws_prev
330 .It Cm M-a
331 ws_prior
332 .It Cm M-S- Ns Aq Cm Right
333 screen_next
334 .It Cm M-S- Ns Aq Cm Left
335 screen_prev
336 .It Cm M-s
337 screenshot_all
338 .It Cm M-S-s
339 screenshot_wind
340 .It Cm M-S-v
341 version
342 .It Cm M-t
343 float_toggle
344 .It Cm M-S Aq Cm Delete
345 lock
346 .It Cm M-S-i
347 initscr
348 .El
349 .Pp
350 Os nomes das a\(,c\(~oes e suas descri\(,cões est\(~ao listados abaixo:
351 .Pp
352 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
353 .It Cm term
354 Executa um novo terminal
355 (veja a se\(,c\(~ao
356 .Sx PROGRAMAS
357 logo acima)
358 .It Cm menu
359 Menu
360 (veja a se\(,c\(~ao
361 .Sx PROGRAMAS
362 logo acima)
363 .It Cm quit
364 Sair
365 .Nm
366 .It Cm restart
367 Reiniciar
368 .Nm
369 .It Cm cycle_layout
370 Circula entre os poss\('iveis layouts
371 .It Cm reset_layout
372 Reinicia o layout
373 .It Cm master_shrink
374 Encolhe a \('area mestre
375 .It Cm master_grow
376 Aumenta a \('area mestre
377 .It Cm master_add
378 Adiciona janelas na \('area mestre
379 .It Cm master_del
380 Remove janelas da \('area mestre
381 .It Cm stack_inc
382 Adiciona colunas/linhas para a \('area de empilhamento
383 .It Cm stack_del
384 Remove colunas/linhas da \('area de empilhamento
385 .It Cm swap_main
386 Move a janela atual para a \('area mestre
387 .It Cm focus_next
388 Foca a pr\('oxima janela da \('area de trabalho
389 .It Cm focus_prev
390 Foca a janela anterior da \('area de trabalho
391 .It Cm focus_main
392 Foca a janela principal da \('area de trabalho
393 .It Cm swap_next
394 Troca com a pr\('oxima janela da \('area de trabalho
395 .It Cm swap_prev
396 Troca com a janela anterior da \('area de trabalho
397 .It Cm bar_toggle
398 Ativa/desativa a barra de status em todas as \('areas de trabalho
399 .It Cm wind_del
400 Apaga a janela atual da \('area de trabalho
401 .It Cm wind_kill
402 Destr\('oi a janela atual da \('area de trabalho
403 .It Cm ws_ Ns Ar n
404 Troca para a \('area de trabalho
405 .Ar n ,
406 onde
407 .Ar n
408 vai de 1 at\('e 10
409 .It Cm mvws_ Ns Ar n
410 Move a janela atual para a \('area de trabalho
411 .Ar n ,
412 onde
413 .Ar n
414 vai de 1 at\('e 10
415 .It Cm ws_next
416 Troca para a pr\('oxima \('area de trabalho que possua uma janela
417 .It Cm ws_prev
418 Troca para a \('area de trabalho anterior que possua uma janela
419 .It Cm ws_prior
420 Troca para a \('ultima \('area de trabalho visitada
421 .It Cm screen_next
422 Move o ponteiro para a pr\('oxima regi\(~ao
423 .It Cm screen_prev
424 Move o ponteiro para a regi\(~ao anterior
425 .It Cm screenshot_all
426 Tira screenshot da tela inteira (se habilitado)
427 (veja a se\(,c\(~ao
428 .Sx PROGRAMAS
429 logo acima)
430 .It Cm screenshot_wind
431 Tira screenshot da janela selecionada (se habilitado)
432 (veja a se\(,c\(~ao
433 .Sx PROGRAMAS
434 logo acima)
435 .It Cm version
436 Ativa/desativa a vers\(~ao na barras de status
437 .It Cm float_toggle
438 Troca o estado da janela focada entre flutuante e tiled
439 .It Cm lock
440 Trava a tela
441 (veja a se\(,c\(~ao
442 .Sx PROGRAMAS
443 logo acima)
444 .It Cm initscr
445 Reinicializa as telas f\('isicas
446 (veja a se\(,c\(~ao
447 .Sx PROGRAMAS
448 logo acima)
449 .El
450 .Pp
451 Atalhos personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
452 .Pp
453 .Dl bind[<action>] = <keys>
454 .Pp
455 .Aq action
456 \('e uma das a\(,c\(~oes listadas acima (ou vazio) e
457 .Aq keys
458 est\('a na forma de zero ou mais teclas de modifica\(,c\(~ao
459 (MOD, Mod1, Shift, etc.) e uma ou mais teclas normais
460 (b, space, etc.), separadas pelo "+".
461 Por exemplo:
462 .Bd -literal -offset indent
463 bind[reset] = Mod4+q # combina a tecla Windows + q para reiniciar
464 bind[] = Mod1+q # desfaz a combina\(,c\(~ao Alt + q
465 .Ed
466 .Pp
467 M\('ultiplas combina\(,c\(~oes de teclas podem ser usadas para a mesma a\(,c\(~ao.
468 .Sh QUIRKS
469 .Nm
470 prov\(^e "quirks" que manipulam janelas que devem ser tratadas especialmente
471 em um gerenciador de janela "tiling", tal como algumas aplica\(,c\(~oes de
472 di\('alogos e tela cheia.
473 .Pp
474 Os quirks default est\(~ao descritos abaixo:
475 .Pp
476 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
477 .It Firefox\-bin:firefox\-bin
478 TRANSSZ
479 .It Firefox:Dialog
480 FLOAT
481 .It Gimp:gimp
482 FLOAT + ANYWHERE
483 .It MPlayer:xv
484 FLOAT + FULLSCREEN
485 .It OpenOffice.org 2.4:VCLSalFrame
486 FLOAT
487 .It OpenOffice.org 3.1:VCLSalFrame
488 FLOAT
489 .It pcb:pcb
490 FLOAT
491 .It xine:Xine Window
492 FLOAT + ANYWHERE
493 .It xine:xine Panel
494 FLOAT + ANYWHERE
495 .It xine:xine Video Fullscreen Window
496 FULLSCREEN + FLOAT
497 .It Xitk:Xitk Combo
498 FLOAT + ANYWHERE
499 .It Xitk:Xine Window
500 FLOAT + ANYWHERE
501 .It XTerm:xterm
502 XTERM_FONTADJ
503 .El
504 .Pp
505 Os quirks em si est\(~ao descritos abaixo:
506 .Pp
507 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
508 .It FLOAT
509 Esta janela n\(~ao deve ser "tiled", mas permitida a flutuar livremente.
510 .It TRANSSZ
511 Ajusta o tamanho das janelas transit\('orias que sejam muito pequenas
512 usando dialog_ratio
513 (veja a se\(,c\(~ao
514 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO ) .
515 .It ANYWHERE
516 Permite que a janela posicione a si mesma, n\(~ao-centrada.
517 .It XTERM_FONTADJ
518 Ajusta as fontes do xterm quando redimencionando.
519 .It FULLSCREEN
520 Remove a borda para permitir a janela usar todo o tamanho da tela.
521 .El
522 .Pp
523 Quirks personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
524 .Pp
525 .Dl quirk[<class>:<name>] = <quirk> [ + <quirk> ... ]
526 .Pp
527 .Aq class
528 e
529 .Aq name
530 especificam a janela ao qual o quirk se aplica, e
531 .Aq quirk
532 \('e um dos quirks da lista acima.
533 Por exemplo:
534 .Bd -literal -offset indent
535 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # faz o mplayer tocar livremente
536 quirk[pcb:pcb] = NONE # remove quirk existente
537 .Ed
538 .Pp
539 Voc\(^e pode obter
540 .Aq class
541 e
542 .Aq name
543 executando o xprop(1) e ent\(~ao clicando na janela desejada.
544 No seguinte exemplo a jenela principal do Firefox foi clicada:
545 .Bd -literal -offset indent
546 $ xprop | grep WM_CLASS
547 WM_CLASS(STRING) = "Navigator", "Firefox"
548 .Ed
549 .Pp
550 Note que usando o grep(1) para WM_CLASS voc\(^e obt\('em class e name.
551 No exemplo acima a configura\(,c\(~ao do quirk poderia ser:
552 .Bd -literal -offset indent
553 quirk[Firefox:Navigator] = FLOAT
554 .Ed
555 .Sh SINAIS
556 Enviar ao
557 .Nm
558 um sinal HUP far\('a com que o mesmo seja reiniciado.
559 .Sh ARQUIVOS
560 .Bl -tag -width "/etc/spectrwm.confXXX" -compact
561 .It Pa ~/.spectrwm.conf
562 Configura\(,c\(~oes espec\('ificas do usu\('ario.
563 .It Pa /etc/spectrwm.conf
564 Configura\(,c\(~oes globais.
565 .El
566 .Sh HIST\('ORIA
567 .Nm
568 foi inspirado pelo xmonad & dwm.
569 .Sh AUTORES
570 .An -nosplit
571 .Pp
572 .Nm
573 foi escrito por
574 .An Marco Peereboom Aq marco@peereboom.us ,
575 .An Ryan Thomas McBride Aq mcbride@countersiege.com
576 e
577 .An Darrin Chandler Aq dwchandler@stilyagin.com .
578 .Sh BUGS
579 Atualmente o menu, invocado com
580 .Cm M-p ,
581 depende do dmenu.