spectrwm/scrotwm_it.1

.\"	$scrotwm$
.\"
.\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
.\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate$
.Dt SCROTWM 1
.Os
.Sh NOME
.Nm scrotwm
.Nd gestore di finestre per X11
.Sh SINTASSI
.Nm scrotwm
.Sh DESCRIZIONE
.Nm
è un gestore di finestre minimale che cerca di stare in disparte, in modo
che il prezioso spazio sullo schermo possa essere usato per cose più
importanti. Hai dei default sensati e non costringe l'utente ad imparare
un linguaggio di programmazione per configurarlo. È stato scritto dagli
hacker per gli hacker e cerca di essere piccolo, compatto e veloce.
.Pp
Quando
.Nm
viene avviato, legge le impostazioni presenti nel file di configurazione
.Pa scrotwm.conf .
Vedere la sezione
.Sx FILE DI CONFIGURAZIONE
più sotto.
.Pp
In questa pagina di manuale viene usata la seguente notazione:
.Pp
.Bl -tag -width Ds -offset indent -compact
.It Cm M
Meta
.It Cm S
Shift
.It Aq Cm Nome
Tasto nome
.It Cm M1
Tasto 1 (sinistro) del mouse
.It Cm M3
Tasto 3 (destro) del mouse
.El
.Pp
.Nm
è molto semplice da usare. La maggior parte delle operazioni vengono
svolte usando combinazioni di tasti sulla tastiera o sul mouse.
Vedere la sezione
.Sx SCORCIATOIE
più sotto per i default e le possibilità di personalizzazione.
.Sh FILE DI CONFIGURAZIONE
.Nm
prova per prima cosa ad aprire il file di configurazione personale
dell'utente,
.Pa ~/.scrotwm.conf .
Se il file in questione non è disponibile, prova ad usare il file di
configurazione globale
.Pa /etc/scrotwm.conf .
.Pp
Il formato di questo file è \*(Ltchiave\*(Gt = \*(Ltvalore\*(Gt.
Per esempio:
.Pp
.Dl color_focus = red
.Pp
Per abilitare o disabilitare un'opzione, usare i valori 1 o 0
rispettivamente.
.Pp
Il file supporta le seguenti chiavi:
.Pp
.Bl -tag -width "title_class_enabledXXX" -offset indent -compact
.It Cm color_focus
Colore del bordo della finestra che ha il focus.
.It Cm color_unfocus
Colore del bordo delle finestre che non hanno il focus.
.It Cm bar_enabled
Abilita o disabilita la barra di stato.
.It Cm bar_border Ns Bq Ar x
Colore del bordo della barra di stato nello schermo
.Ar x .
.It Cm bar_color Ns Bq Ar x
Colore della barra di stato nello schermo
.Ar x .
.It Cm bar_font_color Ns Bq Ar x
Colore del testo della barra di stato nello schermo
.Ar x .
.It Cm bar_font
Font della barra di stato.
.It Cm bar_action
Script esterno che aggiunge informazioni come la carica della batteria alla
barra di stato.
.It Cm bar_delay
Frequenza di aggiornamento, in secondi, dello script esterno che aggiunge
informazioni alla barra di stato.
.It Cm stack_enabled
Abilita o disabilita la visualizzazione dell'algoritmo di stacking
corrente nella barra di stato.
.It Cm clock_enabled
Abilita o disabilita l'orologio nella barra di stato. Se disabilitato,
usando il valore 0, è possibile usare un orologio personalizzato nello
script specificato in bar_action.
.It Cm dialog_ratio
Alcune applicazioni hanno finestre di dialogo troppo piccole per risultare
utili. Questa è la percentuale dello schermo che verrà usata per le finestre
di dialogo: ad esempio, 0.6 indica il 60% della dimensione fisica dello
schermo.
.It Cm region
Alloca una regione personalizzata, rimuovendo qualsiasi regione
automaticamente rilevata stia occupando lo stesso spazio sullo schermo.
Definita nel formato screen[<idx>]:LARGHEZZAxALTEZZA+X+Y, ad esempio
\& screen[1]:800x1200+0+0.
.It Cm term_width
Imposta la dimensione minima preferita per il terminale. Se questo valore
è maggiore di 0,
.Nm
cercherà di riaggiustare la dimensione del testo nel terminale in modo che
la larghezza del terminale rimanga sopra il valore quando la finestra
viene ridimensionata. Al momento solo
.Xr xterm 1
è supportato. Il binario di
.Xr xterm 1
deve essere setuid o setgid perché questo funzioni: nella maggior parte dei
sistemi, questo è il default. L'utente potrebbe voler impostare
program[term] (vedere la sezione
.Sx PROGRAMMI
più sotto) per usare una seconda copia del binario di
.Xr xterm 1
che non abbia il bit setgid impostato.
.It Cm title_class_enabled
Abilita o disabilita la visualizzazione della classe della finestra nella
barra di stato. Impostare a 1 per abilitare.
.It Cm title_name_enabled
Abilita o disabilita la visualizzazione del titolo della finestra nella
barra di stato. Impostare a 1 per abilitare.
.It Cm modkey
Cambia il tasto modificatore.
Solitamente Mod1 è il tasto ALT e Mod4 è il tasto Windows su un PC.
.It Cm program Ns Bq Ar p
Definisce una nuova azione per lanciare il programma
.Ar p .
Vedere la sezione
.Sx PROGRAMMI
più sotto.
.It Cm bind Ns Bq Ar x
Assegna una combinazione di tasti all'azione
.Ar x .
Vedere la sezione
.Sx SCORCIATOIE
più sotto.
.It Cm quirk Ns Bq Ar c:n
Aggiunge un "quirk" per le finestre di classe
.Ar c
e nome
.Ar n .
Vedere la sezione
.Sx QUIRKS
più sotto.
.El
.Pp
I colori devono essere specificati nel formato usato da
.Xr XQueryColor 3
e i font in quello usato da
.Xr XQueryFont 3 .
.Sh PROGRAMMI
.Nm
consente la definizione di azioni personalizzate per lanciare programmi di
propria scelta, che possono essere assegnate a combinazioni di tasti nello
stesso modo in cui è possibile farlo con le azioni predefinite.
Vedere la sezione
.Sx SCORCIATOIE
più sotto.
.Pp
I programmi di default sono descritte qui sotto:
.Pp
.Bl -tag -width "screenshot_wind" -offset indent -compact
.It Cm term
xterm
.It Cm screenshot_all
screenshot.sh full
.It Cm screenshot_wind
screenshot.sh window
.It Cm lock
xlock
.It Cm initscr
initscreen.sh
.It Cm menu
dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
.El
.Pp
I programmi personalizzati vengono specificati con la seguente sintassi:
.Pp
.Dl program[<nome>] = <percorso> [<arg> [... <arg>]]
.Pp
.Aq nome
è un qualsiasi identificatore che non va in conflitto con un'azione
predefinita o una chiave,
.Aq percorso
è il programma desiderato, e
.Aq arg
sono zero o più argomenti da passare al programma.
.Pp
Le seguenti variabili rappresentano valori impostabili in
.Nm
(vedere la sezione
.Sx FILE DI CONFIGURAZIONE
sopra), e possono essere usati nel campo
.Aq arg
dove saranno sostituite con il valore al momento del lancio del programma:
.Pp
.Bl -tag -width "$bar_font_color" -offset indent -compact
.It Cm $bar_border
.It Cm $bar_color
.It Cm $bar_font
.It Cm $bar_font_color
.It Cm $color_focus
.It Cm $color_unfocus
.El
.Pp
Esempio:
.Bd -literal -offset indent
program[ff] = /usr/local/bin/firefox http://scrotwm.org/
bind[ff] = Mod+f # adesso Mod+F lancia firefox
.Ed
.Pp
Per eliminare la combinazione precedente:
.Bd -literal -offset indent
bind[] = Mod+f
program[ff] =
.Ed
.Pp
.Sh SCORCIATOIE
.Nm
fornisce molte funzioni (o azioni) accessibili tramite combinazioni di
tasti sul mouse o sulla tastiera.
.Pp
Le scorciatoie assegnate al mouse sono:
.Pp
.Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
.It Cm M1
Dà focus alla finestra
.It Cm M-M1
Muove la finestra
.It Cm M-M3
Ridimensiona la finestra
.It Cm M-S-M3
Ridimensiona la finestra mantenendola centrata
.El
.Pp
Le scorciatoie da tastiera di default sono:
.Pp
.Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
.It Cm M-S- Ns Aq Cm Return
term
.It Cm M-p
menu
.It Cm M-S-q
quit
.It Cm M-q
restart
.Nm
.It Cm M- Ns Aq Cm Space
cycle_layout
.It Cm M-S- Ns Aq Cm Space
reset_layout
.It Cm M-h
master_shrink
.It Cm M-l
master_grow
.It Cm M-,
master_add
.It Cm M-.
master_del
.It Cm M-S-,
stack_inc
.It Cm M-S-.
stack_del
.It Cm M- Ns Aq Cm Return
swap_main
.It Xo
.Cm M-j ,
.Cm M- Ns Aq Cm TAB
.Xc
focus_next
.It Xo
.Cm M-k ,
.Cm M-S- Ns Aq Cm TAB
.Xc
focus_prev
.It Cm M-m
focus_main
.It Cm M-S-j
swap_next
.It Cm M-S-k
swap_prev
.It Cm M-b
bar_toggle
.It Cm M-x
wind_del
.It Cm M-S-x
wind_kill
.It Cm M- Ns Aq Ar n
.Ns ws_ Ns Ar n
.It Cm M-S- Ns Aq Ar n
.Ns mvws_ Ns Ar n
.It Cm M- Ns Aq Cm Right
ws_next
.It Cm M- Ns Aq Cm Left
ws_prev
.It Cm M-S- Ns Aq Cm Right
screen_next
.It Cm M-S- Ns Aq Cm Left
screen_prev
.It Cm M-s
screenshot_all
.It Cm M-S-s
screenshot_wind
.It Cm M-S-v
version
.It Cm M-t
float_toggle
.It Cm M-S Aq Cm Delete
lock
.It Cm M-S-i
initscr
.El
.Pp
I nomi delle azioni e le relative descrizioni sono le seguenti:
.Pp
.Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
.It Cm term
Lancia un nuovo terminale
(vedi
.Sx PROGRAMMI
più in alto)
.It Cm menu
Menu
(vedi
.Sx PROGRAMMI
più in alto)
.It Cm quit
Chiude
.Nm
.It Cm restart
Riavvia
.Nm
.It Cm cycle_layout
Cambia layout
.It Cm reset_layout
Re-inizializza il layout
.It Cm master_shrink
Restringe l'area principale
.It Cm master_grow
Allarga l'area principale
.It Cm master_add
Aggiunge finestre all'area principale
.It Cm master_del
Rimuove finestre dall'area principale
.It Cm stack_inc
Aggiunge righe/colonne all'area di stacking
.It Cm stack_del
Rimuove righe/colonne dall'area di stacking
.It Cm swap_main
Muove la finestra corrente nell'area principale
.It Cm focus_next
Dà il focus alla finestra successiva
.It Cm focus_prev
Dà il focus alla finestra precedente
.It Cm focus_main
Dà il focus alla finestra principale
.It Cm swap_next
Scambia con la finestra successiva dell'area di lavoro
.It Cm swap_prev
Scambia con la finestra precedente dell'area di lavoro
.It Cm bar_toggle
Mostra/nascondi la barra di stato da tutte le aree di lavoro
.It Cm wind_del
Chiudi la finestra corrente
.It Cm wind_kill
Distruggi la finestra corrente
.It Cm ws_ Ns Ar n
Passa all'area di lavoro
.Ar n ,
dove
.Ar n
è compreso tra 1 e 10
.It Cm mvws_ Ns Ar n
Sposta la finestra corrente nell'area di lavoro
.Ar n ,
dove
.Ar n
è compreso tra 1 e 10
.It Cm ws_next
Passa all'area di lavoro non vuota successiva
.It Cm ws_prev
Passa all'area di lavoro non vuota precedente
.It Cm screen_next
Sposta il puntatore nella regione successiva
.It Cm screen_prev
Sposta il puntatore nella regione precedente
.It Cm screenshot_all
Cattura uno screenshot dell'intero schermo, se abilitato (vedere la sezione
.Sx PROGRAMMI
sopra)
.It Cm screenshot_wind
Cattura uno screenshot di una singola finestra, se abilitato (vedere la
sezione
.Sx PROGRAMMI
sopra)
.It Cm version
Abilita/disabilita il numero di versione nella barra di stato
.It Cm float_toggle
Passa la finestra che ha il focus da floating a tiled
.It Cm lock
Blocca lo schermo (vedere la sezione
.Sx PROGRAMMI
sopra)
.It Cm initscr
Re-inizializza gli schermi fisici (vedere la sezione
.Sx PROGRAMMI
sopra)
.El
.Pp
Le scorciatoie personalizzate sono specificate nel file di configurazione
come segue:
.Pp
.Dl bind[<azione>] = <tasti>
.Pp
.Aq azione
è una delle azioni elencate sopra (oppure nulla) e
.Aq tasti
è dato da zero o più modificatori (MOD, Mod1, Shift, ecc.) e uno o più
tasti normali (b, space, ecc.), separati da "+".
Per esempio:
.Bd -literal -offset indent
bind[reset] = Mod4+q # assegna reset ai tasti Windows + q
bind[] = Mod1+q # rimuovi l'assegnazione di Alt + q
.Ed
.Pp
Più combinazioni di tasti possono essere assegnate alla stessa azione.
.Sh QUIRK
.Nm
fornisce la possibilità di specificare dei "quirk" per la gestione di
finestre che devono subire un trattamento speciale da un gestore di finestre
tiling, come ad esempio alcune finestre di dialogo e applicazioni a
schermo intero.
.Pp
I quirk abilitati di default sono elencati qui sotto:
.Pp
.Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
.It Firefox\-bin:firefox\-bin
TRANSSZ
.It Firefox:Dialog
FLOAT
.It Gimp:gimp
FLOAT + ANYWHERE
.It MPlayer:xv
FLOAT + FULLSCREEN
.It OpenOffice.org 2.4:VCLSalFrame
FLOAT
.It OpenOffice.org 3.1:VCLSalFrame
FLOAT
.It pcb:pcb
FLOAT
.It xine:Xine Window
FLOAT + ANYWHERE
.It xine:xine Panel
FLOAT + ANYWHERE
.It xine:xine Video Fullscreen Window
FULLSCREEN + FLOAT
.It Xitk:Xitk Combo
FLOAT + ANYWHERE
.It Xitk:Xine Window
FLOAT + ANYWHERE
.It XTerm:xterm
XTERM_FONTADJ
.El
.Pp
I quirk sono descritti qui sotto:
.Pp
.Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
.It FLOAT
Questa finestra deve essere lasciata libera di muoversi.
.It TRANSSZ
Aggiusta la dimensione delle finestre troppo piccole usando dialog_ratio
(vedere
.Sx FILE DI CONFIGURAZIONE ) .
.It ANYWHERE
Consente alla finestra di decidere da sola dove posizionarsi.
.It XTERM_FONTADJ
Aggiusta il font di xterm quando viene ridimensionata la finestra.
.It FULLSCREEN
Rimuove i bordi, consentendo alla finestra di usare l'intera dimensione
dello schermo.
.El
.Pp
I quirk personalizzati vanno specificati nel file di configurazione come
segue:
.Pp
.Dl quirk[<classe>:<nome>] = <quirk> [ + <quirk> ... ]
.Pp
.Aq classe
e
.Aq nome
specificano a quali finestre i quirk vanno applicati, e
.Aq quirk
è uno dei quirk presente nella lista sopra.
Ad esempio:
.Bd -literal -offset indent
quirk[MPlayer:xv] = FLOAT + FULLSCREEN # lascia che mplayer suoni
quirk[pcb:pcb] = NONE  # rimuovi un quirk precedentemente specificato
.Ed
.Pp
È possibile ottenere
.Aq classe
e
.Aq nome
usando xprop(1) e facendo click sulla finestra desiderata.
Nel seguente esempio è stato fatto click sulla finestra principale di
Firefox:
.Bd -literal -offset indent
$ xprop | grep WM_CLASS
WM_CLASS(STRING) = "Navigator", "Firefox"
.Ed
.Pp
Bisogna tener conto del fatto che usare grep per trovare WM_CLASS inverte
la classe e il nome. Nell'esempio precedente, la dichiarazione del quirk
sarebbe
.Bd -literal -offset indent
quirk[Firefox:Navigator] = FLOAT
.Ed
.Sh FILE
.Bl -tag -width "/etc/scrotwm.confXXX" -compact
.It Pa ~/.scrotwm.conf
impostazioni di
.Nm
dell'utente.
.It Pa /etc/scrotwm.conf
impostazioni globali di
.Nm .
.El
.Sh ORIGINE
.Nm
prende ispirazione da xmonad & dwm.
.Sh AUTORI
.An -nosplit
.Pp
.Nm
è stato scritto da
.An Marco Peereboom Aq marco@peereboom.us ,
.An Ryan Thomas McBride Aq mcbride@countersiege.com
e
.An Darrin Chandler Aq dwchandler@stilyagin.com .
.Sh BUGS
Al momento il menu, invocato usando
.Cm M-p ,
dipende da dmenu.