- rewrote the font conversion routines to avoid the need to allocate memory
[wmaker-crm.git] / INSTALL.es
blobd5c44876e714b9f3aa79c5452249dbe7030f94be
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.org/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-openlook
169         activa el soporte para el gestor de ventanas OPEN LOOK(tm)
171 --enable-gnome
172         activa el soporte para el gestor de ventanas GNOME.
174 --enable-kde
175         activa el soporte para el gestor de ventanas kde/kwm.
177 --enable-lite
178         quita cosas que ya están soportadas en los entornos de escritorio, 
179         tal como KDE y Gnome. Desactiva cosas como: lista de ventanas, 
180         menú de aplicaciones raíz, selección de ventanas múltiple. Note 
181         que no podrá salir más desde dentro de Window Maker; tendrá que usar 
182         kill con la señal SIGTERM o salir de KDE. No aconsejo activarlo.
184 --enable-modelock
185         Soporte para bloqueo de estado de lenguaje XKB. Si no sabe que es esto
186         probablemente no lo necesite.
188 --enable-sound  
189         activa el soporte del módulo para efectos sonoros.
191 --disable-xpm   
192         desactiva el uso de la biblioteca XPM aunque este disponible en su
193          sistema.
195 --disable-png   
196         desactiva el uso de la biblioteca PNG.
198 --disable-tiff
199         desactiva el uso de la biblioteca TIFF.
201 --disable-gif
202         desactiva el uso de la biblioteca GIF.
204 --disable-jpeg
205         desactiva el uso de la biblioteca JPEG.
207 --disable-shape
208         desactiva la forma de ventanas (para oclock, xeyes etc.)
210 NOTAS ESPECÍFICAS A LA PLATAFORMA:
211 =================================
213 - máquinas DEC/Alpha
215 #>>>>>>>>>>>
216 From: Anton Ivanov <aivanov@eu.level3.net>
217 To: Marcelo E. Magallon <mmagallo@debian.org>
218 Subject: Re: El paquete WindowMaker funciona bien en Alpha?
220 > Hola,
222 >  Estuve leyendo algunos documentos en el tarball de WindowMaker,
223 >  y encontré esto:
225 >  | - máquinas DEC/Alpha
226 >  |         podría necesitar pasar el parámetro --disable-shm a configure,
227 >  |         así ./configure --disable-shm
229 >  alguien está teniendo problemas con WindowMaker en Alpha?  Puede alguien
230 >  por favor probar esto?  Debería el parámetro ser pasado al compilar 
231 >  en Alpha?
233 Descargo de responsabilidad: alphas bajo mi mando nunca han ejecutado X
234 y es poco probable de que las ejecute repentinamente en algún momento.
236         Alpha suele tener alguna ridícula poca cantidad de memoria compartida
237 configurada.
239 Así que muchísimas aplicaciones suelen to barf. Concretamente - cdrecord, mysql server, etc.
240         
241         Verifique donde está el suyo en este momento y súbalo a un valor más adecuado catting la entrada
242         adecuada de /proc o cambiando el /usr/src/linux/include/asm/shmparam.h.
244         De lo contrario la memoria compartida en alpha debiera ser completamente funcional y no veo razón
245 para desactivarla. Las mías están aumentadas a 32 o más en muchas máquinas.
246         
247         Y si recuerdo correctamente los comentarios en aquél archivo están en realidad mal.
248         El valor no está en bytes, pero si en palabra de tamaño máquina. Para alpha *8.
249         
250         Como dije - no ejecuto X en ellas asi que apliqué a todas #include "stdisclaimer.h".
251 #<<<<<<<<<<<<
253 - SCO Unix - ejecute configure así
254         CFLAGS="-belf -DANSICPP" ./configure 
256 -SunOS, Solaris
257         Si tiene gcc instalado, ejecute configure como:
258         CPP_PATH="gcc -E -x c" ./configure
259         Sun cpp le falta algunas características que necesita Window Maker y
260          puede causarle problemas al analizar sintacticamente los archivos config.
261          También podría necesitar usar el --with-libs-from y --with-incs-from para
262          suministrarle el directorio donde libtiff se aloja.
263         Alguien me envió un mensaje diciéndome que también debe hacer que /usr/local/lib 
264         sea la primera ruta en LD_LIBRARY_PATH para que funcione.
265         
266         Si tiene un Ultra Creator 3D o alguna otra máquina con gráficos high-end,
267         asegúrese de iniciar el servidor X con el valor visual por defecto a 24bpp o
268          podría experimentar problemas con colores destrozados.
269          Este es un error de wmaker y será reparado.
270         
271 - GNU/Linux en general
272         Asegúrese de tener /usr/local/lib en /etc/ld.so.conf y de ejecutar 
273         ldconfig después de instalar.
274         Desinstale cualquier versión empaquetada de Window Maker antes de 
275         instalar una nueva versión.
276         
277 - RedHat GNU/Linux
278         Los sistemas RedHat tienen varios problemas molestos. Si lo usa,
279         asegúrese de seguir los pasos de más abajo o Window Maker no funcionará:
281         * si instaló el Window Maker que viene con RedHat, desinstálelo antes de
282         actualizar;
283         
284         *asegúrese que no tiene las variables de entorno LANG y LINGUAS establecidas a
285          en_RN;
286         
287         *asegúrese de tener /usr/local/bin en su variable de entorno PATH;
289         * asegúrese de tener /usr/local/lib en /etc/ld.so.conf antes de ejecutar 
290         ldconfig;
291         
292         *si tiene problemas que mencionan un menaje de error con --no-reexec 
293         desinstale libtool-1.2b e instale libtool-1.3 en su lugar. libtool-1.3 
294         se puede encontrar en ftp.gnu.org. También lea la sección TROUBLESHOOTING
295          (PROBLEMAS);
296         
297         * si instaló el paquete Window Maker desde RedHat y está instalando una
298         nueva versión de WM a mano (compilandolo usted mismo), desinstale antes el 
299         paquete desde RedHat.
300          
301         *asegúrese de tener un enlace simbólico desde /usr/include/X11 hacia 
302         /usr/X11R6/include/X11 (si no, tipee ln -s /usr/X11R6/include/X11 /usr/include/X11)
303         
304         * asegúrese de tener /lib/cpp apuntando al programa cpp.
305         
306         Si tiene alguna duda en cuanto a hacer algunas de las cosas de arriba, 
307         por favor no dude en contactar el soporte para usuarios de RedHat. Ellos
308          responderán amablemente a todas sus preguntas en lo que respecta a su sistema.
309          Ellos también conocen mucho más acerca de su propio sistema que nosotros 
310          (nosotros no usamos RedHat).
311         
312 - PowerPC MkLinux
313         Necesitará tener la última version de Xpmac. Las versiones más antiguas
314         parecen tener errores que producen el cuelgue del sistema.
315         
316 - Debian GNU/Linux
317         Si quiere soporte JPEG y TIFF, asegúrese de tener libtiff-dev y
318          libjpeg-dev instalados.
320 - SuSE GNU/Linux
321         Si instaló el paquete Window Maker desde SuSE, 
322         desinstálelo antes de instentar compilar wmaker o podría
323         tener problemas.
324         
326 - MetroX (version desconocida)
327         MetroX tiene un error que corrompe pixmaps que se establecen como 
328         fondos de ventana. Si usa MetroX y tuvo problemas raros con texturas, no use 
329         texturas en las barras de títulos. O use un servidor X distinto.
331 INSTALACIÓN:
332 =============
334 Compilando Window Maker
335 ------------------
336         Para un comienzo rápido, tipee lo siguiente en el prompt del shell:
338         ./configure
339         make
341 luego, regístrese como root y tipee:
343         make install
344         ldconfig
346 o si quiere remover los símbolos de depuración desde los binarios y hacerlos más
347  pequeños, puede tipear:
349         make install-strip
350         ldconfig
352 Esto compilará e instalará Window Maker con los parámetros por defecto.
354 Si quiere personalizar algunas opciones de compilación, puede hacer lo siguiente.
355         
356         1. (opcional)Mire en la sección OPCIONES DE CONFIGURACIÓN para ver las
357          opciones disponibles. También ejecute:
359         ./configure --help
360         
361         para obtener un listado completo de otras opciones que están disponibles.
363         2. Ejecute configure con las opciones que quiera. Por ejemplo, si quiere 
364         usar la opción --enable-kde, tipee:
365         
366         ./configure --enable-kde
367         
368         3. (opcional) Edite src/wconfig.h con su editor de texto favorito y
369          echele un vistazo por algunas opciones que podría querer cambiar.
370          
371         4. Compile. Solo tipee:
373         make
374         
375         5. Regístrese como root (si no puede hacerlo, lea la sección "No tengo la contraseña de root" :-()
376          e instale Window Maker en su sistema:
377                 su root
378                 make install
381 Configuración específica del usuario
382 ------------------------------------
384 Estas instrucciones no necesitan ser seguidas al actualizar Window Maker 
385 desde una versión más antigua, a menos que se indique de otra forma en el archivo
386  NEWS.
388 Todo usuario en su sistema que desee ejecutar Window Maker debe hacer lo siguiente:
390         1. Instale los archivos de configuración de Window Maker en su directorio home.
391 Tipee:
392         wmaker.inst
394         wmaker.inst instalará los archivos de configuración de Window Maker y
395 configurará X para que automáticamente lance Window Maker al inicio.
397         Eso es todo!
398         
399         Puede tipear "man wmaker" para obtener algo de ayuda general para la 
400 configuración y otras cosas.
401 Lea la Guia de Usuario para una explicación más a fondo de Window Maker.
403 Podría querer dar una mirada a la FAQ también.
405 Instalando el paquete extras
406 ----------------------------
408 Desempaquete WindowMaker-extra-<número-de-versión>.tar.gz en /usr/local/share
410 Puede obtener el archivo en ftp://ftp.windowmmaker.org. Este archivo es optativo
411  y solo tiene unos pocos íconos, y temas. Busque el último <número-de-versión> 
412  disponible.
413  También hay un WindowMaker-extra.readme que le enseña donde vería ir ese paquete.
416 No tengo la contraseña de root :(
417 --------------------------------
419 Si no puede obtener privilegios de superusuario (no puede ser root) puede 
420 instalar wmaker en su propio directorio home. Para esto, proporcione la 
421 opción --prefix al ejecutar configure en el paso 2 de compilando Window Maker. 
422 También necesitará proporcionar la opción --with-appspath, para especificar la ruta
423 para WPrefs.app. Ejemplo:
425 ./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Apps
427 Luego haga /home/jshmoe/bin para que se lo incluya en su ruta de búsqueda, agregue
428 /home/jshmoe/lib a su variable de entorno LD_LIBRARY_PATH y ejecute bin/wmaker.inst
430 Por supuesto, /home/jshmoe se supone que va a ser reemplazado con la ruta a su 
431 directorio home real.
434 ACTUALIZANDO
435 ============
436 Si está actualizando desde una versión antigua de Window Maker:
438         1. Configure y compile Window Maker como siempre.
439         2. Instale Window Maker (pero no ejecute wmaker.inst)
440         3. Lea el archivo NEWS y actualice sus archivos de configuración, 
441            si es necesario.
443 PROBLEMAS
444 =========
446 Cuando tenga alguno problemas durante la configuración (al ejecutar configure),
447 tal como no poder usar una biblioteca de formato gráfico que piensa tener instalada,
448 mire en el archivo config.log para obtener ideas sobre el problema.
450 == Error al cargar las fuentes, siempre que existan.
452 Intente recompilar sin el soporte NLS.
454 == Error al configurar
456 ltconfig: unrecognized option `--no-reexec'
457 Try `ltconfig --help' for more information.
458 configure: error: libtool configure failed
460 quite la opción --no-reexec desde aclocal.m4 y libPropList/aclocal.m4 y
461  reconfigure.
462 También asegúrese que las versiones de autoconf y automake que tenga instaladas son:
464 autoconf 2.13
465 automake 1.4
466 libtool 1.3
468 Note que ella no debe ser libtool 1.2b, debe ser libtool 1.3, 
469 desde los sitios GNU.
471 == No puedo encontrar proplist.h o libPropList.something
473 Baje e instale libPropList desde los lugares ya citados en algún lugar 
474 de este archivo.
476 == configure no detecta libtiff, u otras bibliotecas gráficas.
478 Elimine config.cache, luego vuelva a ejecutar configure añadiendo las siguientes
479  opciones a configure (entre sus otras opciones):
481 --with-libs-from="-L/usr/local/lib"
482 --with-incs-from="-I/usr/local/include -I/usr/local/include/tiff"
484 Sustituya las rutas donde están localizadas sus bibliotecas gráficas y sus 
485 correspondientes archivos header. Puede colocar rutas múltiples en cualquiera de 
486 estas opciones, como se muestra en el ejemplo de --with-incs-from . Solo coloque
487 un espacio entre ellas.
489 == configure no detecta libXpm. 
491 * Verifique si tiene un enlace simbólico desde libXpm.so.4.9 a libXpm.so
493 == Segmentation fault al inicio.
495 * Verifique si la versión de libXPM que tiene es por lo menos la 4.7
497 * Verifique si tiene una versión actualizada de ~/GNUstep/Defaults/WindowMaker
499 Si no está seguro, intente renombrar ~/GNUstep a ~/GNUtmp y luego ejecute wmaker.inst
501 == "...: your machine is misconfigured. gethostname() returned (none)"
503 * el hostname de su máquina está definido a algo inválido, como comenzar con
504         un paréntesis. Haga un man hostname para obtener información acerca de como definirlo.
507 == El menú raíz contiene solo 2 entradas. ("XTerm" y "Exit...")
509 * Window Maker no está encontrando cpp (el preprocesador de C). Si su 
510 cpp no está ubicado en /lib/cpp, edite src/config.h y corrija la ruta en 
511 CPP_PATH.
513 == checking lex output file root... configure: error: cannot find output from true; giving up
515 * Lea la sección REQUERIMIENTOS de este archivo.
518 LOCALES/INTERNACIONALIZACIÓN
519 ============================
521 Window Maker tiene soporte de idioma nacional. Para activar este soporte, 
522 debe compilar Window Maker con algunos parámetros adicionales.
524 0 - Debe tener el paquete GNU gettext instalado. Puede obtenerse en
525 ftp://prep.ai.mit.edu/pub/gnu/gettext-nnn.tar.gz
527 Los pasos 1 al 3 pueden saltearse si usa el script Install.
529 1 - Debe seleccionar los idiomas que quiere soportar. Defina el
530 LINGUAS a la lista de locales que quiera. El Inglés siempre está
531 soportado. Ejemplo:
533 setenv LINGUAS "pt ja de"
534 en csh
538 export LINGUAS;LINGUAS="pt ja de"
539 en sh
541 La lista de locales soportados se pueden encontrar en po/README.
542 El Inglés es el idioma pr defecto.
544 Lea po/README si desea traducir y mantener archivos locale para otros 
545 idiomas.
547 2 - Adicionalmente, si su idioma usa caracteres multi-byte, tal como
548 Japonés o Coreano, debe definir la opción MultiByteText a YES
549 en ~/GNUstep/Defaults/WMGLOBAL
551 3 - Configure, compile e instale Window Maker normalmente.
553 4 - Para seleccionar un locale particular en tiempo de ejecución debe definir la
554  variable de entorno LANG al locale que quiera. Por ejemplo, si quiere definir
555 el locale portugués, debe ejecutar
557 setenv LANG pt
559 en csh o
561 export LANG; LANG=pt
563 en Bourne sh y similares
565 Nota: Si tiene definida la variable de entorno LC_CTYPE, debe
566 indefinirla antes de ejecutar wmaker.
568 Window Maker busca los archivos de definición de menú en el siguiente orden:
569 (para portugués brasileño, en este caso):
571 menu.pt_BR
572 menu.pt
573 menu
575 5 - Si elige un idioma que usa caracteres multi-byte, debe configurar 
576 las fuentes adecuadamente. Lea la página del manual para XCreateFontSet 
577 para obtener más detalles sobre esto. Debe cambiar el archivo ~/G/D/Windowmaker
578 para las fuentes usadas en barras de título, menús y otras cosas. Para las fuentes
579 usadas en ventanas de diálogo, cambie ~/G/D/WMGLOBAL. El %d en los nombres de las
580 fuentes no debe ser quitado. Puede también usar el script wsetfont proporcionado para
581 esta tarea. Lea el mismo script para obtener instrucciones.
583 Por ejemplo, puede especificar lo siguiente en ~/G/D/WindowMaker:
585 WindowTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
586 MenuTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
587 MenuTextFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
588 IconTitleFont = "-*-helvetica-medium-r-normal-*-8-*,-*-*-medium-r-normal-*-12-*";
589 ClipTitleFont = "-*-helvetica-bold-r-normal-*-10-*,-*-*-medium-r-normal-*-12-*";
590 DisplayFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-12-*";
592 y en ~/G/D/WMGLOBAL:
594 SystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
595 BoldSystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
597 Las 2 fuentes de arriba son usadas únicamente por aplicaciones que usan WINGs
598 (WindowMaker y WPrefs.app)
600 El script wsetfont que se proporciona le permitirá cambiar las definiciones de fuentes
601  de una manera fácil. De una mirada al script para detalles de uso.
603 traducido por Efraín Maximiliano Palermo <max_drake2001@yahoo.com.ar>