Clean up StartWindozeCycle()
[wmaker-crm.git] / INSTALL.es
blob99d443b10caff6d71921def1ff7b422798b00c18
2                         Instrucciones de Instalación para Window Maker
6 PLATAFORMAS SOPORTADAS
7 ======================
8 (obs: Alguien me mencionó que lo compiló en...)
10 - Intel GNU/Linux Conectiva 5.9 (beta)
11 - Intel GNU/Linux Slackware
12 - Intel GNU/Linux Debian
13 - Intel GNU/Linux other distributions
14 - Sparc GNU/Linux RedHat 5.1
15 - PowerPC GNU/MkLinux
16 - Alpha GNU/Linux RedHat 5.1
17 - FreeBSD
18 - NetBSD
19 - OpenBSD
20 - BSDI 4.0
21 - Solaris 2.5.1, 2.5.2
22 - Solaris 2.6.0
23 - Solaris 2.7beta
24 - SCO Unix
25 - SGI Irix 5.x, 6.5
26 - OSF/1
27 - HP-UX
28 - AIX 3.2.5
29 - AIX 4.1.4 / IBM PowerPC
30 - AIX 4.3.1 / IBM CC compiler
31 - AIX 4.3.2 / IBM PowerPC
32 - AIX 5.3
33 - DEC Alpha/Digital UNIX 4.x
34 - XFree86 / OS/2
35 - Corel NetWinder
36 - SunOS 4.x
37 - PowerMac / Power MachTen 4.1.1 over MacOS
38 - Amiga 3000 running RedHat Linux 5.1 (Rawhide)
39 - IBM S/390 running Linux
40 - iBook running Darwin
41 - Windows NT with Cygwin/XFree86
42 - Sony PlayStation2 running Linux
44 Todas las marcas registradas están registradas por sus dueños. (duh)
46 Los parches que lo hagan funcionar en otras plataformas son bienvenidos.
49 REQUERIMIENTOS:
50 ==============
52 El siguiente software se necesita para usar Window Maker:
54 - X11R6.x       
55         Window Maker puede ser compilado en versiones más antiguas de X, 
56         como X11R5 (Solaris) o X11R4 (OpenWindows) pero no funcionará 100%
57         correctamente.
58         En tales servidores no habrá íconos de aplicación y tendrá problemas
59         usando el dock. Actualizar las bibliotecas cliente (Xlib, Xt, etc) 
60         ayudará si no puede actualizar el servidor.
62 Lo siguiente se necesita para compilar Window Maker:
64 - Requerimientos básicos y obvios
65         Si compila Window Maker, asegúrese de tener gcc (u algún otro
66         compilador ANSI C) y los archivos header de X instalados. Especialmente
67         para los usuarios de Linux principiantes: debe instalar todos los paquetes
68         de desarrollo de X y la suite gcc. De lo contrario no será capaz de 
69         compilar ningún programa X, incluyendo Window Maker.
71 - libPropList
72         Esta biblioteca se puede encontrar en ftp://ftp.windowmaker.info/pub/libs
73         o en ftp://ftp.gnome.org/pub/libPropList
74         Instálela antes de compilar Window Maker.
76 - autoconf, automake y libtool
77         Estas herramientas NO son necesarias, pero SI tiene una o más de ellas
78         instaladas, asegúrese de tener TODO lo siguiente con estas versiones
79          exactas:
80                 
81                 autoconf 2.54
82                 automake 1.4
83                 libtool 1.4.2
84         
85         Si tiene una versión distinta, desactívelas temporalemte renombrándolas
86         a otras cosa o desinstalándolas desde su sistema. Si no desarrolla
87          software no las necesita, así que puede desinstalarla sin peligro.
89 - lex (o flex) y yacc (o bison)
90         Estas son usadas por libPropList. lex en realidad no se necesita ya que
91         su archivo de salida está incluido, pero o yo o automake es tonto,
92         causando que el script configure para libPropList simplemente 
93         aborte sin ningún motivo si lex no es encontrado.
95 OPCIONAL:
96 =========
97 Estas bibliotecas no son necesarias para hacer que Window Maker funcione,
98  pero están soportadas en caso de que quiera usarlas. Los números de versión
99  son aquellos que yo tengo (y por lo tanto, garantizo que funciona), pero 
100  otras versiones podría funcionar también.
102 - libXPM 4.7 o más actual.
103         Versiones antiguas pueden no funcionar!!!
104         Disponible en ftp://sunsite.unc.edu/pub/Linux/libs/X/
106         Hay soporte nativo para archivos XPM, pero no cargará imagenes de
107         algunos formatos poco comunes.
108         
109 -libpng 0.96 o más actual y zlib
110         Para soporte de imágenes PNG.
111         http://www.cdrom.com/pub/png/
113 - libtiff 3.4 o más actual.
114         Para soporte de imaen TIFF.
115         Puede obtenerla en ftp://ftp.sgi.com/graphics/tiff
117 - libjpeg 6.0.1 o más actual
118         Para soporte de imagen JPEG
119         http://www.ijg.org/
121 - libgif 2.2 o libungif
122         Para soporte de imagen GIF.
123         ftp://prtr-13.ucsc.edu/pub/libungif/
125 - GNU xgettext
126         Si quiere usar mensajes traducidos, necesitará GNU gettext.
127         Otras versiones de gettext no son compatibles y no funcionarán.
128         Obtenga la versión GNU desde ftp://ftp.gnu.org
130 OPCIONES DE CONFIGURACIÓN:
131 =========================
132 Estas opciones pueden ser pasadas al script configure para activar/desactivar
133 algunas opciones de Window Maker. Ejemplo:
135 ./configure --enable-kde --enable-gnome
137 configurará Window Maker para que sea compilado con soporte para KDE y GNOME.
139 Para obtener una lista de otras opciones, ejecute ./configure --help
141 --with-libs-from
142         especifica rutas adicionales por donde se debe buscar bibliotecas.
143         El -L flag debe preceder a cada ruta, tal como:
144         
145         --with-libs-from="-L/opt/libs -L/usr/local/lib"
147 --with-incs-from
148         especifica rutas adicionales para la búsqueda de archivos header.       
149         El parámetro -I debe preceder a cada ruta, tal como:
150         
151         --with-incs-from="-I/opt/headers -I/usr/local/include"
153 --enable-single-icon
154         activa el agrupamiento de todos los appicons (iconos de aplicaciones)
155         del WM_CLASS+WM_INSTANCE en uno solo. Esta característica no es soportada
156         por todos los desarrolladores. Si tiene algún problema con ella, contacte
157         a su autor:     Christopher Seawood <cls@seawood.org>
159 --disable-shm
160         desactiva el uso de la extensión MIT de memoria compartida. Esto 
161         ralentizará la generación de texturas un poco, pero en algunos casos 
162         parecerá necesario debido a un error que se manifiesta como íconos y
163         texturas desordenadas.
165 --disable-motif 
166         desactiva el soporte para el gestor de ventanas mwm.
168 --enable-lite
169         quita cosas que ya están soportadas en los entornos de escritorio, 
170         tal como KDE y Gnome. Desactiva cosas como: lista de ventanas, 
171         menú de aplicaciones raíz, selección de ventanas múltiple. Note 
172         que no podrá salir más desde dentro de Window Maker; tendrá que usar 
173         kill con la señal SIGTERM o salir de KDE. No aconsejo activarlo.
175 --enable-modelock
176         Soporte para bloqueo de estado de lenguaje XKB. Si no sabe que es esto
177         probablemente no lo necesite.
179 --enable-sound  
180         activa el soporte del módulo para efectos sonoros.
182 --disable-xpm   
183         desactiva el uso de la biblioteca XPM aunque este disponible en su
184          sistema.
186 --disable-png   
187         desactiva el uso de la biblioteca PNG.
189 --disable-tiff
190         desactiva el uso de la biblioteca TIFF.
192 --disable-gif
193         desactiva el uso de la biblioteca GIF.
195 --disable-jpeg
196         desactiva el uso de la biblioteca JPEG.
198 --disable-shape
199         desactiva la forma de ventanas (para oclock, xeyes etc.)
201 NOTAS ESPECÍFICAS A LA PLATAFORMA:
202 =================================
204 - máquinas DEC/Alpha
206 #>>>>>>>>>>>
207 From: Anton Ivanov <aivanov@eu.level3.net>
208 To: Marcelo E. Magallon <mmagallo@debian.org>
209 Subject: Re: El paquete WindowMaker funciona bien en Alpha?
211 > Hola,
213 >  Estuve leyendo algunos documentos en el tarball de WindowMaker,
214 >  y encontré esto:
216 >  | - máquinas DEC/Alpha
217 >  |         podría necesitar pasar el parámetro --disable-shm a configure,
218 >  |         así ./configure --disable-shm
220 >  alguien está teniendo problemas con WindowMaker en Alpha?  Puede alguien
221 >  por favor probar esto?  Debería el parámetro ser pasado al compilar 
222 >  en Alpha?
224 Descargo de responsabilidad: alphas bajo mi mando nunca han ejecutado X
225 y es poco probable de que las ejecute repentinamente en algún momento.
227         Alpha suele tener alguna ridícula poca cantidad de memoria compartida
228 configurada.
230 Así que muchísimas aplicaciones suelen to barf. Concretamente - cdrecord, mysql server, etc.
231         
232         Verifique donde está el suyo en este momento y súbalo a un valor más adecuado catting la entrada
233         adecuada de /proc o cambiando el /usr/src/linux/include/asm/shmparam.h.
235         De lo contrario la memoria compartida en alpha debiera ser completamente funcional y no veo razón
236 para desactivarla. Las mías están aumentadas a 32 o más en muchas máquinas.
237         
238         Y si recuerdo correctamente los comentarios en aquél archivo están en realidad mal.
239         El valor no está en bytes, pero si en palabra de tamaño máquina. Para alpha *8.
240         
241         Como dije - no ejecuto X en ellas asi que apliqué a todas #include "stdisclaimer.h".
242 #<<<<<<<<<<<<
244 - SCO Unix - ejecute configure así
245         CFLAGS="-belf -DANSICPP" ./configure 
247 -SunOS, Solaris
248         Si tiene gcc instalado, ejecute configure como:
249         CPP_PATH="gcc -E -x c" ./configure
250         Sun cpp le falta algunas características que necesita Window Maker y
251          puede causarle problemas al analizar sintacticamente los archivos config.
252          También podría necesitar usar el --with-libs-from y --with-incs-from para
253          suministrarle el directorio donde libtiff se aloja.
254         Alguien me envió un mensaje diciéndome que también debe hacer que /usr/local/lib 
255         sea la primera ruta en LD_LIBRARY_PATH para que funcione.
256         
257         Si tiene un Ultra Creator 3D o alguna otra máquina con gráficos high-end,
258         asegúrese de iniciar el servidor X con el valor visual por defecto a 24bpp o
259          podría experimentar problemas con colores destrozados.
260          Este es un error de wmaker y será reparado.
261         
262 - GNU/Linux en general
263         Asegúrese de tener /usr/local/lib en /etc/ld.so.conf y de ejecutar 
264         ldconfig después de instalar.
265         Desinstale cualquier versión empaquetada de Window Maker antes de 
266         instalar una nueva versión.
267         
268 - RedHat GNU/Linux
269         Los sistemas RedHat tienen varios problemas molestos. Si lo usa,
270         asegúrese de seguir los pasos de más abajo o Window Maker no funcionará:
272         * si instaló el Window Maker que viene con RedHat, desinstálelo antes de
273         actualizar;
274         
275         *asegúrese que no tiene las variables de entorno LANG y LINGUAS establecidas a
276          en_RN;
277         
278         *asegúrese de tener /usr/local/bin en su variable de entorno PATH;
280         * asegúrese de tener /usr/local/lib en /etc/ld.so.conf antes de ejecutar 
281         ldconfig;
282         
283         *si tiene problemas que mencionan un menaje de error con --no-reexec 
284         desinstale libtool-1.2b e instale libtool-1.3 en su lugar. libtool-1.3 
285         se puede encontrar en ftp.gnu.org. También lea la sección TROUBLESHOOTING
286          (PROBLEMAS);
287         
288         * si instaló el paquete Window Maker desde RedHat y está instalando una
289         nueva versión de WM a mano (compilandolo usted mismo), desinstale antes el 
290         paquete desde RedHat.
291          
292         *asegúrese de tener un enlace simbólico desde /usr/include/X11 hacia 
293         /usr/X11R6/include/X11 (si no, tipee ln -s /usr/X11R6/include/X11 /usr/include/X11)
294         
295         * asegúrese de tener /lib/cpp apuntando al programa cpp.
296         
297         Si tiene alguna duda en cuanto a hacer algunas de las cosas de arriba, 
298         por favor no dude en contactar el soporte para usuarios de RedHat. Ellos
299          responderán amablemente a todas sus preguntas en lo que respecta a su sistema.
300          Ellos también conocen mucho más acerca de su propio sistema que nosotros 
301          (nosotros no usamos RedHat).
302         
303 - PowerPC MkLinux
304         Necesitará tener la última version de Xpmac. Las versiones más antiguas
305         parecen tener errores que producen el cuelgue del sistema.
306         
307 - Debian GNU/Linux
308         Si quiere soporte JPEG y TIFF, asegúrese de tener libtiff-dev y
309          libjpeg-dev instalados.
311 - SuSE GNU/Linux
312         Si instaló el paquete Window Maker desde SuSE, 
313         desinstálelo antes de instentar compilar wmaker o podría
314         tener problemas.
315         
317 - MetroX (version desconocida)
318         MetroX tiene un error que corrompe pixmaps que se establecen como 
319         fondos de ventana. Si usa MetroX y tuvo problemas raros con texturas, no use 
320         texturas en las barras de títulos. O use un servidor X distinto.
322 INSTALACIÓN:
323 =============
325 Compilando Window Maker
326 ------------------
327         Para un comienzo rápido, tipee lo siguiente en el prompt del shell:
329         ./configure
330         make
332 luego, regístrese como root y tipee:
334         make install
335         ldconfig
337 o si quiere remover los símbolos de depuración desde los binarios y hacerlos más
338  pequeños, puede tipear:
340         make install-strip
341         ldconfig
343 Esto compilará e instalará Window Maker con los parámetros por defecto.
345 Si quiere personalizar algunas opciones de compilación, puede hacer lo siguiente.
346         
347         1. (opcional)Mire en la sección OPCIONES DE CONFIGURACIÓN para ver las
348          opciones disponibles. También ejecute:
350         ./configure --help
351         
352         para obtener un listado completo de otras opciones que están disponibles.
354         2. Ejecute configure con las opciones que quiera. Por ejemplo, si quiere 
355         usar la opción --enable-kde, tipee:
356         
357         ./configure --enable-kde
358         
359         3. (opcional) Edite src/wconfig.h con su editor de texto favorito y
360          echele un vistazo por algunas opciones que podría querer cambiar.
361          
362         4. Compile. Solo tipee:
364         make
365         
366         5. Regístrese como root (si no puede hacerlo, lea la sección "No tengo la contraseña de root" :-()
367          e instale Window Maker en su sistema:
368                 su root
369                 make install
372 Configuración específica del usuario
373 ------------------------------------
375 Estas instrucciones no necesitan ser seguidas al actualizar Window Maker 
376 desde una versión más antigua, a menos que se indique de otra forma en el archivo
377  NEWS.
379 Todo usuario en su sistema que desee ejecutar Window Maker debe hacer lo siguiente:
381         1. Instale los archivos de configuración de Window Maker en su directorio home.
382 Tipee:
383         wmaker.inst
385         wmaker.inst instalará los archivos de configuración de Window Maker y
386 configurará X para que automáticamente lance Window Maker al inicio.
388         Eso es todo!
389         
390         Puede tipear "man wmaker" para obtener algo de ayuda general para la 
391 configuración y otras cosas.
392 Lea la Guia de Usuario para una explicación más a fondo de Window Maker.
394 Podría querer dar una mirada a la FAQ también.
396 Instalando el paquete extras
397 ----------------------------
399 Desempaquete WindowMaker-extra-<número-de-versión>.tar.gz en /usr/local/share
401 Puede obtener el archivo en ftp://ftp.windowmmaker.org. Este archivo es optativo
402  y solo tiene unos pocos íconos, y temas. Busque el último <número-de-versión> 
403  disponible.
404  También hay un WindowMaker-extra.readme que le enseña donde vería ir ese paquete.
407 No tengo la contraseña de root :(
408 --------------------------------
410 Si no puede obtener privilegios de superusuario (no puede ser root) puede 
411 instalar wmaker en su propio directorio home. Para esto, proporcione la 
412 opción --prefix al ejecutar configure en el paso 2 de compilando Window Maker. 
413 También necesitará proporcionar la opción --with-appspath, para especificar la ruta
414 para WPrefs.app. Ejemplo:
416 ./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Applications
418 Luego haga /home/jshmoe/bin para que se lo incluya en su ruta de búsqueda, agregue
419 /home/jshmoe/lib a su variable de entorno LD_LIBRARY_PATH y ejecute bin/wmaker.inst
421 Por supuesto, /home/jshmoe se supone que va a ser reemplazado con la ruta a su 
422 directorio home real.
425 ACTUALIZANDO
426 ============
427 Si está actualizando desde una versión antigua de Window Maker:
429         1. Configure y compile Window Maker como siempre.
430         2. Instale Window Maker (pero no ejecute wmaker.inst)
431         3. Lea el archivo NEWS y actualice sus archivos de configuración, 
432            si es necesario.
434 PROBLEMAS
435 =========
437 Cuando tenga alguno problemas durante la configuración (al ejecutar configure),
438 tal como no poder usar una biblioteca de formato gráfico que piensa tener instalada,
439 mire en el archivo config.log para obtener ideas sobre el problema.
441 == Error al cargar las fuentes, siempre que existan.
443 Intente recompilar sin el soporte NLS.
445 == Error al configurar
447 ltconfig: unrecognized option `--no-reexec'
448 Try `ltconfig --help' for more information.
449 configure: error: libtool configure failed
451 quite la opción --no-reexec desde aclocal.m4 y libPropList/aclocal.m4 y
452  reconfigure.
453 También asegúrese que las versiones de autoconf y automake que tenga instaladas son:
455 autoconf 2.13
456 automake 1.4
457 libtool 1.3
459 Note que ella no debe ser libtool 1.2b, debe ser libtool 1.3, 
460 desde los sitios GNU.
462 == No puedo encontrar proplist.h o libPropList.something
464 Baje e instale libPropList desde los lugares ya citados en algún lugar 
465 de este archivo.
467 == configure no detecta libtiff, u otras bibliotecas gráficas.
469 Elimine config.cache, luego vuelva a ejecutar configure añadiendo las siguientes
470  opciones a configure (entre sus otras opciones):
472 --with-libs-from="-L/usr/local/lib"
473 --with-incs-from="-I/usr/local/include -I/usr/local/include/tiff"
475 Sustituya las rutas donde están localizadas sus bibliotecas gráficas y sus 
476 correspondientes archivos header. Puede colocar rutas múltiples en cualquiera de 
477 estas opciones, como se muestra en el ejemplo de --with-incs-from . Solo coloque
478 un espacio entre ellas.
480 == configure no detecta libXpm. 
482 * Verifique si tiene un enlace simbólico desde libXpm.so.4.9 a libXpm.so
484 == Segmentation fault al inicio.
486 * Verifique si la versión de libXPM que tiene es por lo menos la 4.7
488 * Verifique si tiene una versión actualizada de ~/GNUstep/Defaults/WindowMaker
490 Si no está seguro, intente renombrar ~/GNUstep a ~/GNUtmp y luego ejecute wmaker.inst
492 == "...: your machine is misconfigured. gethostname() returned (none)"
494 * el hostname de su máquina está definido a algo inválido, como comenzar con
495         un paréntesis. Haga un man hostname para obtener información acerca de como definirlo.
498 == El menú raíz contiene solo 2 entradas. ("XTerm" y "Exit...")
500 * Window Maker no está encontrando cpp (el preprocesador de C). Si su 
501 cpp no está ubicado en /lib/cpp, edite src/config.h y corrija la ruta en 
502 CPP_PATH.
504 == checking lex output file root... configure: error: cannot find output from true; giving up
506 * Lea la sección REQUERIMIENTOS de este archivo.
509 LOCALES/INTERNACIONALIZACIÓN
510 ============================
512 Window Maker tiene soporte de idioma nacional. Para activar este soporte, 
513 debe compilar Window Maker con algunos parámetros adicionales.
515 0 - Debe tener el paquete GNU gettext instalado. Puede obtenerse en
516 ftp://prep.ai.mit.edu/pub/gnu/gettext-nnn.tar.gz
518 Los pasos 1 al 3 pueden saltearse si usa el script Install.
520 1 - Debe seleccionar los idiomas que quiere soportar. Defina el
521 LINGUAS a la lista de locales que quiera. El Inglés siempre está
522 soportado. Ejemplo:
524 setenv LINGUAS "pt ja de"
525 en csh
529 export LINGUAS;LINGUAS="pt ja de"
530 en sh
532 La lista de locales soportados se pueden encontrar en po/README.
533 El Inglés es el idioma pr defecto.
535 Lea po/README si desea traducir y mantener archivos locale para otros 
536 idiomas.
538 2 - Adicionalmente, si su idioma usa caracteres multi-byte, tal como
539 Japonés o Coreano, debe definir la opción MultiByteText a YES
540 en ~/GNUstep/Defaults/WMGLOBAL
542 3 - Configure, compile e instale Window Maker normalmente.
544 4 - Para seleccionar un locale particular en tiempo de ejecución debe definir la
545  variable de entorno LANG al locale que quiera. Por ejemplo, si quiere definir
546 el locale portugués, debe ejecutar
548 setenv LANG pt
550 en csh o
552 export LANG; LANG=pt
554 en Bourne sh y similares
556 Nota: Si tiene definida la variable de entorno LC_CTYPE, debe
557 indefinirla antes de ejecutar wmaker.
559 Window Maker busca los archivos de definición de menú en el siguiente orden:
560 (para portugués brasileño, en este caso):
562 menu.pt_BR
563 menu.pt
564 menu
566 5 - Si elige un idioma que usa caracteres multi-byte, debe configurar 
567 las fuentes adecuadamente. Lea la página del manual para XCreateFontSet 
568 para obtener más detalles sobre esto. Debe cambiar el archivo ~/G/D/Windowmaker
569 para las fuentes usadas en barras de título, menús y otras cosas. Para las fuentes
570 usadas en ventanas de diálogo, cambie ~/G/D/WMGLOBAL. El %d en los nombres de las
571 fuentes no debe ser quitado. Puede también usar el script wsetfont proporcionado para
572 esta tarea. Lea el mismo script para obtener instrucciones.
574 Por ejemplo, puede especificar lo siguiente en ~/G/D/WindowMaker:
576 WindowTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
577 MenuTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
578 MenuTextFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
579 IconTitleFont = "-*-helvetica-medium-r-normal-*-8-*,-*-*-medium-r-normal-*-12-*";
580 ClipTitleFont = "-*-helvetica-bold-r-normal-*-10-*,-*-*-medium-r-normal-*-12-*";
581 DisplayFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-12-*";
583 y en ~/G/D/WMGLOBAL:
585 SystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
586 BoldSystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
588 Las 2 fuentes de arriba son usadas únicamente por aplicaciones que usan WINGs
589 (WindowMaker y WPrefs.app)
591 El script wsetfont que se proporciona le permitirá cambiar las definiciones de fuentes
592  de una manera fácil. De una mirada al script para detalles de uso.
594 traducido por Efraín Maximiliano Palermo <max_drake2001@yahoo.com.ar>