more code for proplist handling (almost finished)
[wmaker-crm.git] / INSTALL.es
blob127424d68007373ab1cf13e8d07858b0edcf9317
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.13
82                 automake 1.4
83                 libtool 1.3
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 - libHermes 1.3.2 o más actual
126         Para conversión a pixel más rápida en la biblioteca wraster.
127         (se usa solo en algunas conversiones - para visuales Color Verdadero)
128         http://www.clanlib.org/hermes/
130 - GNU xgettext
131         Si quiere usar mensajes traducidos, necesitará GNU gettext.
132         Otras versiones de gettext no son compatibles y no funcionarán.
133         Obtenga la versión GNU desde ftp://ftp.gnu.org
135 OPCIONES DE CONFIGURACIÓN:
136 =========================
137 Estas opciones pueden ser pasadas al script configure para activar/desactivar
138 algunas opciones de Window Maker. Ejemplo:
140 ./configure --enable-kde --enable-gnome
142 configurará Window Maker para que sea compilado con soporte para KDE y GNOME.
144 Para obtener una lista de otras opciones, ejecute ./configure --help
146 --with-libs-from
147         especifica rutas adicionales por donde se debe buscar bibliotecas.
148         El -L flag debe preceder a cada ruta, tal como:
149         
150         --with-libs-from="-L/opt/libs -L/usr/local/lib"
152 --with-incs-from
153         especifica rutas adicionales para la búsqueda de archivos header.       
154         El parámetro -I debe preceder a cada ruta, tal como:
155         
156         --with-incs-from="-I/opt/headers -I/usr/local/include"
158 --enable-single-icon
159         activa el agrupamiento de todos los appicons (iconos de aplicaciones)
160         del WM_CLASS+WM_INSTANCE en uno solo. Esta característica no es soportada
161         por todos los desarrolladores. Si tiene algún problema con ella, contacte
162         a su autor:     Christopher Seawood <cls@seawood.org>
164 --disable-shm
165         desactiva el uso de la extensión MIT de memoria compartida. Esto 
166         ralentizará la generación de texturas un poco, pero en algunos casos 
167         parecerá necesario debido a un error que se manifiesta como íconos y
168         texturas desordenadas.
170 --disable-motif 
171         desactiva el soporte para el gestor de ventanas mwm.
173 --enable-openlook
174         activa el soporte para el gestor de ventanas OPEN LOOK(tm)
176 --enable-gnome
177         activa el soporte para el gestor de ventanas GNOME.
179 --enable-kde
180         activa el soporte para el gestor de ventanas kde/kwm.
182 --enable-lite
183         quita cosas que ya están soportadas en los entornos de escritorio, 
184         tal como KDE y Gnome. Desactiva cosas como: lista de ventanas, 
185         menú de aplicaciones raíz, selección de ventanas múltiple. Note 
186         que no podrá salir más desde dentro de Window Maker; tendrá que usar 
187         kill con la señal SIGTERM o salir de KDE. No aconsejo activarlo.
189 --enable-modelock
190         Soporte para bloqueo de estado de lenguaje XKB. Si no sabe que es esto
191         probablemente no lo necesite.
193 --enable-sound  
194         activa el soporte del módulo para efectos sonoros.
196 --disable-xpm   
197         desactiva el uso de la biblioteca XPM aunque este disponible en su
198          sistema.
200 --disable-png   
201         desactiva el uso de la biblioteca PNG.
203 --disable-tiff
204         desactiva el uso de la biblioteca TIFF.
206 --disable-gif
207         desactiva el uso de la biblioteca GIF.
209 --disable-jpeg
210         desactiva el uso de la biblioteca JPEG.
212 --disable-shape
213         desactiva la forma de ventanas (para oclock, xeyes etc.)
215 NOTAS ESPECÍFICAS A LA PLATAFORMA:
216 =================================
218 - máquinas DEC/Alpha
220 #>>>>>>>>>>>
221 From: Anton Ivanov <aivanov@eu.level3.net>
222 To: Marcelo E. Magallon <mmagallo@debian.org>
223 Subject: Re: El paquete WindowMaker funciona bien en Alpha?
225 > Hola,
227 >  Estuve leyendo algunos documentos en el tarball de WindowMaker,
228 >  y encontré esto:
230 >  | - máquinas DEC/Alpha
231 >  |         podría necesitar pasar el parámetro --disable-shm a configure,
232 >  |         así ./configure --disable-shm
234 >  alguien está teniendo problemas con WindowMaker en Alpha?  Puede alguien
235 >  por favor probar esto?  Debería el parámetro ser pasado al compilar 
236 >  en Alpha?
238 Descargo de responsabilidad: alphas bajo mi mando nunca han ejecutado X y are
239 least likely to suddenly start running it anytime soon.
241         Alpha suele tener alguna ridícula poca cantidad de memoria compartida
242 configurada.
244 Así que muchísimas aplicaciones suelen to barf. Concretamente - cdrecord, mysql server, etc.
245         
246         Verifique donde está el suyo en este momento y súbalo a un valor más adecuado catting la entrada
247         adecuada de /proc o cambiando el /usr/src/linux/include/asm/shmparam.h.
249         De lo contrario la memoria compartida en alpha debiera ser completamente funcional y no veo razón
250 para desactivarla. Las mías están aumentadas a 32 o más en muchas máquinas.
251         
252         Y si recuerdo correctamente los comentarios en aquél archivo están en realidad mal.
253         El valor no está en bytes, pero si en palabra de tamaño máquina. Para alpha *8.
254         
255         Como dije - no ejecuto X en ellas asi que apliqué a todas #include "stdisclaimer.h".
256 #<<<<<<<<<<<<
258 - SCO Unix - ejecute configure así
259         CFLAGS="-belf -DANSICPP" ./configure 
261 -SunOS, Solaris
262         Si tiene gcc instalado, ejecute configure como:
263         CPP_PATH="gcc -E -x c" ./configure
264         Sun cpp le falta algunas características que necesita Window Maker y
265          puede causarle problemas al analizar sintacticamente los archivos config.
266          También podría necesitar usar el --with-libs-from y --with-incs-from para
267          suministrarle el directorio donde libtiff se aloja.
268         Alguien me envió un mensaje diciéndome que también debe hacer que /usr/local/lib 
269         sea la primera ruta en LD_LIBRARY_PATH para que funcione.
270         
271         Si tiene un Ultra Creator 3D o alguna otra máquina con gráficos high-end,
272         asegúrese de iniciar el servidor X con el valor visual por defecto a 24bpp o
273          podría experimentar problemas con colores destrozados.
274          Este es un error de wmaker y será reparado.
275         
276 - GNU/Linux en general
277         Asegúrese de tener /usr/local/lib en /etc/ld.so.conf y de ejecutar 
278         ldconfig después de instalar.
279         Desinstale cualquier versión empaquetada de Window Maker antes de 
280         instalar una nueva versión.
281         
282 - RedHat GNU/Linux
283         Los sistemas RedHat tienen varios problemas molestos. Si lo usa,
284         asegúrese de seguir los pasos de más abajo o Window Maker no funcionará:
286         * si instaló el Window Maker que viene con RedHat, desinstálelo antes de
287         actualizar;
288         
289         *asegúrese que no tiene las variables de entorno LANG y LINGUAS establecidas a
290          en_RN;
291         
292         *asegúrese de tener /usr/local/bin en su variable de entorno PATH;
294         * asegúrese de tener /usr/local/lib en /etc/ld.so.conf antes de ejecutar 
295         ldconfig;
296         
297         *si tiene problemas que mencionan un menaje de error con --no-reexec 
298         desinstale libtool-1.2b e instale libtool-1.3 en su lugar. libtool-1.3 
299         se puede encontrar en ftp.gnu.org. También lea la sección TROUBLESHOOTING
300          (PROBLEMAS);
301         
302         * si instaló el paquete Window Maker desde RedHat y está instalando una
303         nueva versión de WM a mano (compilandolo usted mismo), desinstale antes el 
304         paquete desde RedHat.
305          
306         *asegúrese de tener un enlace simbólico desde /usr/include/X11 hacia 
307         /usr/X11R6/include/X11 (si no, tipee ln -s /usr/X11R6/include/X11 /usr/include/X11)
308         
309         * asegúrese de tener /lib/cpp apuntando al programa cpp.
310         
311         Si tiene alguna duda en cuanto a hacer algunas de las cosas de arriba, 
312         por favor no dude en contactar el soporte para usuarios de RedHat. Ellos
313          responderán amablemente a todas sus preguntas en lo que respecta a su sistema.
314          Ellos también conocen mucho más acerca de su propio sistema que nosotros 
315          (nosotros no usamos RedHat).
316         
317 - PowerPC MkLinux
318         Necesitará tener la última version de Xpmac. Las versiones más antiguas
319         parecen tener errores que producen el cuelgue del sistema.
320         
321 - Debian GNU/Linux
322         Si quiere soporte JPEG y TIFF, asegúrese de tener libtiff-dev y
323          libjpeg-dev instalados.
325 - SuSE GNU/Linux
326         Si instaló el paquete Window Maker desde SuSE, 
327         desinstálelo antes de instentar compilar wmaker o podría
328         tener problemas.
329         
331 - MetroX (version desconocida)
332         MetroX tiene un error que corrompe pixmaps que se establecen como 
333         fondos de ventana. Si usa MetroX y tuvo problemas raros con texturas, no use 
334         texturas en las barras de títulos. O use un servidor X distinto.
336 INSTALACIÓN:
337 =============
339 Compilando Window Maker
340 ------------------
341         Para un comienzo rápido, tipee lo siguiente en el prompt del shell:
343         ./configure
344         make
346 luego, regístrese como root y tipee:
348         make install
349         ldconfig
351 o si quiere remover los símbolos de depuración desde los binarios y hacerlos más
352  pequeños, puede tipear:
354         make install-strip
355         ldconfig
357 Esto compilará e instalará Window Maker con los parámetros por defecto.
359 Si quiere personalizar algunas opciones de compilación, puede hacer lo siguiente.
360         
361         1. (opcional)Mire en la sección OPCIONES DE CONFIGURACIÓN para ver las
362          opciones disponibles. También ejecute:
364         ./configure --help
365         
366         para obtener un listado completo de otras opciones que están disponibles.
368         2. Ejecute configure con las opciones que quiera. Por ejemplo, si quiere 
369         usar la opción --enable-kde, tipee:
370         
371         ./configure --enable-kde
372         
373         3. (opcional) Edite src/wconfig.h con su editor de texto favorito y
374          echele un vistazo por algunas opciones que podría querer cambiar.
375          
376         4. Compile. Solo tipee:
378         make
379         
380         5. Regístrese como root (si no puede hacerlo, lea la sección "No tengo la contraseña de root" :-()
381          e instale Window Maker en su sistema:
382                 su root
383                 make install
386 Configuración específica del usuario
387 ------------------------------------
389 Estas instrucciones no necesitan ser seguidas al actualizar Window Maker 
390 desde una versión más antigua, a menos que se indique de otra forma en el archivo
391  NEWS.
393 Todo usuario en su sistema que desee ejecutar Window Maker debe hacer lo siguiente:
395         1. Instale los archivos de configuración de Window Maker en su directorio home.
396 Tipee:
397         wmaker.inst
399         wmaker.inst instalará los archivos de configuración de Window Maker y
400 configurará X para que automáticamente lance Window Maker al inicio.
402         Eso es todo!
403         
404         Puede tipear "man wmaker" para obtener algo de ayuda general para la 
405 configuración y otras cosas.
406 Lea la Guia de Usuario para una explicación más a fondo de Window Maker.
408 Podría querer dar una mirada a la FAQ también.
410 Instalando el paquete extras
411 ----------------------------
413 Desempaquete WindowMaker-extra-<número-de-versión>.tar.gz en /usr/local/share
415 Puede obtener el archivo en ftp://ftp.windowmmaker.org. Este archivo es optativo
416  y solo tiene unos pocos íconos, y temas. Busque el último <número-de-versión> 
417  disponible.
418  También hay un WindowMaker-extra.readme que le enseña donde vería ir ese paquete.
421 No tengo la contraseña de root :(
422 --------------------------------
424 Si no puede obtener privilegios de superusuario (no puede ser root) puede 
425 instalar wmaker en su propio directorio home. Para esto, proporcione la 
426 opción --prefix al ejecutar configure en el paso 2 de compilando Window Maker. 
427 También necesitará proporcionar la opción --with-appspath, para especificar la ruta
428 para WPrefs.app. Ejemplo:
430 ./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Apps
432 Luego haga /home/jshmoe/bin para que se lo incluya en su ruta de búsqueda, agregue
433 /home/jshmoe/lib a su variable de entorno LD_LIBRARY_PATH y ejecute bin/wmaker.inst
435 Por supuesto, /home/jshmoe se supone que va a ser reemplazado con la ruta a su 
436 directorio home real.
439 ACTUALIZANDO
440 ============
441 Si está actualizando desde una versión antigua de Window Maker:
443         1. Configure y compile Window Maker como siempre.
444         2. Instale Window Maker (pero no ejecute wmaker.inst)
445         3. Lea el archivo NEWS y actualice sus archivos de configuración, 
446            si es necesario.
448 PROBLEMAS
449 =========
451 Cuando tenga alguno problemas durante la configuración (al ejecutar configure),
452 tal como no poder usar una biblioteca de formato gráfico que piensa tener instalada,
453 mire en el archivo config.log para obtener ideas sobre el problema.
455 == Error al cargar las fuentes, siempre que existan.
457 Intente recompilar sin el soporte NLS.
459 == Error al configurar
461 ltconfig: unrecognized option `--no-reexec'
462 Try `ltconfig --help' for more information.
463 configure: error: libtool configure failed
465 quite la opción --no-reexec desde aclocal.m4 y libPropList/aclocal.m4 y
466  reconfigure.
467 También asegúrese que las versiones de autoconf y automake que tenga instaladas son:
469 autoconf 2.13
470 automake 1.4
471 libtool 1.3
473 Note que ella no debe ser libtool 1.2b, debe ser libtool 1.3, 
474 desde los sitios GNU.
476 == No puedo encontrar proplist.h o libPropList.something
478 Baje e instale libPropList desde los lugares ya citados en algún lugar 
479 de este archivo.
481 == configure no detecta libtiff, u otras bibliotecas gráficas.
483 Elimine config.cache, luego vuelva a ejecutar configure añadiendo las siguientes
484  opciones a configure (entre sus otras opciones):
486 --with-libs-from="-L/usr/local/lib"
487 --with-incs-from="-I/usr/local/include -I/usr/local/include/tiff"
489 Sustituya las rutas donde están localizadas sus bibliotecas gráficas y sus 
490 correspondientes archivos header. Puede colocar rutas múltiples en cualquiera de 
491 estas opciones, como se muestra en el ejemplo de --with-incs-from . Solo coloque
492 un espacio entre ellas.
494 == configure no detecta libXpm. 
496 * Verifique si tiene un enlace simbólico desde libXpm.so.4.9 a libXpm.so
498 == Segmentation fault al inicio.
500 * Verifique si la versión de libXPM que tiene es por lo menos la 4.7
502 * Verifique si tiene una versión actualizada de ~/GNUstep/Defaults/WindowMaker
504 Si no está seguro, intente renombrar ~/GNUstep a ~/GNUtmp y luego ejecute wmaker.inst
506 == "...: your machine is misconfigured. gethostname() returned (none)"
508 * el hostname de su máquina está definido a algo inválido, como comenzar con
509         un paréntesis. Haga un man hostname para obtener información acerca de como definirlo.
512 == El menú raíz contiene solo 2 entradas. ("XTerm" y "Exit...")
514 * Window Maker no está encontrando cpp (el preprocesador de C). Si su 
515 cpp no está ubicado en /lib/cpp, edite src/config.h y corrija la ruta en 
516 CPP_PATH.
518 == checking lex output file root... configure: error: cannot find output from true; giving up
520 * Lea la sección REQUERIMIENTOS de este archivo.
523 LOCALES/INTERNACIONALIZACIÓN
524 ============================
526 Window Maker tiene soporte de idioma nacional. Para activar este soporte, 
527 debe compilar Window Maker con algunos parámetros adicionales.
529 0 - Debe tener el paquete GNU gettext instalado. Puede obtenerse en
530 ftp://prep.ai.mit.edu/pub/gnu/gettext-nnn.tar.gz
532 Los pasos 1 al 3 pueden saltearse si usa el script Install.
534 1 - Debe seleccionar los idiomas que quiere soportar. Defina el
535 LINGUAS a la lista de locales que quiera. El Inglés siempre está
536 soportado. Ejemplo:
538 setenv LINGUAS "pt ja de"
539 en csh
543 export LINGUAS;LINGUAS="pt ja de"
544 en sh
546 La lista de locales soportados se pueden encontrar en po/README.
547 El Inglés es el idioma pr defecto.
549 Lea po/README si desea traducir y mantener archivos locale para otros 
550 idiomas.
552 2 - Adicionalmente, si su idioma usa caracteres multi-byte, tal como
553 Japonés o Coreano, debe definir la opción MultiByteText a YES
554 en ~/GNUstep/Defaults/WMGLOBAL
556 3 - Configure, compile e instale Window Maker normalmente.
558 4 - Para seleccionar un locale particular en tiempo de ejecución debe definir la
559  variable de entorno LANG al locale que quiera. Por ejemplo, si quiere definir
560 el locale portugués, debe ejecutar
562 setenv LANG pt
564 en csh o
566 export LANG; LANG=pt
568 en Bourne sh y similares
570 Nota: Si tiene definida la variable de entorno LC_CTYPE, debe
571 indefinirla antes de ejecutar wmaker.
573 Window Maker busca los archivos de definición de menú en el siguiente orden:
574 (para portugués brasileño, en este caso):
576 menu.pt_BR
577 menu.pt
578 menu
580 5 - Si elige un idioma que usa caracteres multi-byte, debe configurar 
581 las fuentes adecuadamente. Lea la página del manual para XCreateFontSet 
582 para obtener más detalles sobre esto. Debe cambiar el archivo ~/G/D/Windowmaker
583 para las fuentes usadas en barras de título, menús y otras cosas. Para las fuentes
584 usadas en ventanas de diálogo, cambie ~/G/D/WMGLOBAL. El %d en los nombres de las
585 fuentes no debe ser quitado. Puede también usar el script wsetfont proporcionado para
586 esta tarea. Lea el mismo script para obtener instrucciones.
588 Por ejemplo, puede especificar lo siguiente en ~/G/D/WindowMaker:
590 WindowTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
591 MenuTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
592 MenuTextFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
593 IconTitleFont = "-*-helvetica-medium-r-normal-*-8-*,-*-*-medium-r-normal-*-12-*";
594 ClipTitleFont = "-*-helvetica-bold-r-normal-*-10-*,-*-*-medium-r-normal-*-12-*";
595 DisplayFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-12-*";
597 y en ~/G/D/WMGLOBAL:
599 SystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
600 BoldSystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
602 Las 2 fuentes de arriba son usadas únicamente por aplicaciones que usan WINGs
603 (WindowMaker y WPrefs.app)
605 El script wsetfont que se proporciona le permitirá cambiar las definiciones de fuentes
606  de una manera fácil. De una mirada al script para detalles de uso.
608 traducido por Efraín Maximiliano Palermo <max_drake2001@yahoo.com.ar>