From 26bb3f5b3a491b120e93c1c2225dc620210d449d Mon Sep 17 00:00:00 2001 From: Marco Peereboom Date: Wed, 7 Oct 2009 03:19:11 +0000 Subject: [PATCH] Man page fixes and italian page from: Andrea Bolognani --- Makefile | 2 +- release.sh | 2 +- scrotwm.1 | 4 +- scrotwm_es.1 | 4 +- scrotwm_it.1 | 567 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 573 insertions(+), 6 deletions(-) create mode 100644 scrotwm_it.1 diff --git a/Makefile b/Makefile index 81dc65e..02570ea 100644 --- a/Makefile +++ b/Makefile @@ -7,7 +7,7 @@ BINDIR=${PREFIX}/bin SUBDIR= lib PROG=scrotwm -MAN=scrotwm.1 scrotwm_es.1 +MAN=scrotwm.1 scrotwm_es.1 scrotwm_it.1 CFLAGS+=-std=c89 -Wall -Wno-uninitialized -ggdb3 CPPFLAGS+= -I${X11BASE}/include diff --git a/release.sh b/release.sh index 2d3a9b7..3a34419 100644 --- a/release.sh +++ b/release.sh @@ -4,7 +4,7 @@ PREFIX=scrotwm- DIRS="lib linux" -FILES="Makefile baraction.sh initscreen.sh screenshot.sh scrotwm.1 scrotwm_es.1 scrotwm.c scrotwm.conf linux/Makefile linux/linux.c linux/util.h lib/Makefile lib/shlib_version lib/swm_hack.c" +FILES="Makefile baraction.sh initscreen.sh screenshot.sh scrotwm.1 scrotwm_es.1 scrotwm_it.1 scrotwm.c scrotwm.conf linux/Makefile linux/linux.c linux/util.h lib/Makefile lib/shlib_version lib/swm_hack.c" if [ -z "$1" ]; then echo "usage: release.sh " diff --git a/scrotwm.1 b/scrotwm.1 index fa0fbc2..8b5277c 100644 --- a/scrotwm.1 +++ b/scrotwm.1 @@ -191,7 +191,7 @@ 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 +dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color .El .Pp Custom programs in the configuration file are specified as follows: @@ -454,7 +454,7 @@ in a tiling window manager, such as some dialogs and fullscreen apps. The default quirks are described below: .Pp .Bl -tag -width "OpenOffice.org N.M:VCLSalFrameXXX" -offset indent -compact -.It Firefox-bin:firefox-bin +.It Firefox\-bin:firefox\-bin TRANSSZ .It Firefox:Dialog FLOAT diff --git a/scrotwm_es.1 b/scrotwm_es.1 index 9332858..8d3d288 100644 --- a/scrotwm_es.1 +++ b/scrotwm_es.1 @@ -189,7 +189,7 @@ 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 +dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color .El .Pp Los programas en la configuración personal, se especifican aca: @@ -455,7 +455,7 @@ como por ejemplo, popups, aplicaciones de pantalla completa, etc. Los "quirks" (o forzados) por defecto son: .Pp .Bl -tag -width "OpenOffice.org N.M:VCLSalFrameXXX" -offset indent -compact -.It Firefox-bin:firefox-bin +.It Firefox\-bin:firefox\-bin TRANSSZ .It Firefox:Dialog FLOAT diff --git a/scrotwm_it.1 b/scrotwm_it.1 new file mode 100644 index 0000000..55c641a --- /dev/null +++ b/scrotwm_it.1 @@ -0,0 +1,567 @@ +.\" $scrotwm$ +.\" +.\" Copyright (c) 2009 Marco Peereboom +.\" Copyright (c) 2009 Darrin Chandler +.\" +.\" 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[]: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[] = [ [... ]] +.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-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-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-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[] = +.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:VCLSalFrameXXX" -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_FONTADJXXX" -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[:] = [ + ... ] +.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. -- 1.7.10.4