1. INTRODUCCIÓN Wine es un programa que permite la ejecución de programas de Microsoft Windows (incluyendo ejecutables de DOS, Windows 3.x y Win32) sobre Unix. Consiste en un programa cargador que carga y ejecuta un binario de Microsoft Windows, y una librería (llamada Winelib) que implementa las llamadas a la API de Windows usando sus equivalentes Unix o X11. La librería puede también utilizarse para portar código Win32 a ejecutables Unix nativos. Wine es software libre, publicado bajo la licencia GNU LGPL; vea el fichero LICENSE para los detalles. 2. INICIO RÁPIDO Cuando compile desde el código fuente, se recomienda utilizar el Instalador de Wine para contruir e instalar Wine. Desde el directorio superior del código de Wine (el cual contiene este fichero), ejecute: ./tools/wineinstall Ejecute programas con "wine [opciones] programa". Para más información y resolución de problemas, lea el resto de este fichero, la página de manual de Wine, los ficheros en el directorio de documentación del código fuente de Wine (vea "DOCUMENTACIÓN") y, específicamente, la numerosa información que se encuentra en http://www.winehq.org. 3. REQUISITOS Para compilar y ejecutar Wine, deberá tener uno de los siguientes: Linux versión 2.0.36 o superior FreeBSD 5.3 o superior Solaris x86 2.5 o superior NetBSD-current Ya que Wine requiere soporte de hilos a nivel de núcleo para ejecutarse, sólo se soportan los sistemas operativos arriba mencionados. Otros sistemas operativos que soportan hilos de núcleo pueden ser soportados en el futuro. Información de Linux: A pesar de que Linux 2.2.x debería funcionar todavía y Linux 2.0.x aún podría funcionar (versiones antiguas de 2.0.x tenían problemas relacionados con los hilos), es mejor tener un núcleo actual como los 2.4.x. Información de FreeBSD: Wine debería construirse sobre FreeBSD 4.x y FreeBSD 5.x, pero versiones anteriores a FreeBSD 5.3 generalmente no funcionarán adecuadamente. Más información se puede encontrar en el árbol de portes de FreeBSD en . Información de Solaris: Lo más probable es que necesite construir con el conjunto de herramientas GNU (gcc, gas, etc.). Advertencia: el instalar gas *no* asegura que sea utilizado por gcc. Se dice que recompilar gcc tras la instalación de gas o enlazar simbólicamente cc, as y ld a las herramientas gnu es necesario. Información de NetBSD: Asegúrese de que posee las opciones USER_LDT, SYSVSHM, SYSVSEM, y SYSVMSG activadas en su núcleo. Sistemas de ficheros soportados: Wine debería ejecutarse en la mayoría de los sistemas de ficheros. Sin embargo, Wine no conseguirá iniciarse si umsdos es utilizado para el directorio /tmp. Unos cuantos problemas de compatibilidad se han reportado también al utilizar ficheros accedidos a través de Samba. Además, como de momento NTFS sólo puede ser utilizado con seguridad con acceso de sólo lectura, recomendamos no utilizar NTFS, ya que los programas Windows necesitan acceso de escritura en casi cualquier sitio. En el caso de ficheros NTFS, cópielos a una localización escribible. Requisitos básicos: Necesita tener los ficheros de inclusión de desarrollo de X11 instalados (llamados xlib6g-dev en Debian y XFree86-devel en RedHat). Requisitos de herramienta de construcción: Sobre sistemas x86 se requiere gcc >= 2.7.2. Versiones más antiguas que la 2.7.2.3 pueden tener problemas cuando ciertos ficheros sean compilados con optimización, a menudo debido a problemas con el manejo de ficheros de cabecera. pgcc actualmente no funciona con Wine. La causa de este problema se desconoce. Por supuesto también necesita "make" (preferiblemente GNU make). También necesita flex versión 2.5 o superior y bison. Si está utilizando RedHat o Debian, instale los paquetes flex y bison. Librerías de soporte adicionales: Si desea soporte de impresión CUPS, por favor instale los paquetes cups y cups-devel. Para los requisitos en el caso de que pretenda construir usted mismo la documentación, vea la sección "DOCUMENTACIÓN". 4. COMPILACIÓN En el caso de que elija no utilizar wineinstall, ejecute los siguientes comandos para construir Wine: ./configure make depend make Esto construirá el programa "wine" y numerosas librerías/binarios de soporte. El programa "wine" cargará y ejecutará ejecutables de Windows. La librería "libwine" ("Winelib") puede utilizarse para compilar y enlazar código fuente de Windows bajo Unix. Para ver las opciones de configuración para la compilación, haga ./configure --help. Para actualizar a nueva versión usando un fichero de parches, primero haga cd al directorio superior de la versión (el que contiene este fichero README). Entonces haga un "make clean", y parchee la versión con: gunzip -c fichero-parche | patch -p1 donde "fichero-parche" es el nombre del fichero de parches (algo como Wine-aammdd.diff.gz). Entonces puede volver a ejecutar "./configure", y luego "make depend && make". 5. CONFIGURACIÓN Una vez que Wine ha sido construido correctamente, puede hacer "make install"; esto instalará el ejecutable de wine, la página de manual de Wine, y otros cuantos ficheros necesarios. No olvide desinstalar antes cualquier instalación anterior de Wine conflictiva. Intente "dpkg -r wine" o "rpm -e wine" o "make uninstall" antes de instalar. Si desea leer la documentación que proporcionada con el código de Wine, vea la sección "DOCUMENTACIÓN". Wine requiere un fichero de configuración llamado "config" en su directorio ~/.wine. El formato de este fichero se explica en la página de manual del fichero de configuración (documentation/wine.conf.man). El fichero documentation/samples/config contiene un ejemplo de fichero de configuración que tiene que adaptarse y copiarse a la localización mencionada arriba. Vea la zona de Soporte en http://www.winehq.org/ para más consejos de configuración. En el caso de que tenga problemas de carga de librerías (p. ej. "Error while loading shared libraries: libntdll.so"), asegúrese de añadir la ruta de las librerías a /etc/ld.so.conf y ejecutar ldconfig como root. 6. EJECUTANDO PROGRAMAS Cuando invoque Wine, puede especificar la ruta completa al ejecutable, o sólo el nombre del fichero. Por ejemplo: para ejecutar el Solitario: wine sol (usando la ruta de búsqueda indicada en el fichero wine sol.exe de configuración para encontrar el fichero) wine c:\\windows\\sol.exe (usando la sintaxis de nombre de fichero de DOS) wine /usr/windows/sol.exe (usando la sintaxis de nombre de fichero de Unix) wine sol.exe /parametro1 -parametro2 parametro3 (llamando al programa con parámetros) Nota: la ruta del fichero también se añadirá a la ruta cuando se proporcione un nombre completo en la línea de comandos. Wine todavía no está completo, por lo que algunos programas pueden fallar. Si configura winedbg correctamente de acuerdo con documentation/debugger.sgml, entrará en un depurador para que pueda investigar y corregir el problema. Para más información sobre cómo hacer esto, por favor lea el fichero documentation/debugging.sgml. Debería hacer copia de seguridad de todos sus ficheros importantes a los dé acceso desde Wine, o utilizar una copia especial para Wine de ellos, ya que ha habido algunos casos de usuarios reportando corrupción de ficheros. NO ejecute Explorer, por lo tanto, si no posee una copia de seguridad adecuada, ya que renombra/corrompe a veces algunos directorios. Tampoco otras aplicaciones MS como p. ej. Messenger son seguras, ya que lanzan de algún modo Explorer. Esta corrupción particular (!$!$!$!$.pfr) puede corregirse al menos parcialmente utilizando http://home.nexgo.de/andi.mohr/download/decorrupt_explorer 7. DOCUMENTACIÓN Alguna documentación (varias guías de Wine, etc.) puede encontrarse en el directorio documentation/ (aparte de que también está disponible en WineHQ). Si desea procesar los ficheros SGML de allí, puede ejecutar "make doc" en el directorio documentation/. Para hacerlo requiere el paquete de herramientas sgml (para db2html, db2ps, db2pdf) de nombre: Doing so requires the... (BORRAR) Debian: docbook-utils Mandrake: sgml-tools-A.B.C-DDmdk SuSE: docbktls-A.BB.C-DD 8. OBTENIENDO MÁS INFORMACIÓN WWW: Una gran cantidad de información sobre Wine está disponible en WineHQ en http://www.winehq.org/ : varias guías de Wine, base de datos de aplicaciones, registro de bugs. Este es probablemente el mejor punto de partida. FAQ: La FAQ de Wine se encuentra en http://www.winehq.org/FAQ Usenet: Puede discutir sobre temas relacionados con Wine y obtener ayuda en comp.emulators.ms-windows.wine. Bugs: Reporte bugs al Bugzilla de Wine en http://bugs.winehq.org Por favor, busque en la base de datos de bugzilla para comprobar si su problema ya se encuentra antes de enviar un informe de bug. Puede también enviar informes de bugs a comp.emulators.ms-windows.wine. Por favor, lea el fichero documentation/bugs.sgml para ver qué información se requiere. IRC: Hay disponoble ayuda online en el canal #WineHQ de irc.freenode.net. CVS: El árbol actual de desarrollo de Wine está disponible a través de CVS. Vaya a http://www.winehq.org/cvs para más información. Listas de correo: Hay varias listas de correo para desarrolladores de Wine; vea http://www.winehq.org/forums para más información. Si añade algo, o corrige algún bug, por favor envíe un parche (en formato 'diff -u') a la lista wine-patches@winehq.org para su inclusión en la siguiente versión. -- Alexandre Julliard julliard@winehq.org