1 .\" $scrotwm: scrotwm_it.1,v 1.1 2009/10/07 03:19:11 marco Exp $
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.
18 .Dd $Mdocdate: September 15 2011 $
23 .Nd gestore di finestre per X11
28 ? un gestore di finestre minimale che cerca di stare in disparte, in modo
29 che il prezioso spazio sullo schermo possa essere usato per cose pi?
30 importanti. Hai dei default sensati e non costringe l'utente ad imparare
31 un linguaggio di programmazione per configurarlo. ? stato scritto dagli
32 hacker per gli hacker e cerca di essere piccolo, compatto e veloce.
36 viene avviato, legge le impostazioni presenti nel file di configurazione
39 .Sx FILE DI CONFIGURAZIONE
42 In questa pagina di manuale viene usata la seguente notazione:
44 .Bl -tag -width Ds -offset indent -compact
52 Tasto 1 (sinistro) del mouse
54 Tasto 3 (destro) del mouse
58 ? molto semplice da usare. La maggior parte delle operazioni vengono
59 svolte usando combinazioni di tasti sulla tastiera o sul mouse.
62 pi? sotto per i default e le possibilit? di personalizzazione.
63 .Sh FILE DI CONFIGURAZIONE
65 prova per prima cosa ad aprire il file di configurazione personale
68 Se il file in questione non ? disponibile, prova ad usare il file di
69 configurazione globale
70 .Pa /etc/scrotwm.conf .
72 Il formato di questo file ? \*(Ltchiave\*(Gt = \*(Ltvalore\*(Gt.
77 Per abilitare o disabilitare un'opzione, usare i valori 1 o 0
80 Il file supporta le seguenti chiavi:
82 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
84 Esegue un'applicazione nel workspace specificato all'avvio.
85 Definito nel formato ws[<idx>]:applicazione, eg. ws[2]:xterm esegue un
86 xterm nell'area di lavoro 2.
88 Colore del bordo della finestra che ha il focus.
90 Colore del bordo delle finestre che non hanno il focus.
92 Abilita o disabilita la barra di stato.
93 .It Cm bar_border Ns Bq Ar x
94 Colore del bordo della barra di stato nello schermo
96 .It Cm bar_border_width
97 Spessore del bordo attorno alla barra di stato in pixel. Il bordo
98 pu? essere disabilitato usando il valore 0.
99 .It Cm bar_color Ns Bq Ar x
100 Colore della barra di stato nello schermo
102 .It Cm bar_font_color Ns Bq Ar x
103 Colore del testo della barra di stato nello schermo
106 Font della barra di stato.
108 Script esterno che aggiunge informazioni come la carica della batteria alla
111 Frequenza di aggiornamento, in secondi, dello script esterno che aggiunge
112 informazioni alla barra di stato.
114 Posiziona la barra di stato sul fondo dello schermo anzich? in cima.
116 Abilita o disabilita la visualizzazione dell'algoritmo di stacking
117 corrente nella barra di stato.
119 Abilita o disabilita l'orologio nella barra di stato. Se disabilitato,
120 usando il valore 0, ? possibile usare un orologio personalizzato nello
121 script specificato in
124 Alcune applicazioni hanno finestre di dialogo troppo piccole per risultare
125 utili. Questa ? la percentuale dello schermo che verr? usata per le finestre
126 di dialogo: ad esempio, 0.6 indica il 60% della dimensione fisica dello
129 Layout da utilizzare all'avvio. Definito nel formato
130 ws[<idx>]:master_grow:master_add:stack_inc:layout:always_raise:stack_mode,
131 eg. ws[2]:-4:0:1:0:horizontal assegna il layout orizzontale all'area di
132 lavoro 2, riduce l'area principale di 4 unit?, aggiunge una finestra allo
133 stack e mantiene il comportamento predefinito per quanto riguarda le
135 I valori possibili per stack_mode sono
150 per ulteriori informazioni.
151 Queste impostazioni sono complesse e hanno effetti secondari; ? opportuno
152 familiarizzare con questi comandi prima di modificare l'opzione
155 Questa impostazione non viene applicata dopo il restart.
157 Alloca una regione personalizzata, rimuovendo qualsiasi regione
158 automaticamente rilevata stia occupando lo stesso spazio sullo schermo.
159 Definita nel formato screen[<idx>]:LARGHEZZAxALTEZZA+X+Y, ad esempio
160 \& screen[1]:800x1200+0+0.
162 Per fare s? che pi? monitor vengano considerati come una singola entit?
163 ? sufficiente creare una regione sufficientemente grande da contenerli,
164 eg. screen[1]:2048x760+0+0 unisce due monitor con risoluzione 1024x768
165 posizionati uno di fianco all'altro.
167 Imposta la dimensione minima preferita per il terminale. Se questo valore
170 cercher? di riaggiustare la dimensione del testo nel terminale in modo che
171 la larghezza del terminale rimanga sopra il valore quando la finestra
172 viene ridimensionata. Al momento solo
174 ? supportato. Il binario di
176 deve essere setuid o setgid perch? questo funzioni: nella maggior parte dei
177 sistemi, questo ? il default. L'utente potrebbe voler impostare
178 program[term] (vedere la sezione
180 pi? sotto) per usare una seconda copia del binario di
182 che non abbia il bit setgid impostato.
183 .It Cm title_class_enabled
184 Abilita o disabilita la visualizzazione della classe della finestra nella
185 barra di stato. Impostare a 1 per abilitare.
186 .It Cm title_name_enabled
187 Abilita o disabilita la visualizzazione del titolo della finestra nella
188 barra di stato. Impostare a 1 per abilitare.
189 .It Cm urgent_enabled
190 Abilita o disabilita l'hint "urgente".
191 In molti emulatori di terminale, il supporto deve essere abilitato
192 separatamente: per xterm, ad esempio, ? necessario aggiungere la riga
193 .Pa xterm.urgentOnBell: true
196 .It Cm window_name_enabled
197 Abilita o disabilita la visualizzazione del nome della finestra nella
198 barra di stato. Impostare a 1 per abilitare.
199 .It Cm verbose_layout
200 Abilita o disabilita la visualizzazione dei valori correnti di master e
201 stack nella barra di stato. Impostare a 1 per abilitare.
203 Cambia il tasto modificatore.
204 Solitamente Mod1 ? il tasto ALT e Mod4 ? il tasto Windows su un PC.
206 Se viene usato il valore
208 il gestore di finestre dar? il focus alla finestra sotto il puntatore
209 quando si cambia area di lavoro o si creano finestre.
210 .It Cm disable_border
211 Rimuovi il bordo dalle finestre se la barra di stato ? nascosta e c'?
212 una sola finestra sullo schermo.
214 Spessore del bordo delle finestre in pixel. Il valore 0 disabilita il bordo.
215 .It Cm program Ns Bq Ar p
216 Definisce una nuova azione per lanciare il programma
221 .It Cm bind Ns Bq Ar x
222 Assegna una combinazione di tasti all'azione
227 .It Cm quirk Ns Bq Ar c:n
228 Aggiunge un "quirk" per le finestre di classe
237 I colori devono essere specificati nel formato usato da
239 e i font in quello usato da
242 Per avere una lista dei font disponibili sul proprio sistema utilizzare
248 ? utile per visualizzare la X Logical Font Description ("XLFD") usata per
253 consente la definizione di azioni personalizzate per lanciare programmi di
254 propria scelta, che possono essere assegnate a combinazioni di tasti nello
255 stesso modo in cui ? possibile farlo con le azioni predefinite.
260 I programmi di default sono descritte qui sotto:
262 .Bl -tag -width "screenshot_wind" -offset indent -compact
265 .It Cm screenshot_all
267 .It Cm screenshot_wind
274 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
277 I programmi personalizzati vengono specificati con la seguente sintassi:
279 .Dl program[<nome>] = <percorso> [<arg> [... <arg>]]
282 ? un qualsiasi identificatore che non va in conflitto con un'azione
283 predefinita o una chiave,
285 ? il programma desiderato, e
287 sono zero o pi? argomenti da passare al programma.
289 Le seguenti variabili rappresentano valori impostabili in
292 .Sx FILE DI CONFIGURAZIONE
293 sopra), e possono essere usati nel campo
295 dove saranno sostituite con il valore al momento del lancio del programma:
297 .Bl -tag -width "$bar_font_color" -offset indent -compact
301 .It Cm $bar_font_color
303 .It Cm $color_unfocus
307 .Bd -literal -offset indent
308 program[ff] = /usr/local/bin/firefox http://scrotwm.org/
309 bind[ff] = Mod+f # adesso Mod+F lancia firefox
312 Per eliminare la combinazione precedente:
313 .Bd -literal -offset indent
320 fornisce molte funzioni (o azioni) accessibili tramite combinazioni di
321 tasti sul mouse o sulla tastiera.
323 Le scorciatoie assegnate al mouse sono:
325 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
327 D? focus alla finestra
331 Ridimensiona la finestra
333 Ridimensiona la finestra mantenendola centrata
336 Le scorciatoie da tastiera di default sono:
338 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
339 .It Cm M-S- Ns Aq Cm Return
347 .It Cm M- Ns Aq Cm Space
349 .It Cm M-S- Ns Aq Cm Space
363 .It Cm M- Ns Aq Cm Return
372 .Cm M-S- Ns Aq Cm TAB
389 .It Cm M-S- Ns Aq Ar n
391 .It Cm M- Ns Aq Cm Right
393 .It Cm M- Ns Aq Cm Left
397 .It Cm M-S- Ns Aq Cm Right
399 .It Cm M-S- Ns Aq Cm Left
409 .It Cm M-S Aq Cm Delete
423 I nomi delle azioni e le relative descrizioni sono le seguenti:
425 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
427 Lancia un nuovo terminale
445 Re-inizializza il layout.
447 Restringe l'area principale.
449 Allarga l'area principale.
451 Aggiunge finestre all'area principale.
453 Rimuove finestre dall'area principale.
455 Aggiunge righe/colonne all'area di stacking.
457 Rimuove righe/colonne dall'area di stacking.
459 Muove la finestra corrente nell'area principale.
461 D? il focus alla finestra successiva.
463 D? il focus alla finestra precedente.
465 D? il focus alla finestra principale.
467 Scambia con la finestra successiva dell'area di lavoro.
469 Scambia con la finestra precedente dell'area di lavoro.
471 Mostra/nascondi la barra di stato da tutte le aree di lavoro.
473 Chiude la finestra corrente.
475 Distrugge la finestra corrente.
477 Passa all'area di lavoro
481 ? compreso tra 1 e 10.
483 Sposta la finestra corrente nell'area di lavoro
487 ? compreso tra 1 e 10.
489 Passa all'area di lavoro non vuota successiva.
491 Passa all'area di lavoro non vuota precedente.
493 Passa all'ultima area di lavoro visitata.
495 Sposta il puntatore nella regione successiva.
497 Sposta il puntatore nella regione precedente.
498 .It Cm screenshot_all
499 Cattura uno screenshot dell'intero schermo, se abilitato (vedere la sezione
502 .It Cm screenshot_wind
503 Cattura uno screenshot di una singola finestra, se abilitato (vedere la
508 Abilita/disabilita il numero di versione nella barra di stato.
510 Passa la finestra che ha il focus da floating a tiled.
512 Blocca lo schermo (vedere la sezione
516 Re-inizializza gli schermi fisici (vedere la sezione
520 Minimizza (unmap) la finesta che ha il focus.
522 Massimizza (map) la finestra selezionata tramite dmenu.
524 Quando ? abilitato, le finestre floating possono essere oscurate da
527 Simula la pressione del tasto centrale del mouse.
530 Le scorciatoie personalizzate sono specificate nel file di configurazione
533 .Dl bind[<azione>] = <tasti>
536 ? una delle azioni elencate sopra (oppure nulla) e
538 ? dato da zero o pi? modificatori (MOD, Mod1, Shift, ecc.) e uno o pi?
539 tasti normali (b, space, ecc.), separati da "+".
541 .Bd -literal -offset indent
542 bind[reset] = Mod4+q # assegna reset ai tasti Windows + q
543 bind[] = Mod1+q # rimuovi l'assegnazione di Alt + q
546 Pi? combinazioni di tasti possono essere assegnate alla stessa azione.
549 fornisce la possibilit? di specificare dei "quirk" per la gestione di
550 finestre che devono subire un trattamento speciale da un gestore di finestre
551 tiling, come ad esempio alcune finestre di dialogo e applicazioni a
554 I quirk abilitati di default sono elencati qui sotto:
556 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
557 .It Firefox\-bin:firefox\-bin
564 FLOAT + FULLSCREEN + FOCUSPREV
565 .It OpenOffice.org 2.4:VCLSalFrame
567 .It OpenOffice.org 3.1:VCLSalFrame
575 .It xine:xine Video Fullscreen Window
585 I quirk sono descritti qui sotto:
587 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
589 Questa finestra deve essere lasciata libera di muoversi (float).
591 Aggiusta la dimensione delle finestre troppo piccole usando dialog_ratio
593 .Sx FILE DI CONFIGURAZIONE ) .
595 Consente alla finestra di decidere da sola dove posizionarsi.
597 Ridimensiona il font di xterm quando viene ridimensionata la finestra.
599 Rimuove i bordi, consentendo alla finestra di usare l'intera dimensione
602 Quando la finestra viene chiusa, d? il focus alla finestra che aveva il
603 focus precedente anzich? all'applicazione precedente nello stack.
606 I quirk personalizzati vanno specificati nel file di configurazione come
609 .Dl quirk[<classe>:<nome>] = <quirk> [ + <quirk> ... ]
614 specificano a quali finestre i quirk vanno applicati, e
616 ? uno dei quirk presente nella lista sopra.
618 .Bd -literal -offset indent
619 quirk[MPlayer:xv] = FLOAT + FULLSCREEN + FOCUSPREV
620 quirk[pcb:pcb] = NONE # rimuovi un quirk precedentemente specificato
627 usando xprop(1) e facendo click sulla finestra desiderata.
628 Nel seguente esempio ? stato fatto click sulla finestra principale di
630 .Bd -literal -offset indent
631 $ xprop | grep WM_CLASS
632 WM_CLASS(STRING) = "Navigator", "Firefox"
635 Bisogna tenere conto del fatto che usare grep per trovare WM_CLASS inverte
636 la classe e il nome. Nell'esempio precedente, la dichiarazione del quirk
638 .Bd -literal -offset indent
639 quirk[Firefox:Navigator] = FLOAT
643 assegna automaticamente i quirk alle finestre in base al valore della
644 propriet? _NET_WM_WINDOW_TYPE in base al seguente schema:
646 .Bl -tag -width "_NET_WM_WINDOW_TYPE_TOOLBAR<TAB>XXX" -offset indent -compact
647 .It _NET_WM_WINDOW_TYPE_DOCK
649 .It _NET_WM_WINDOW_TYPE_TOOLBAR
651 .It _NET_WM_WINDOW_TYPE_UTILITY
653 .It _NET_WM_WINDOW_TYPE_SPLASH
655 .It _NET_WM_WINDOW_TYPE_DIALOG
659 In tutti gli altri casi, nessun quirk ? automaticamente assegnato alla
660 finestra. I quirk specificati nel file di configurazione hanno la precedenza
661 sui quirk assegnati in automatico.
664 implementa in maniera parziale la specifica Extended Window Manager Hints
665 (EWMH). Ci? permette di controllare sia le finestre che
667 stesso tramite script e programmi esterni. Per renderlo possibile,
669 risponde ad alcuni eventi di tipo ClientMessage; questo tipo di messaggio
670 pu? essere inviato da un terminale usando programmi come
674 Per il formato esatto di questi messaggi, si veda la specifica EWMH.
676 L'id della finestra che ha il focus ? memorizzato nella propriet?
677 _NET_ACTIVE_WINDOW della root window. ? quindi possibile ottenere il titolo
678 della finestra attiva usando
682 .Bd -literal -offset indent
683 $ WINDOWID=`xprop \-root _NET_ACTIVE_WINDOW | grep \-o "0x.*"`
684 $ xprop \-id $WINDOWID WM_NAME | grep \-o "\\".*\\""
687 Per dare il focus ad una finestra, ? sufficiente inviare il messaggio
688 _NET_ACTIVE_WINDOW alla root window. Ad esempio, usando
690 (supponendo che 0x4a0000b sia l'id della finestra a cui dare il focus):
691 .Bd -literal -offset indent
692 $ wmctrl \-i \-c 0x4a0000b
695 Per chiudere una finestra si pu? inviare il messaggio _NET_CLOSE_WINDOW
696 alla root window. Ad esempio, usando
698 (supponendo che 0x4a0000b sia l'id della finestra da chiudere):
699 .Bd -literal -offset indent
700 $ wmctrl \-i \-c 0x4a0000b
703 Per passare una finestra da floating a tiled si pu? aggiungere o rimuovere
704 l'atomo _NET_WM_STATE_ABOVE alla propriet? _NET_WM_STATE della finestra,
705 inviando il messaggio _NET_WM_STATE alla root window. Ad esempio, usando
707 (supponendo che 0x4a0000b sia l'id della finestra):
708 .Bd -literal -offset indent
709 $ wmctrl \-i \-r 0x4a0000b \-b toggle,_NET_WM_STATE_ABOVE
712 Le finestre floating possono essere ridimensionate o spostate inviando il
713 messaggio _NET_MOVERESIZE_WINDOW alla root window. Ad esempio, usando
715 (supponendo che 0x4a0000b sia l'id della finestra da spostare):
716 .Bd -literal -offset indent
717 $ wmctrl \-i \-r 0x4a0000b \-e 0,100,50,640,480
720 Questo comando sposta la finestra in (100,50) e la ridimensiona a 640x480.
722 I messaggi _NET_MOVERESIZE_WINDOW vengono ignorati per le finestre stacked.
724 ? possibile riavviare
726 inviandogli il segnale HUP.
728 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
729 .It Pa ~/.scrotwm.conf
733 .It Pa /etc/scrotwm.conf
734 impostazioni globali di
739 prende ispirazione da xmonad & dwm.
746 .Bl -tag -width "Ryan Thomas McBride Aq mcbride@countersiege.com " -offset indent -compact
747 .It Cm Marco Peereboom Aq marco@peereboom.us
748 .It Cm Ryan Thomas McBride Aq mcbride@countersiege.com
749 .It Cm Darrin Chandler Aq dwchandler@stilyagin.com
750 .It Cm Pierre-Yves Ritschard Aq pyr@spootnik.org
751 .It Cm Tuukka Kataja Aq stuge@xor.fi
752 .It Cm Jason L. Wright Aq jason@thought.net
755 Al momento il menu, invocato usando