scrotwm_it.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 gestore di finestre per X11
  24 .Sh SINTASSI
  25 .Nm scrotwm
  26 .Sh DESCRIZIONE
  27 .Nm
  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.
  33 .Pp
  34 Quando
  35 .Nm
  36 viene avviato, legge le impostazioni presenti nel file di configurazione
  37 .Pa scrotwm.conf .
  38 Vedere la sezione
  39 .Sx FILE DI CONFIGURAZIONE
  40 più sotto.
  41 .Pp
  42 In questa pagina di manuale viene usata la seguente notazione:
  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 Nome
  50 Tasto nome
  51 .It Cm M1
  52 Tasto 1 (sinistro) del mouse
  53 .It Cm M3
  54 Tasto 3 (destro) del mouse
  55 .El
  56 .Pp
  57 .Nm
  58 è molto semplice da usare. La maggior parte delle operazioni vengono
  59 svolte usando combinazioni di tasti sulla tastiera o sul mouse.
  60 Vedere la sezione
  61 .Sx SCORCIATOIE
  62 più sotto per i default e le possibilità di personalizzazione.
  63 .Sh FILE DI CONFIGURAZIONE
  64 .Nm
  65 prova per prima cosa ad aprire il file di configurazione personale
  66 dell'utente,
  67 .Pa ~/.scrotwm.conf .
  68 Se il file in questione non è disponibile, prova ad usare il file di
  69 configurazione globale
  70 .Pa /etc/scrotwm.conf .
  71 .Pp
  72 Il formato di questo file è \*(Ltchiave\*(Gt = \*(Ltvalore\*(Gt.
  73 Per esempio:
  74 .Pp
  75 .Dl color_focus = red
  76 .Pp
  77 Per abilitare o disabilitare un'opzione, usare i valori 1 o 0
  78 rispettivamente.
  79 .Pp
  80 Il file supporta le seguenti chiavi:
  81 .Pp
  82 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
  83 .It Cm color_focus
  84 Colore del bordo della finestra che ha il focus.
  85 .It Cm color_unfocus
  86 Colore del bordo delle finestre che non hanno il focus.
  87 .It Cm bar_enabled
  88 Abilita o disabilita la barra di stato.
  89 .It Cm bar_border Ns Bq Ar x
  90 Colore del bordo della barra di stato nello schermo
  91 .Ar x .
  92 .It Cm bar_color Ns Bq Ar x
  93 Colore della barra di stato nello schermo
  94 .Ar x .
  95 .It Cm bar_font_color Ns Bq Ar x
  96 Colore del testo della barra di stato nello schermo
  97 .Ar x .
  98 .It Cm bar_font
  99 Font della barra di stato.
 100 .It Cm bar_action
 101 Script esterno che aggiunge informazioni come la carica della batteria alla
 102 barra di stato.
 103 .It Cm bar_delay
 104 Frequenza di aggiornamento, in secondi, dello script esterno che aggiunge
 105 informazioni alla barra di stato.
 106 .It Cm stack_enabled
 107 Abilita o disabilita la visualizzazione dell'algoritmo di stacking
 108 corrente nella barra di stato.
 109 .It Cm clock_enabled
 110 Abilita o disabilita l'orologio nella barra di stato. Se disabilitato,
 111 usando il valore 0, è possibile usare un orologio personalizzato nello
 112 script specificato in bar_action.
 113 .It Cm dialog_ratio
 114 Alcune applicazioni hanno finestre di dialogo troppo piccole per risultare
 115 utili. Questa è la percentuale dello schermo che verrà usata per le finestre
 116 di dialogo: ad esempio, 0.6 indica il 60% della dimensione fisica dello
 117 schermo.
 118 .It Cm region
 119 Alloca una regione personalizzata, rimuovendo qualsiasi regione
 120 automaticamente rilevata stia occupando lo stesso spazio sullo schermo.
 121 Definita nel formato screen[<idx>]:LARGHEZZAxALTEZZA+X+Y, ad esempio
 122 \& screen[1]:800x1200+0+0.
 123 .It Cm term_width
 124 Imposta la dimensione minima preferita per il terminale. Se questo valore
 125 è maggiore di 0,
 126 .Nm
 127 cercherà di riaggiustare la dimensione del testo nel terminale in modo che
 128 la larghezza del terminale rimanga sopra il valore quando la finestra
 129 viene ridimensionata. Al momento solo
 130 .Xr xterm 1
 131 è supportato. Il binario di
 132 .Xr xterm 1
 133 deve essere setuid o setgid perché questo funzioni: nella maggior parte dei
 134 sistemi, questo è il default. L'utente potrebbe voler impostare
 135 program[term] (vedere la sezione
 136 .Sx PROGRAMMI
 137 più sotto) per usare una seconda copia del binario di
 138 .Xr xterm 1
 139 che non abbia il bit setgid impostato.
 140 .It Cm title_class_enabled
 141 Abilita o disabilita la visualizzazione della classe della finestra nella
 142 barra di stato. Impostare a 1 per abilitare.
 143 .It Cm title_name_enabled
 144 Abilita o disabilita la visualizzazione del titolo della finestra nella
 145 barra di stato. Impostare a 1 per abilitare.
 146 .It Cm modkey
 147 Cambia il tasto modificatore.
 148 Solitamente Mod1 è il tasto ALT e Mod4 è il tasto Windows su un PC.
 149 .It Cm program Ns Bq Ar p
 150 Definisce una nuova azione per lanciare il programma
 151 .Ar p .
 152 Vedere la sezione
 153 .Sx PROGRAMMI
 154 più sotto.
 155 .It Cm bind Ns Bq Ar x
 156 Assegna una combinazione di tasti all'azione
 157 .Ar x .
 158 Vedere la sezione
 159 .Sx SCORCIATOIE
 160 più sotto.
 161 .It Cm quirk Ns Bq Ar c:n
 162 Aggiunge un "quirk" per le finestre di classe
 163 .Ar c
 164 e nome
 165 .Ar n .
 166 Vedere la sezione
 167 .Sx QUIRKS
 168 più sotto.
 169 .El
 170 .Pp
 171 I colori devono essere specificati nel formato usato da
 172 .Xr XQueryColor 3
 173 e i font in quello usato da
 174 .Xr XQueryFont 3 .
 175 .Sh PROGRAMMI
 176 .Nm
 177 consente la definizione di azioni personalizzate per lanciare programmi di
 178 propria scelta, che possono essere assegnate a combinazioni di tasti nello
 179 stesso modo in cui è possibile farlo con le azioni predefinite.
 180 Vedere la sezione
 181 .Sx SCORCIATOIE
 182 più sotto.
 183 .Pp
 184 I programmi di default sono descritte qui sotto:
 185 .Pp
 186 .Bl -tag -width "screenshot_wind" -offset indent -compact
 187 .It Cm term
 188 xterm
 189 .It Cm screenshot_all
 190 screenshot.sh full
 191 .It Cm screenshot_wind
 192 screenshot.sh window
 193 .It Cm lock
 194 xlock
 195 .It Cm initscr
 196 initscreen.sh
 197 .It Cm menu
 198 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
 199 .El
 200 .Pp
 201 I programmi personalizzati vengono specificati con la seguente sintassi:
 202 .Pp
 203 .Dl program[<nome>] = <percorso> [<arg> [... <arg>]]
 204 .Pp
 205 .Aq nome
 206 è un qualsiasi identificatore che non va in conflitto con un'azione
 207 predefinita o una chiave,
 208 .Aq percorso
 209 è il programma desiderato, e
 210 .Aq arg
 211 sono zero o più argomenti da passare al programma.
 212 .Pp
 213 Le seguenti variabili rappresentano valori impostabili in
 214 .Nm
 215 (vedere la sezione
 216 .Sx FILE DI CONFIGURAZIONE
 217 sopra), e possono essere usati nel campo
 218 .Aq arg
 219 dove saranno sostituite con il valore al momento del lancio del programma:
 220 .Pp
 221 .Bl -tag -width "$bar_font_color" -offset indent -compact
 222 .It Cm $bar_border
 223 .It Cm $bar_color
 224 .It Cm $bar_font
 225 .It Cm $bar_font_color
 226 .It Cm $color_focus
 227 .It Cm $color_unfocus
 228 .El
 229 .Pp
 230 Esempio:
 231 .Bd -literal -offset indent
 232 program[ff] = /usr/local/bin/firefox http://scrotwm.org/
 233 bind[ff] = Mod+f # adesso Mod+F lancia firefox
 234 .Ed
 235 .Pp
 236 Per eliminare la combinazione precedente:
 237 .Bd -literal -offset indent
 238 bind[] = Mod+f
 239 program[ff] =
 240 .Ed
 241 .Pp
 242 .Sh SCORCIATOIE
 243 .Nm
 244 fornisce molte funzioni (o azioni) accessibili tramite combinazioni di
 245 tasti sul mouse o sulla tastiera.
 246 .Pp
 247 Le scorciatoie assegnate al mouse sono:
 248 .Pp
 249 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
 250 .It Cm M1
 251 Dà focus alla finestra
 252 .It Cm M-M1
 253 Muove la finestra
 254 .It Cm M-M3
 255 Ridimensiona la finestra
 256 .It Cm M-S-M3
 257 Ridimensiona la finestra mantenendola centrata
 258 .El
 259 .Pp
 260 Le scorciatoie da tastiera di default sono:
 261 .Pp
 262 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
 263 .It Cm M-S- Ns Aq Cm Return
 264 term
 265 .It Cm M-p
 266 menu
 267 .It Cm M-S-q
 268 quit
 269 .It Cm M-q
 270 restart
 271 .Nm
 272 .It Cm M- Ns Aq Cm Space
 273 cycle_layout
 274 .It Cm M-S- Ns Aq Cm Space
 275 reset_layout
 276 .It Cm M-h
 277 master_shrink
 278 .It Cm M-l
 279 master_grow
 280 .It Cm M-,
 281 master_add
 282 .It Cm M-.
 283 master_del
 284 .It Cm M-S-,
 285 stack_inc
 286 .It Cm M-S-.
 287 stack_del
 288 .It Cm M- Ns Aq Cm Return
 289 swap_main
 290 .It Xo
 291 .Cm M-j ,
 292 .Cm M- Ns Aq Cm TAB
 293 .Xc
 294 focus_next
 295 .It Xo
 296 .Cm M-k ,
 297 .Cm M-S- Ns Aq Cm TAB
 298 .Xc
 299 focus_prev
 300 .It Cm M-m
 301 focus_main
 302 .It Cm M-S-j
 303 swap_next
 304 .It Cm M-S-k
 305 swap_prev
 306 .It Cm M-b
 307 bar_toggle
 308 .It Cm M-x
 309 wind_del
 310 .It Cm M-S-x
 311 wind_kill
 312 .It Cm M- Ns Aq Ar n
 313 .Ns ws_ Ns Ar n
 314 .It Cm M-S- Ns Aq Ar n
 315 .Ns mvws_ Ns Ar n
 316 .It Cm M- Ns Aq Cm Right
 317 ws_next
 318 .It Cm M- Ns Aq Cm Left
 319 ws_prev
 320 .It Cm M-S- Ns Aq Cm Right
 321 screen_next
 322 .It Cm M-S- Ns Aq Cm Left
 323 screen_prev
 324 .It Cm M-s
 325 screenshot_all
 326 .It Cm M-S-s
 327 screenshot_wind
 328 .It Cm M-S-v
 329 version
 330 .It Cm M-t
 331 float_toggle
 332 .It Cm M-S Aq Cm Delete
 333 lock
 334 .It Cm M-S-i
 335 initscr
 336 .El
 337 .Pp
 338 I nomi delle azioni e le relative descrizioni sono le seguenti:
 339 .Pp
 340 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
 341 .It Cm term
 342 Lancia un nuovo terminale
 343 (vedi
 344 .Sx PROGRAMMI
 345 più in alto)
 346 .It Cm menu
 347 Menu
 348 (vedi
 349 .Sx PROGRAMMI
 350 più in alto)
 351 .It Cm quit
 352 Chiude
 353 .Nm
 354 .It Cm restart
 355 Riavvia
 356 .Nm
 357 .It Cm cycle_layout
 358 Cambia layout
 359 .It Cm reset_layout
 360 Re-inizializza il layout
 361 .It Cm master_shrink
 362 Restringe l'area principale
 363 .It Cm master_grow
 364 Allarga l'area principale
 365 .It Cm master_add
 366 Aggiunge finestre all'area principale
 367 .It Cm master_del
 368 Rimuove finestre dall'area principale
 369 .It Cm stack_inc
 370 Aggiunge righe/colonne all'area di stacking
 371 .It Cm stack_del
 372 Rimuove righe/colonne dall'area di stacking
 373 .It Cm swap_main
 374 Muove la finestra corrente nell'area principale
 375 .It Cm focus_next
 376 Dà il focus alla finestra successiva
 377 .It Cm focus_prev
 378 Dà il focus alla finestra precedente
 379 .It Cm focus_main
 380 Dà il focus alla finestra principale
 381 .It Cm swap_next
 382 Scambia con la finestra successiva dell'area di lavoro
 383 .It Cm swap_prev
 384 Scambia con la finestra precedente dell'area di lavoro
 385 .It Cm bar_toggle
 386 Mostra/nascondi la barra di stato da tutte le aree di lavoro
 387 .It Cm wind_del
 388 Chiudi la finestra corrente
 389 .It Cm wind_kill
 390 Distruggi la finestra corrente
 391 .It Cm ws_ Ns Ar n
 392 Passa all'area di lavoro
 393 .Ar n ,
 394 dove
 395 .Ar n
 396 è compreso tra 1 e 10
 397 .It Cm mvws_ Ns Ar n
 398 Sposta la finestra corrente nell'area di lavoro
 399 .Ar n ,
 400 dove
 401 .Ar n
 402 è compreso tra 1 e 10
 403 .It Cm ws_next
 404 Passa all'area di lavoro non vuota successiva
 405 .It Cm ws_prev
 406 Passa all'area di lavoro non vuota precedente
 407 .It Cm screen_next
 408 Sposta il puntatore nella regione successiva
 409 .It Cm screen_prev
 410 Sposta il puntatore nella regione precedente
 411 .It Cm screenshot_all
 412 Cattura uno screenshot dell'intero schermo, se abilitato (vedere la sezione
 413 .Sx PROGRAMMI
 414 sopra)
 415 .It Cm screenshot_wind
 416 Cattura uno screenshot di una singola finestra, se abilitato (vedere la
 417 sezione
 418 .Sx PROGRAMMI
 419 sopra)
 420 .It Cm version
 421 Abilita/disabilita il numero di versione nella barra di stato
 422 .It Cm float_toggle
 423 Passa la finestra che ha il focus da floating a tiled
 424 .It Cm lock
 425 Blocca lo schermo (vedere la sezione
 426 .Sx PROGRAMMI
 427 sopra)
 428 .It Cm initscr
 429 Re-inizializza gli schermi fisici (vedere la sezione
 430 .Sx PROGRAMMI
 431 sopra)
 432 .El
 433 .Pp
 434 Le scorciatoie personalizzate sono specificate nel file di configurazione
 435 come segue:
 436 .Pp
 437 .Dl bind[<azione>] = <tasti>
 438 .Pp
 439 .Aq azione
 440 è una delle azioni elencate sopra (oppure nulla) e
 441 .Aq tasti
 442 è dato da zero o più modificatori (MOD, Mod1, Shift, ecc.) e uno o più
 443 tasti normali (b, space, ecc.), separati da "+".
 444 Per esempio:
 445 .Bd -literal -offset indent
 446 bind[reset] = Mod4+q # assegna reset ai tasti Windows + q
 447 bind[] = Mod1+q # rimuovi l'assegnazione di Alt + q
 448 .Ed
 449 .Pp
 450 Più combinazioni di tasti possono essere assegnate alla stessa azione.
 451 .Sh QUIRK
 452 .Nm
 453 fornisce la possibilità di specificare dei "quirk" per la gestione di
 454 finestre che devono subire un trattamento speciale da un gestore di finestre
 455 tiling, come ad esempio alcune finestre di dialogo e applicazioni a
 456 schermo intero.
 457 .Pp
 458 I quirk abilitati di default sono elencati qui sotto:
 459 .Pp
 460 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
 461 .It Firefox\-bin:firefox\-bin
 462 TRANSSZ
 463 .It Firefox:Dialog
 464 FLOAT
 465 .It Gimp:gimp
 466 FLOAT + ANYWHERE
 467 .It MPlayer:xv
 468 FLOAT + FULLSCREEN
 469 .It OpenOffice.org 2.4:VCLSalFrame
 470 FLOAT
 471 .It OpenOffice.org 3.1:VCLSalFrame
 472 FLOAT
 473 .It pcb:pcb
 474 FLOAT
 475 .It xine:Xine Window
 476 FLOAT + ANYWHERE
 477 .It xine:xine Panel
 478 FLOAT + ANYWHERE
 479 .It xine:xine Video Fullscreen Window
 480 FULLSCREEN + FLOAT
 481 .It Xitk:Xitk Combo
 482 FLOAT + ANYWHERE
 483 .It Xitk:Xine Window
 484 FLOAT + ANYWHERE
 485 .It XTerm:xterm
 486 XTERM_FONTADJ
 487 .El
 488 .Pp
 489 I quirk sono descritti qui sotto:
 490 .Pp
 491 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
 492 .It FLOAT
 493 Questa finestra deve essere lasciata libera di muoversi.
 494 .It TRANSSZ
 495 Aggiusta la dimensione delle finestre troppo piccole usando dialog_ratio
 496 (vedere
 497 .Sx FILE DI CONFIGURAZIONE ) .
 498 .It ANYWHERE
 499 Consente alla finestra di decidere da sola dove posizionarsi.
 500 .It XTERM_FONTADJ
 501 Aggiusta il font di xterm quando viene ridimensionata la finestra.
 502 .It FULLSCREEN
 503 Rimuove i bordi, consentendo alla finestra di usare l'intera dimensione
 504 dello schermo.
 505 .El
 506 .Pp
 507 I quirk personalizzati vanno specificati nel file di configurazione come
 508 segue:
 509 .Pp
 510 .Dl quirk[<classe>:<nome>] = <quirk> [ + <quirk> ... ]
 511 .Pp
 512 .Aq classe
 513 e
 514 .Aq nome
 515 specificano a quali finestre i quirk vanno applicati, e
 516 .Aq quirk
 517 è uno dei quirk presente nella lista sopra.
 518 Ad esempio:
 519 .Bd -literal -offset indent
 520 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # lascia che mplayer suoni
 521 quirk[pcb:pcb] = NONE  # rimuovi un quirk precedentemente specificato
 522 .Ed
 523 .Pp
 524 È possibile ottenere
 525 .Aq classe
 526 e
 527 .Aq nome
 528 usando xprop(1) e facendo click sulla finestra desiderata.
 529 Nel seguente esempio è stato fatto click sulla finestra principale di
 530 Firefox:
 531 .Bd -literal -offset indent
 532 $ xprop | grep WM_CLASS
 533 WM_CLASS(STRING) = "Navigator", "Firefox"
 534 .Ed
 535 .Pp
 536 Bisogna tener conto del fatto che usare grep per trovare WM_CLASS inverte
 537 la classe e il nome. Nell'esempio precedente, la dichiarazione del quirk
 538 sarebbe
 539 .Bd -literal -offset indent
 540 quirk[Firefox:Navigator] = FLOAT
 541 .Ed
 542 .Sh FILE
 543 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
 544 .It Pa ~/.scrotwm.conf
 545 impostazioni di
 546 .Nm
 547 dell'utente.
 548 .It Pa /etc/scrotwm.conf
 549 impostazioni globali di
 550 .Nm .
 551 .El
 552 .Sh ORIGINE
 553 .Nm
 554 prende ispirazione da xmonad & dwm.
 555 .Sh AUTORI
 556 .An -nosplit
 557 .Pp
 558 .Nm
 559 è stato scritto da
 560 .An Marco Peereboom Aq marco@peereboom.us ,
 561 .An Ryan Thomas McBride Aq mcbride@countersiege.com
 562 e
 563 .An Darrin Chandler Aq dwchandler@stilyagin.com .
 564 .Sh BUGS
 565 Al momento il menu, invocato usando
 566 .Cm M-p ,
 567 dipende da dmenu.