spectrwm/scrotwm_es.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 NOMBRE
.Nm scrotwm
.Nd es un manejador de ventanas para X11
.Sh SYNOPSIS
.Nm scrotwm
.Sh DESCRIPCI<EFBFBD>N
.Nm
es un manejador de ventanas super minimalista para X11. Intenta no superponer 
las ventanas para que las mismas puedan usarse de manera eficiente y para cosas mas importantes. 
Tiene configuraciones normales y no requiere que sepas un lenguaje de 
programacion para configurarlo. Esta escrito por hackers para hackers y apunta 
a ser peque<75>o, compacto y r<>pido. 
.Pp
Cuando
.Nm
inicia, lo primero que hace es leer el archivo de configuracion,
.Pa scrotwm.conf .
Ver 
.Sx ARCHIVOS DE CONFIGURACI<EFBFBD>N
.
.Pp
La siguiente anotacion se usa a trav<61>s de esta pagina:
.Pp
.Bl -tag -width Ds -offset indent -compact
.It Cm M
Meta
.It Cm S
Shift
.It Aq Cm Name
Nombre de tecla
.It Cm M1
Boton 1 del mouse
.It Cm M3
Boton 3 del mouse
.El
.Pp
.Nm
es muy simple de usar.
La mayoria de las acciones se hacen con los mapeos (bindings) de mouse 
o teclado.
Ver la secci<63>n de
.Sx BINDINGS
para las personalizaciones y configuraciones por defecto.
.Sh ARCHIVOS DE CONFIGURACI<EFBFBD>N
.Nm
primero trata de abrir el archivo por defecto en el directorio del usuario,
.Pa ~/.scrotwm.conf .
Si ese archivo no esta disponible,
luego trata de abrir el archivo global de configuracion
.Pa /etc/scrotwm.conf .
.Pp
El formato del archivo es \*(Lttecla\*(Gt = \*(Ltconfiguracion\*(Gt.
Por ejemplo:
.Pp
.Dl color_focus = red
.Pp
Habilitamos o deshabilitamos la opci<63>n usando 1 o 0 respectivamente.
.Pp
El archivo soporta las siguientes palabras clave:
.Pp
.Bl -tag -width "title_class_enabledXXX" -offset indent -compact
.It Cm color_focus
Color del borde de la ventana en foco.
.It Cm color_unfocus
Color del borde de la ventana fuera de foco.
.It Cm bar_enabled
Habilitar o deshabilitar la barra de estado.
.It Cm bar_border Ns Bq Ar x
Color del borde de la barra de estado en pantalla.
.Ar x .
.It Cm bar_color Ns Bq Ar x
Color de la ventana de la barra de estado en pantalla.
.Ar x .
.It Cm bar_font_color Ns Bq Ar x
Color de la fuente en la barra de estado en pantalla.
.Ar x .
.It Cm bar_font
Fuente de la barra de estado.
.It Cm bar_action
Scripts externos con populares agregados de informaci<63>n para la barra 
de estado, como la vida de la bateria.
.It Cm bar_delay
Frecuencia de actualizaci<63>n, en segundos, de los scripts de la barra de 
estado.
.It Cm bar_at_bottom
Puedes posicionar la statusbar en la parte inferior de la pantalla.
.It Cm stack_enabled
Habilitar o deshabilitar mostrar el algoritmo de apilamiento en la barra
de estado.
.It Cm clock_enabled
Habilitar o deshabilitar el reloj en la barra de estado, deshabilitado 
por defecto con un 0, para usar el reloj de la barra de estado 
(bar_action)
.It Cm dialog_ratio
Algunas aplicaciones tienen ventanas de dialogo muy peque<75>as como para 
ser usables. Este relaci<63>n (ratio) es el tama<6D>o de la pantalla, por 
ejemplo 0.6 es 60% del tama<6D>o f<>sico de la pantalla.
.It Cm region
Acomodar una region personalizada, removiendo cualquier autodeteci<63>n de 
regiones que ocupe el espacio en la pantalla. 
Definiendo el formato screen[<idx>]:WIDTHxHEIGHT+X+Y,
e.g.\& screen[1]:800x1200+0+0.
.It Cm term_width
Setear un ancho minimo preferido para la terminal.
Si el valor es mayor que 0,
.Nm
intentar<EFBFBD> ajustar el tama<6D>o de la fuente de la terminal para mantener 
el ancho de la terminal por encima de este n<>mero cuando la ventana 
cambia de tama<6D>o.
Actualmente solo es soportado por
.Xr xterm 1
El binario de
.Xr xterm 1
no debe ser un setuid o setgid, que no sea el que viene por defecto en 
la mayoria de los sistemas.
Los usuarios pueden necesitar setear program[term] (ver la secci<63>n
.Sx PROGRAMAS
) para usar una copia alternativa del binario de
.Xr xterm 1
sin el seteo del setgid.
.It Cm title_class_enabled
Habilitar o deshabilitar la clase de ventana en la barre de estado.
Habilitado seteando 1
.It Cm title_name_enabled
Habilitar o deshabilita el titulo de la ventana en la barra de estado.
Habilitado seteando 1
.It Cm window_name_enabled
Habilitar o deshabilita el nombre de la ventana en la barra de estado.
Habilitado seteando 1
.It Cm modkey
Cambiar mod key.
Mod1 generalmente es la tecla ALT y Mod4 la tecla de windows en una PC.
.It Cm focus_mode
Usando el valor de follow_cursor puedes hacer que el manejador de ventanas
se enfoque en la ventana cuando el cursor pase por arriba de las mismas o
bien cambiando de estacion de trabajo.
.It Cm disable_border
Remueve el borde de una sola ventana cuando la barra de estado esta desactivada.
.It Cm program Ns Bq Ar p
Definir una nueva accion para ejecutar un programa.
.Ar p .
Ver la secci<63>n de
.Sx PROGRAMAS
.It Cm bind Ns Bq Ar x
Combinaci<EFBFBD>n de teclas para una acci<63>n
.Ar x .
Ver la secci<63>n
.Sx BINDINGS
.It Cm quirk Ns Bq Ar c:n
Agregar un "quirk" (o forzados) para ventanas con clase
.Ar c
y nombre
.Ar n .
Ver la secci<63>n
.Sx QUIRKS
.El
.Pp
Los colores deben ser especificados por la especificaci<63>n
.Xr XQueryColor 3
y las fuentes por la especificaci<63>n
.Xr XQueryFont 3
.Sh PROGRAMAS
.Nm
te permite definir acciones personales para lanzar los programas que 
quieras y luego obligar a la misma con una funci<63>n de acciones.
Ver la secci<63>n
.Sx BINDINGS
.Pp
Los programas por defecto se describen ac<61>:
.Pp
.Bl -tag -width "screenshot_wind" -offset indent -compact
.It Cm term
xterm
.It Cm screenshot_all
screenshot.sh completo
.It Cm screenshot_wind
screenshot.sh por ventana
.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
Los programas en la configuraci<63>n personal, se especifican aca:
.Pp
.Dl program[<nombre>] = <progpath> [<arg> [... <arg>]]
.Pp
.Aq nombre
es un identificador, no genera conflictos con ninguna accion o palabra 
clave,
.Aq progpath
es la ruta al programa, y
.Aq arg
es ninguno o mas de un argumento para el programa.
.Pp
Las siguientes variables de configuracion en
.Nm
(ver 
.Sx ARCHIVOS DE CONFIGURACI<EFBFBD>N
),
y pueden ser usadas en los campos de
.Aq arg
como asi tambien sustituidas por valores al momento del inicio de un 
programa:
.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
Ejemplo:
.Bd -literal -offset indent
program[ff] = /usr/local/bin/firefox http://scrotwm.com.ar/
bind[ff] = Mod+f # Ahora Mod+F inicia firefox
.Ed
.Pp
Para deshacer lo anterior:
.Bd -literal -offset indent
bind[] = Mod+f
program[ff] =
.Ed
.Sh SIGNALS
Enviando
.Nm
una se?al de HUP reinicia scrotwm.
.Pp
.Sh BINDINGS
.Nm
provee muchas funciones (o acciones) accesibles por medio de la 
asignaci<EFBFBD>n (bindings) de teclas o el mouse.
.Pp
Las corrientes asignaciones (bindings) del mouse son:
.Pp
.Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
.It Cm M1
Enfoco una ventana
.It Cm M-M1
Muevo una ventana
.It Cm M-M3
Redimenciono una ventana
.It Cm M-S-M3
Redimenciono una ventana hasta que quede centrada
.El
.Pp
Las corrientes asignaciones (bindings) de teclas son:
.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-a
ws_prior
.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
El nombre de las acci<63>nes descripta a continuaci<63>n:
.Pp
.Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
.It Cm term
Ejecutar una terminal
(ver
.Sx PROGRAMAS
)
.It Cm menu
Menu
(ver
.Sx PROGRAMAS
)
.It Cm quit
Salir
.Nm
.It Cm restart
Reiniciar
.Nm
.It Cm cycle_layout
Disposici<EFBFBD>n de las ventanas
.It Cm reset_layout
Reiniciar la disposici<63>n de las ventanas
.It Cm master_shrink
Achicar la region principal
.It Cm master_grow
Agrandar la region principal
.It Cm master_add
Agregar una ventana a la region principal
.It Cm master_del
Quitar una ventana de la region principal
.It Cm stack_inc
Agregar columnas/filas a las pilas
.It Cm stack_del
Quitar columnas/filas de las pilas
.It Cm swap_main
Mover la ventana corriente a la region principal
.It Cm focus_next
Enfocar la proxima ventana en la estaci<63>n de trabajo
.It Cm focus_prev
Enfocar la anterior ventana en la estaci<63>n de trabajo
.It Cm focus_main
Enfocar en la ventana principal de la estaci<63>n de trabajo
.It Cm swap_next
Ejecutar con la siguiente ventana en la estaci<63>n de trabajo
.It Cm swap_prev
Ejecutar con la anterior ventana en la estaci<63>n de trabajo
.It Cm bar_toggle
Cambiar la barra de estado en todas las estaciones de trabajo
.It Cm wind_del
Borrar la ventana corriente en la estaci<63>n de trabajo
.It Cm wind_kill
Destruir la ventana corriente en la estaci<63>n de trabajo
.It Cm ws_ Ns Ar n
Cambiar entre estaciones de trabajo
.Ar n ,
donde
.Ar n
es 1 por 10
.It Cm mvws_ Ns Ar n
Mover la ventana corriente a una estaci<63>n de trabajo
.Ar n ,
donde
.Ar n
es 1 por 10
.It Cm ws_next
Cambiar a la proxima estaci<63>n de trabajo con una ventana en ella
.It Cm ws_prev
Cambiar a la anterior estaci<63>n de trabajo con una ventana en ella
.It Cm screen_next
Mover el puntero a la proxima region
.It Cm screen_prev
Mover el puntero a la anterior region
.It Cm screenshot_all
Tomar una captura de pantalla de todo la pantalla (si esta habilitado)
(ver
.Sx PROGRAMAS
)
.It Cm screenshot_wind
Tomar una captura de pantalla de la ventana seleccionada (si esta habilitado)
(ver
.Sx PROGRAMAS
)
.It Cm version
Mostrar la version en la barra de estado
.It Cm float_toggle
Mostar la ventana en foco entre las flotantes y acomodadas
.It Cm lock
Bloquear pantalla
(ver
.Sx PROGRAMAS
)
.It Cm initscr
Reiniciar la pantalla
(ver
.Sx PROGRAMAS
)
.El
.Pp
Personalizar mapeos (bindings) en el archivo de configuraci<63>n:
.Pp
.Dl bind[<accion>] = <teclas>
.Pp
.Aq accion
una de las acciones listadas (o ninguna) y
.Aq teclas
una o mas teclas modificadas (puede ser ninguna tambien)
(MOD, Mod1, Shift, etc.) y una o mas teclas normales
(b, barra espaciadora, etc.), separadas por un "+".
Por ejemplo:
.Bd -literal -offset indent
bind[reset] = Mod4+q # combinaci<63>n Tecla de Windows + q reinicia
bind[] = Mod1+q # des-hace la combinaci<63>n Alt + q
.Ed
.Pp
Multiples combinaciones de teclas pueden hacer lo mismo.
.Sh QUIRKS
.Nm
te da "quirks" (o forzados) ventanas que tienen que ser tratas de manera especial,
como por ejemplo, popups, aplicaciones de pantalla completa, etc.
.Pp
Los "quirks" (o forzados) por defecto son:
.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
Los "quirks" (o forzados) se describen a continuaci<63>n:
.Pp
.Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
.It FLOAT
Esta ventana no tiene que ser acomodada, pero le permitimos flotar libremente.
.It TRANSSZ
Ajusta el tama<6D>o de las ventanas transitorias que son demasiado peque<75>as utilizando dialog_ratio
(ver
.Sx ARCHIVOS DE CONFIGURACI<EFBFBD>N ) .
.It ANYWHERE
Permite que la ventana se ponga donde quiera.
.It XTERM_FONTADJ
Ajusta las fuentes de xterm cuando se redimenciona.
.It FULLSCREEN
Quita el borde para permitir las ventanas en pantalla completa.
.El
.Pp
Las configuraciones de "quirks" (o forzados) en el archivo de configuraci<63>n se ven a continuaci<63>n:
.Pp
.Dl quirk[<clases>:<nombre>] = <quirk> [ + <quirk> ... ]
.Pp
.Aq clases
y
.Aq nombre
especifica la ventana en la cual el "quirk(s)" (o forzados) se aplica, y
.Aq quirk
es uno de los "quirks" (o forzados) de la lista.
Por ejemplo:
.Bd -literal -offset indent
quirk[MPlayer:xv] = FLOAT + FULLSCREEN # dejamos que mplayer funcione libremente
quirk[pcb:pcb] = NONE  # borramos el quirk existente
.Ed
.Pp
Podes obtener
.Aq clases
y
.Aq nombre
corriendo el programa xprop(1) y luego clickear en la ventana que quieras.
En el proximo ejemplo, podremos verlo en acci<63>n con una ventana de Firefox:
.Bd -literal -offset indent
$ xprop | grep WM_CLASS
WM_CLASS(STRING) = "Navigator", "Firefox"
.Ed
.Sh ARCHIVOS
.Bl -tag -width "/etc/scrotwm.confXXX" -compact
.It Pa ~/.scrotwm.conf
.Nm
archivo de configuraci<63>n especifico del usuario.
.It Pa /etc/scrotwm.conf
.Nm
configuraciones globales.
.El
.Sh HISTORIA
.Nm
fue inspirado en xmonad y dwm.
.Sh AUTORES
.An -nosplit
.Pp
.Nm
fue escrito por
.An Marco Peereboom Aq marco@peereboom.us ,
.An Ryan Thomas McBride Aq mcbride@countersiege.com
and
.An Darrin Chandler Aq dwchandler@stilyagin.com .
.Sh BUGS
Actualmente el menu, se llama con
.Cm M-p ,
depende de dmenu.