1. INTRODU��O Wine � um programa que permite executar programas Microsoft Windows (incluindo execut�veis DOS, Windows 3.x e Win32) no Unix. Constitu�do de um programa carregador (loader) que carrega e executa um bin�rio Microsoft Windows, e uma biblioteca (chamada Winelib) que implementa chamdas da API do Windows usando o equivalentes do Unix ou do X11. A biblioteca tamb�m pode ser usada para portar c�digo Win32 em execut�veis nativos Unix. Wine � software livre, liberado segundo a GNU LGPL; veja o arquivo LICEN�A para detalhes. 2.�NICIO R�PIDO Sempre que se compila os fontes, � recomendado usar o Wine Installer para construir e instalar o Wine. Estando no diret�rio de mais alto n�vel do fonte do Wine (que cont�m este arquivo), execute: ./tools/wineinstall Execute programas conforme "wine [op��es] programa". Para maiores informa��es e resolu��o de problemas, leia o restante deste arquivo, a p�gina "man" do Wine (man wine), e especialmente a abund�ncia de informa��o encontrada em http://www.winehq.org. 3.REQUERIMENTOS Para compilar e executaro Wine, voc� deve ter o seguinte: Linux vers�o 2.0.36 ou superior FreeBSD 5.3 ou posterior Solaris x86 2.5 ou posterior NetBSD-current Como o Wine requer suporte a tarefas a n�vel de kernel para executar, somente os sistemas operacionais acima mencionados s�o suportados. Outros sistemas operacionais que suportarem tarefas do kernel poder�o ter suporte no futuro. Informa��es para o Linux: Enquanto o Linux 2.2.x continuar em uso e Linux 2.0.x talvez continue em uso (vers�es 2.0.x antigas tem mal funcionamento relacionados a tarefas), ser� muito melhor ter um kernel mais atualizado como 2.4.x. Informa��es para o FreeBSD: Wine deve compilar no FreeBSD 4.x e FreeBSD 5.x, mas vers�es anteriores a FreeBSD 5.3 geralmente n�o funcionam corretamente. Mais informa��es encontram-se em: ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/ Informa��es para o Solaris: Voc� provavelmente necessitar� construir o Wine com as ferramentas GNU (gcc, gas, etc.). Aviso: instalar gas N�O assegura que ser� usado pelo gcc. Recompilar o gcc depois de instalar o gas ou criar uma liga��o ao cc, as e ld para as ferramentas gnu � dito ser necess�rio. Informa��es para o NetBSD: Certifique-se ter as op��es USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG ligadas ao kernel. Sistema de arquivo suportados: O Wine dever� executar na maioria dos sistema de arquivo. Contudo, o Wine falha ao iniciar se umsdos for usado para o diret�rio /tmp. Alguns problemas de compatibilidade foram relatados acessando arquivos usando o Samba. Tamb�m, como o NTFS apenas pode ser usado seguramente com acesso de somente leitura por enquanto, somos contr�rios ao uso do NTFS, pois os programas Windows precisam de acesso � escrita em quase tudo. No caso de arquivos NTFS, copie-os em um local em que se possa escrever. Requisitos b�sicos: Voc� necessita ter instalados os arquivos de inclus�o para desenvolvimento em X11 (called xlib6g-dev no Debian e XFree86-devel no RedHat). Requisitos para as ferramentas de constru��o: Em sistemas x86 o gcc >= 2.7.2 � requerido. Vers�es anteriores � 2.7.2.3 poder�o ter problemas quando certos arquivos s�o compilados com optimiza��o, frequentemente devido a problemas gerenciamento de arquivos de cabe�alho. Atualmente o pgcc n�o trabalha com o Wine. A causa deste problema � desconhecida. Naturalmente que necessita do "make" (comumente o GNU make). Tamb�m precisa do flex vers�o 2.5 ou posterior e do bison. Se estiver usando RedHat ou Debian, instale os pacotes do flex e do bison. Bibliotecas de suporte opcionais: Se desejar o suporte de impress�o do CUPS, por favor instale os pacotes cups e cups-devel. 4.COMPILA��O No caso de escolher n�o usar o wineinstall, execute os comandos a seguir para construir o Wine: ./configure make depend make Isto construir� o programa "wine" e suporte a v�rias bibliotecas/bin�rios. O programa "wine" carregar� e executar� execut�veis do Windows. A biblioteca "libwine" ("winelib") pode ser usada para compilar e ligar c�digo-fonte do Windows sob o Unix. Para ver as op��es de compila��o da configura��o, rode ./configure --help. Para atualizar para uma nova distribui��o usando arquivos de remendo (patch), primeiro mude para o diret�rio de mais alto n�vel da distribui��o (que cont�m o arquivo README). A seguir fa�a um "make clean", e remende a distribui��o com: gunzip -c patch-file | patch -p1 onde "patch-file" � o nome do arquivo de remendo patch (algo como Wine.aammdd.diff.gz). Pode ent�o reexecutar "./configure", e depois executar "make depend && make" 5.CONFIGURA��O Uma vez que o Wine esteja constru�do corretamente, voc� pode executar "make install"; assim ir� instalar o execut�vel do wine, as p�ginas "man" do Wine, e alguns outros arquivos necess�rios. N�o esque�a de desinstalar primeiramente qualquer instala��o pr�via do Wine que possa confitante. Tente qualquer um dos comandos "dpkg -r wine" ou "rpm -e wine" ou "make uninstall" antes de instalar. Veja a �rea de suporte em http://www.winehq.org/ para sugest�es sobre a configura�ao. No caso de erros de carga da biblioteca (ex: "Error while loading shared libraries: libntdll.so"), certifique-se de adicionar o caminho da biblioteca a /etc/ld.so.conf e executar ldconfig como root. 6.EXECUTAR PROGRAMAS Ao invocar o Wine, voc� pode especificar o caminho completo do execut�vel, ou somente um nome de arquivo. Por exemplo: para executar a Paci�ncia: wine sol (usando o caminho de pesquisa como wine sol.exe especificado no arquivo config) wine c:\\windows\\sol.exe (usando um nome de arquivo DOS) wine /usr/windows/sol.exe (usando um nome de arquivo Unix) wine sol.exe /parameter1 -parameter2 parameter3 (chamando o programa com par�metros) Nota: o caminho do arquivo ser� tamb�m adicionado ao caminho quando um nome completo for fornecido na linha de comando. O Wine ainda n�o est� completo, ent�o v�rios programas poder�o funcionar mal. Desde que voc� ajuste corretamente o winedbg de acordo com o arquivo documentation/debugger.sgml, voc� ir� entrar no depurador de modo que possa investigar e reparar o problema. Para mais informa��o como fazer isto, por favor leia o arquivo documentation/debugging.sgml. Voc� deve fazer uma c�pia de seguran�a de todos os seus arquivos importantes que o Wine possa acessar, ou usar uma c�pia especial deles com o Wine, pois houveram alguns casos de corrup��o de arquivos reportados por usu�rios. N�O execute o Explorer, por exemplo, se voc� n�o tiver um c�pia de seguran�a apropriada, como ele renomeia/cripples diversos diret�rios �s vezes. Mesmo executar outros aplicativos MS tais como por exemplo o Messenger � seguro, porque carrega o Explorer de algum modo. Este corrup��o em particular (!$!$!$!$.pfr) pode ao menos parcialmente ser reparado usando http://home.nexgo.de/andi.mohr/download/decorrupt_explorer 7. OBTENDO MAIS INFORMA��O WWW: Uma grande quantidade de informa��o sobre o Wine est� disponivel pelo WineHQ em http://www.winehq.org/ : v�rios guias do Wine, base de dados de aplica��es, rastreamento de erros. Este � provavelmente o melhor ponto para come�ar. FAQ: A Wine FAQ est� localizada em http://www.winehq.org/FAQ Usenet: Pode-se discutir t�picos relacionados ao Wine e obter ajuda em comp.emulators.ms-windows.wine. Bugs: Relate erros ao Wine Bugzilla em http://bugs.winehq.org Por favor pesquise a base de dados do bugzilla para verificar se seu problema j� tenha sido encontrado, antes de enviar um relat�rio do erro. Voc� pode tamb�m afixar relat�rios do erro em comp.emulators.ms-windows.wine. Por favor leia o arquivo documentation/bugs.sgml para ver qual informa��o � requerida. IRC: A ajuda online est� dispon�vel em #WineHQ em irc.freenode.net. CVS: O �rvore de desenvolvimento atual do Wine est� dispon�vel por CVS. V� em http://www.winehq.org/cvs para mais informa��o. Mailing Lists: H� diversas listas de mensagens para colaboradores no desenvolvimento do Wine; veja http://www.winehq.org/forums para mais informa��o. Se voc� adicionar algo, ou reparar um erro, envie por favor um remendo (no formato 'diff -u') � lista wine-patches@winehq.org para inclus�o na pr�xima distribui��o. -- Alexandre Julliard julliard@winehq.org -- Tradu��o para Portugu�s do Brasil: Marcelo Duarte