* update of new manpage (thanx Guillermo Patterer)

3 files changed, 150 insertions, 13 deletions

diff --git a/doc/asciidoc/fluxbox.1 b/doc/asciidoc/fluxbox.1
index 2a09587..5b24bc1 100644
--- a/doc/asciidoc/fluxbox.1
+++ b/doc/asciidoc/fluxbox.1
@@ -2,7 +2,7 @@
 .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
 .\" Instead of manually editing it, you probably should edit the DocBook XML
 .\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "FLUXBOX" "1" "04/28/2006" "" ""
+.TH "FLUXBOX" "1" "06/01/2006" "" ""
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -105,7 +105,7 @@ The window that has the focus is the one that receives key and mouse events. The
 .SS "Windows"
 A left click (mouse button 1) on any part of the window's border will raise it. Dragging then moves the window to another part of the desktop. Dragging the resize grips at the left and right bottom corners resizes the window. Middle clicking on a border or titlebar will immediately lower the window. Right clicking on a border or titlebar pops the Window menu up. The commands in this menu alone are discussed in detail in the Window Menu section of MENUS.
 .SS "Tabs"
-fluxbox allows windows to be `grouped' by middle clicking and holding on a window's title bar and dragging it onto another window. This will `tab' the titlebars, allowing you the user to select each window individually. This `tabbing' allows you to put multiple applications in one location on the desktop, and do several operations (for example, moving or resizing) to all windows in the group.
+fluxbox allows windows to be `grouped' by middle clicking and holding on a window's title bar and dragging it onto another window. This will `tab' the titlebars, allowing you the user to select each window individually. This `tabbing' allows you to put multiple applications in one location on the desktop, and do several operations (for example, moving or resizing) to all windows in the group. Options are discussed in TAB OPTIONS section
 .SS "Miscellaneous"
 When you want to drag a window, but cannot see either the bottom handle or its titlebar you can press (and hold!)
 .sp
@@ -185,6 +185,9 @@ This menu offers the opportunity to set up fluxbox. It ca also achieved by editi
 \fBFocus Model\fR: Please read the FOCUS MODEL section at the end of this manual.
 .TP
 \(bu
+\fBTab Options\fR: Lets you configure the properties of tabs. Detailed in TAB OPTIONS section.
+.TP
+\(bu
 \fBSlit\fR: This Menu can be opened by right clicking the slit (if visible).
 .TP
 \(bu
@@ -1141,6 +1144,54 @@ Thus, there are four main options when choosing a focus model. You should choose
 \(bu
 \fBMouseTabFocus\fR: tab focus follows mouse
 There is one more option in the focus model menu. It is called AutoRaise. When AutoRaise is enabled, focused windows will appear on top of other windows in the same layer. When AutoRaise is disabled, you must explicitly raise a focused window, using the window menu or keybinding.
+.SH "TAB OPTIONS"
+This section of fluxbox configuration menu lets you configure many features of tabs. Inside of it there are three main options:
+.TP 3
+\(bu
+\fBPlacement\fR: you can choose where the external tabs must be positioned. The options are:
+.RS
+.TP 3
+\(bu
+Top Left: tabs are located on the left side of the top border of the window.
+.TP
+\(bu
+Top Right: tabs are located on the right side of the top border of the window.
+.TP
+\(bu
+Left Top: tabs are located on the top part of the left border of the window.
+.TP
+\(bu
+Right Top: tabs are located on the top part of the right border of the window.
+.TP
+\(bu
+Left Bottom: tabs are located on the bottom part of the left border of the window.
+.TP
+\(bu
+Right Bottom: tabs are located on the bottom part of the right border of the window.
+.TP
+\(bu
+Bottom Left: tabs are located on the left side of the bottom border of the window.
+.TP
+\(bu
+Bottom Right: tabs are located on the right side of the bottom border of the window.
+.sp
+.nf
+for this options to work 'Tabs in Titlebar' must be off.
+.fi
+.RE
+.TP
+\(bu
+\fBTabs in Titlebar\fR: when this option is on tabs are fixed in window titlebar and its width varies according to the amount of windows grouped.
+.TP
+\(bu
+\fBExternal Tab Width\fR: it specifies in pixels the width of external tabs.
+As most Fluxbox configurations this can be done by editing the init file. The resources that you should look at are:
+.sp
+.nf
+session.screen0.tabs.intitlebar:    <boolean>
+session.screen0.tab.width:          <integer>
+session.screen0.tab.placement:      <direction>
+.fi
 .SH "STYLES"
 fluxbox enables you to use specialized files that contain X(1) resources to specify colors, textures, pixmaps and fonts, and thus the overall look of your window borders, menus and the toolbar.
 .sp
diff --git a/doc/asciidoc/fluxbox.es.txt b/doc/asciidoc/fluxbox.es.txt
index 53b2a29..c9753d4 100644
--- a/doc/asciidoc/fluxbox.es.txt
+++ b/doc/asciidoc/fluxbox.es.txt
@@ -1,7 +1,7 @@
 fluxbox(1)
 =========
 fluxgen <fluxgen@fluxbox.org>
-v0.9.14,
+v0.9.15, Marzo 18 de 2006
 
 NAME
 ------
@@ -9,24 +9,31 @@ Fluxbox - Un liviano manejador de ventanas para el X Windowing System
 
 SYNOPSIS
 --------
+'fluxbox' [-v | -version]
+          [-h | -help]
+          [-i | -info]
+'fluxbox' [-rc rcfile]
+          [-log logfile]
+          [-display display]
+          [-screen scr,scr|all]
+          [-verbose]
 
-'fluxbox' [\-vhi] [\-rc archivo_rc] [\-l archivo_log] [\-d display] [\-screens scr,scr]
 
 DESCRIPCION
 -----------
-Fluxbox provee decoraciones de ventanas configurables, un menu root para lanzar 
+fluxbox(1) provee decoraciones de ventanas configurables, un menu root para lanzar 
 aplicaciones y una barra de tareas que muestra el nombre del 'workspace' actual, 
 la aplicacion activa y la hora actual. Tambien hay un menu de workspace para 
 agregar o remover espacios de trabajo. La 'slit' puede ser usada para 'dockear' 
 pequenias aplicaciones, por ej.: la mayoria de las bbtools pueden usar la slit.
 
-Fluxbox puede iconificar las ventanas a la barra de tareas, agregando la ventana 
+fluxbox(1) puede iconificar las ventanas a la barra de tareas, agregando la ventana 
 al submenu 'Icons' del menu workspace. Con un click reapareceran las ventanas 
 iconificadas. Doble-click en la barra de titulo de una ventana la 'foldeara' 
 (shade), por ej.: desaparecera la ventana y quedara visible solamente la barra 
 de titulo.
 
-Fluxbox usa su propia clase de graficos para renderizar sus imagenes al vuelo. 
+fluxbox(1) usa su propia clase de graficos para renderizar sus imagenes al vuelo. 
 Mediante el uso de 'estilos' se puede determinar en gran nivel la apariencia de 
 un escritorio. Los estilos de Fluxbox son compatibles con los de Blackbox 0.65 o 
 versiones anteriores, de modo que los usuarios que esten migrando aun pueden 
@@ -39,7 +46,6 @@ caracteristicas standard usadas por aplicaciones y utilidades de escritorio.
 
 OPCIONES
 ----------
-Fluxbox reconoce las siguientes lineas de comandos:
 
 -d display |-display display::
     Inicia fluxbox en el 'display' especificado.
@@ -60,7 +66,7 @@ Fluxbox reconoce las siguientes lineas de comandos:
 
 INICIANDO FLUXBOX
 -----------------
-Fluxbox viene con un programa llamado startfluxbox(8) localizado generalmente
+fluxbox(1) viene con un programa llamado startfluxbox(8) localizado generalmente
 donde se instalo Fluxbox. Este script nos provee con muchas opciones
 y variables que pueden ser indicadas cuando al inicio de Fluxbox. Para utilizarlo
 cuando se inicia Fluxbox, se debe colocar 'exec startfluxbox' como ultimo comando 
@@ -70,7 +76,7 @@ y startfluxbox(8) estan en el $PATH del 'shell'. Tambien hay que notar que tal v
 haya que crear el archivo ~/.xinitrc o tal vez el setup use ~/.xsession. Para mas
 informacion ver el manual del shell.
 
-Usando 'fluxbox -i' se veran las opciones por defecto utilizadas por Fluxbox.
+Usando 'fluxbox -i' se veran las opciones por defecto utilizadas por fluxbox(1).
 Estas son las que busca al inicio. En la lista de 'Defaults:' la ubicacion de
 archivo menu, ahi se puede proveer un menu comun para todos los usuarios.
 
@@ -176,7 +182,8 @@ medio en la barra de titulo y luego arrastrando y soltando en otra ventana. De
 esta manera las barras de título se convertiran en pestanias permitiendo al usuario
 seleccionar cada ventana individualmente. Este metodo nos permite poner multiples
 aplicaciones en una sola localizacion en el escritorio, y hacer muchas operaciones
-(por ej. mover o cambiar de tamanio) a todas las ventanas del grupo.
+(por ej. mover o cambiar de tamanio) a todas las ventanas del grupo. Las opciones
+se detallan en la seccion TAB OPTIONS
 
 Miscelaneas
 ~~~~~~~~~~~
@@ -284,6 +291,10 @@ usuarios hacerlo desde el menu.
 - *Focus Model*:
         Por favor leer la seccion FOCUS MODEL al final de este manual.
 
+- *Tab Options*:
+        Nos permite configurar las propiedades de las 'tabs'. Se detalla en la
+        seccion TAB OPTIONS.
+
 - *Slit*:
         Este menu puede ser abierto clickeando sobre la Slit (si esta visible).
 
@@ -1248,6 +1259,40 @@ habilitada las ventanas enfocadas apareceran por encima de otras ventanas en la
 capa. Cuando esta deshabilitada se debe alzar explicitamente una ventana en foco usando
 el menu 'Window' o una combinacion de teclas.
 
+TAB OPTIONS
+-----------
+Esta seccion del menu de configuracion de fluxbox nos permite configurar muchas de las 
+caracteristicas de las tabs. Dentro de ella hay tres opciones principales:
+
+- *Placement*:
+    se puede elegir donde deben estar ubicadas las tabs externas. Las opciones son
+
+        * Top Left: las tabs se encuentran a la izquierda del borde superior de la ventana.
+        * Top Right: las tabs se encuentran a la derecha del borde superior de la ventana.
+        * Left Top: las tabs se encuentran en la parte superior del borde izquierdo de la ventana.
+        * Right Top: las tabs se encuentran en la parte superior del borde derecho de la ventana.
+        * Left Bottom: las tabs se encuentran en la parte inferior del borde izquierdo de la ventana.
+        * Right Bottom: las tabs se encuentran en la parte inferior del borde derecho de la ventana.
+        * Bottom Left: las tabs se encuentran a la izquierda del borde inferior de la ventana.
+        * Bottom Right: las tabs se encuentran a la derecha del borde inferior de la ventana.
+
+    para que estas opciones funcionen la opcion 'Tabs in Titlebar' debe estar desactivada.
+
+- *Tabs in Titlebar*:
+    cuando esta opcion esta activada las tabs estan fijas en la barra de titulo y su ancho varia 
+    de acuerdo a la cantidad de ventanas agrupadas.
+
+- *External Tab Width*:
+    especifica en pixels el ancho de las tabs externas.
+
+Como la mayoría de las configuraciones de fluxbox(1) esto se puede hacer editando el archivo init.
+Los recursos que debemos buscar son:
+
+    session.screen0.tabs.intitlebar:    <booleana>
+    session.screen0.tab.width:          <entero>
+    session.screen0.tab.placement:      <direccion>
+
+
 ESTILOS
 -------
 Fluxbox permite usar archivos especializados (estilos) que contienen recursos de las X(1) 
@@ -1599,4 +1644,5 @@ en el sitio web oficial.
 
 VER TAMBIEN
 -----------
-bsetroot(8) fbsetbg(8) fbrun(8) fluxstyle(8)
\ No newline at end of file
+bsetroot(8) fbsetbg(8) fbrun(8) fluxstyle(8)
+
diff --git a/doc/asciidoc/fluxbox.txt b/doc/asciidoc/fluxbox.txt
index 7008602..0dfba92 100644
--- a/doc/asciidoc/fluxbox.txt
+++ b/doc/asciidoc/fluxbox.txt
@@ -184,7 +184,7 @@ window's title bar and dragging it onto another window. This will `tab'
 the titlebars, allowing you the user to select each window individually.
 This `tabbing' allows you to put multiple applications in one location on
 the desktop, and do several operations (for example, moving or resizing)
-to all windows in the group.
+to all windows in the group. Options are discussed in TAB OPTIONS section
 
 Miscellaneous
 ~~~~~~~~~~~~~
@@ -298,6 +298,10 @@ editing the init file, but this is a easier and faster way to most users.
 - *Focus Model*:
     Please read the FOCUS MODEL section at the end of this manual.
 
+- *Tab Options*:
+    Lets you configure the properties of tabs. Detailed in TAB OPTIONS
+    section.
+
 - *Slit*:
     This Menu can be opened by right clicking the slit (if visible).
 
@@ -1269,6 +1273,41 @@ AutoRaise is enabled, focused windows will appear on top of other windows in
 the same layer. When AutoRaise is disabled, you must explicitly raise a focused
 window, using the window menu or keybinding.
 
+TAB OPTIONS
+-----------
+This section of fluxbox configuration menu lets you configure many features of 
+tabs. Inside of it there are three main options:
+
+- *Placement*:
+    you can choose where the external tabs must be positioned. The options are:
+
+        * Top Left: tabs are located on the left side of the top border of the window.
+        * Top Right: tabs are located on the right side of the top border of the window.
+        * Left Top: tabs are located on the top part of the left border of the window.
+        * Right Top: tabs are located on the top part of the right border of the window.
+        * Left Bottom: tabs are located on the bottom part of the left border of the window.
+        * Right Bottom: tabs are located on the bottom part of the right border of the window.
+        * Bottom Left: tabs are located on the left side of the bottom border of the window.
+        * Bottom Right: tabs are located on the right side of the bottom border of the window.
+
+    for this options to work 'Tabs in Titlebar' must be off.
+
+- *Tabs in Titlebar*:
+    when this option is on tabs are fixed in window titlebar and its width varies according
+    to the amount of windows grouped.
+
+- *External Tab Width*:
+    it specifies in pixels the width of external tabs.
+
+As most Fluxbox configurations this can be done by editing the init file. The resources
+that you should look at are:
+
+    session.screen0.tabs.intitlebar:    <boolean>
+    session.screen0.tab.width:          <integer>
+    session.screen0.tab.placement:      <direction>
+
+
+
 STYLES
 ------
 fluxbox enables you to use specialized files that contain X(1) resources to
@@ -1612,3 +1651,4 @@ information can be found on the official website.
 SEE ALSO
 --------
 bsetroot(1) fbsetbg(1) fbrun(1) fluxstyle(1)
+