documentation/README.pt_br

   1 1. INTRODUÇÃO
   2
   3 Wine é um programa que permite executar programas Microsoft Windows
   4 (incluindo executáveis DOS, Windows 3.x e Win32) no Unix.
   5 Constituído de um programa carregador (loader) que carrega e executa
   6 um binário Microsoft Windows, e uma biblioteca (chamada Winelib) que
   7 implementa chamdas da API do Windows usando o equivalentes do Unix
   8 ou do X11. A biblioteca também pode ser usada para portar código
   9 Win32 em executáveis nativos Unix.
  10
  11 Wine é software livre, liberado segundo a GNU LGPL; veja o arquivo
  12 LICENÇA para detalhes.
  13
  14 2.ÍNICIO RÁPIDO
  15
  16 Sempre que se compila os fontes, é recomendado usar o Wine Installer
  17 para construir e instalar o Wine. Estando no diretório de mais alto
  18 nível do fonte do Wine (que contém este arquivo), execute:
  19
  20 ./tools/wineinstall
  21
  22 Execute programas conforme "wine [opções] programa". Para maiores
  23 informações e resolução de problemas, leia o restante deste arquivo,
  24 a página "man" do Wine (man wine), os arquivos incluídos no diretório
  25 de documentação do fonte do Wine (veja "DOCUMENTATION"), e especialmente
  26 a abundância de informação encontrada em http://www.winehq.com.
  27
  28 3.REQUERIMENTOS
  29
  30 Para compilar e executaro Wine, você deve ter o seguinte:
  31
  32                 Linux versão 2.0.36 ou superior
  33                 FreeBSD 4.x ou FreeBSD 5-CURRENT ou posterior
  34                 Solaris x86 2.5 ou posterior
  35                 NetBSD-current
  36
  37 Como o Wine requer suport a tarefas a nível de kernel para executar,
  38 somente os sistemas operacionais acima mencionados são suportados.
  39 Outros sistemas operacionais que suportarem tarefas do kernel poderão
  40 ter suporte no futuro.
  41
  42 Informações para o Linux:
  43 Enquanto o Linux 2.2.x deve continuar em uso e Linux 2.0.x poderá
  44 continuar em uso (versões antigas 2.0.x mal funcionamento relacionados a
  45 tarefas), será muito melhor ter um kernel mais atualizado como 2.4.x.
  46
  47 Informações para o FreeBSD:
  48 Certifique-se de ter as opções USER_LDT, SYSVSHM, SYSVSEM; e SYSVMSG,
  49 ligadas ao kernel. Mais informações encontram-se em:
  50 ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/
  51
  52 Informações para o Solaris:
  53 Você provavelmente necessitará construir o Wine com as ferramentas GNU
  54 (gcc, gas, etc.). Aviso: instalar gas NÂO assegura que será usado pelo
  55 gcc. Recompilar o gcc depois de instalar o gas ou criar uma ligação ao cc, as e
  56 ld para as ferramentas gnu é dito ser necessário.
  57
  58 Informações para o NetBSD:
  59 Certifique-se ter as opções USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG
  60 ligadas ao kernel.
  61
  62
  63 Sistema de arquivo suportados:
  64 O Wine deverá executar na maioria dos sistema de arquivo. Contudo, o Wine falha
  65 ao iniciar se umsdos for usado para o diretório /tmp. Alguns problemas de
  66 compatibilidade foram relatados acessando arquivos usando o Samba. Também,
  67 como o NTFS apenas pode ser usado seguramente com acesso de somente leitura por
  68 enquanto, somos contrários ao uso do NTFS, pois os programas Windows precisam de
  69 acesso à escrita em quase tudo.
  70 No caso de arquivos NTFS, copie-os em um local em que se possa escrever.
  71
  72 Requisitos básicos:
  73 Você necessita ter instalados os arquivos de inclusão para desenvolvimento em X11
  74 (called xlib6g-dev no Debian e XFree86-devel no RedHat).
  75
  76 Requisitos para as ferramentas de construção:
  77 Em sistemas x86 o gcc >= 2.7.2 é requerido.
  78 Versões anteriores à 2.7.2.3 poderão ter problemas quando certos arquivos são
  79 compilados com optimização, frequentemente devido a problemas gerenciamento de
  80 arquivos de cabeçalho. Atualmente o pgcc não trabalha com o Wine. A causa deste
  81 problema é desconhecida.
  82
  83 Naturalmente que necessita do "make" (comumente o GNU make).
  84
  85 Tamném precisa do flex versão 2.5 ou posterior e do yacc.
  86 O Bison funciona como um substituto do yacc. Se estiver usando
  87 RedHat ou Debian, instale os pacotes do flex e do bison.
  88
  89 Bibliotecas de suporte opcionais:
  90 Se desejar o suporte de impressão do CUPS, por favor instale os pacotes
  91 cups e cups-devel.
  92
  93 Para o processamento automático dos scripts de teste, também precisará
  94 do suporte a cabeçalhos do libperl (pacote libperl-dev no Debian).
  95
  96 Para os requesitos no caso de ter a intenção de contruir a documentação, veja
  97 a seção "DOCUMENTAÇÃO".
  98
  99 4.COMPILAÇÃO
 100
 101 No caso de escolher não usar o wineinstall, execute os comandos a seguir
 102 para construir o Wine:
 103
 104 ./configure
 105 make depend
 106 make
 107
 108 Isto construirá o programa "wine" e suporte a várias bibliotecas/binários.
 109 O programa "wine" carregará e executará executáveis do Windows.
 110 A biblioteca "libwine" ("winelib") pode ser usada para compilar e ligar
 111 código-fonte do Windows sob o Unix.
 112
 113 Para ver as opções de compilação da configuração, rode ./configure --help.
 114
 115 Para atualizar para uma nova distribuição usando arquivos de remendo (patch),
 116 primeiro mude para o diretório de mais alto nível da distribuição (que
 117 contém o arquivo README). A seguir faça um "make clean", e remende a
 118 distribuição com:
 119
 120         gunzip -c patch-file | patch -p1
 121
 122 onde "patch-file" é o nome do arquivo de remendo patch (algo como
 123 Wine.aammdd.diff.gz). Pode então reexecutar "./configure", e depois
 124 executar "make depend && make"
 125
 126 5.CONFIGURAÇÃO
 127
 128 Uma vez que o Wine esteja construído corretamente, você pode executar
 129 "make install"; assim irá instalar o executável do wine, as páginas
 130 "man" do Wine, e alguns outros arquivos necessários.
 131
 132 Não esqueça de desinstalar primeiramente qualquer instalação prévia do
 133 Wine que possa confitante. Tente qualquer um dos comandos "dpkg -r wine" ou "rpm -e wine" ou "make uninstall" antes de
 134 instalar.
 135
 136 Se você quiser ler a documentação fornecida com a fonte do Wine,
 137 veja a seção "DOCUMENTAÇÃO".
 138
 139 O Wine requer um arquivo de configuração chamado "config" no diretório
 140 ~/.wine. O formato deste arquivo é explicado em "man wine.conf"
 141 (documentation/wine.conf.man).
 142 O arquivo documentation/samples/config contém um exemplo de arquivo de
 143 configuração para ser adaptado e copiado para a localização anteriormente
 144 mencionada.
 145
 146 Não se esqueça de adicionar entradas vitais no registro, aplicando
 147 winedefault.reg com programs/regedit/. Veja o diretório documentation/
 148 para detalhes.
 149
 150 Veja a área de suporte em http://www.winehq.com/ para mais sugestões
 151 sobre a configuraçao.
 152
 153 No caso de erros de carga da biblioteca
 154 (ex: "Error while loading shared libraries: libntdll.so"), certifique-se
 155 de adicionar o caminho da biblioteca a /etc/ld.so.conf e executar
 156 ldconfig como root.
 157
 158 A fim verificar a exatidão do ambiente que você necessita para que o
 159 Wine funcione com sucesso, você pode executar "./tools/winecheck | less".
 160 Você irá obter um percentual do resultado indicando "Wine configuration
 161 correctness".
 162 Como este programa é alfa, não rodou um teste verdadeiramente completo ainda,
 163 embora, assim deve ser feito como uma primeira etapa da verificação somente.
 164
 165 Veja em "man wine.conf" como se muda para o suporte em modo texto se desejar.
 166
 167 6.EXECUTAR PROGRAMAS
 168
 169 Ao invocar o Wine, você pode especificar o caminho completo do executável,
 170 ou somente um nome de arquivo.
 171
 172 Por exemplo:  para executar a Paciência:
 173         wine sol                        (usando o caminho de pesquisa como
 174         wine sol.exe                     especificado no arquivo config)
 175
 176         wine c:\\windows\\sol.exe       (usando um nome de arquivo DOS)
 177
 178         wine /usr/windows/sol.exe       (usando um nome de arquivo Unix)
 179
 180         wine -- sol.exe /parameter1 -parameter2 parameter3
 181                                    (chamando o programa com parãmetros)
 182
 183 Nota: o caminho do arquivo será também adicionado ao caminho
 184 quando um nome completo for fornecido na linha de comando.
 185
 186 O Wine ainda não está completo, então vários programas poderão funcionar mal.
 187 Desde que você ajuste corretamente o winedbg de acordo com o arquivo
 188 documentation/debugger.sgml, você irá entrar no depurador de modo que possa
 189 investigar e reparar o problema. Para mais informação como fazer isto, por favor
 190 leia o arquivo documentation/debugging.sgml.
 191
 192 Você deve fazer uma cópia de segurança de todos os seus arquivos importantes
 193 que o Wine possa acessar, ou usar uma cópia especial deles com o Wine, pois
 194 houveram alguns casos de corrupção de arquivos reportados por usuários. NÃO
 195 execute o Explorer, por exemplo, se você não tiver um cópia de segurança
 196 apropriada, como ele renomeia/cripples diversos diretórios às vezes. Mesmo
 197 executar outros aplicativos MS tais como por exemplo o Messenger é seguro,
 198 porque carrega o Explorer de algum modo. Este corrupção em particular
 199 (!$!$!$!$.pfr) pode ao menos parcialmente ser reparado usando
 200 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
 201
 202 7. DOCUMENTAÇÃO
 203
 204 Alguma documentação (vários guias do Wine, etc.) podem ser encontrados no
 205 diretório documentation/ (apesar de também estar disponível em WineHQ).
 206
 207 Se quizer processar arquivos SGML que lá estão, então execute "make doc"
 208 no diretório documentation/.
 209 Fazer isto requer que os pacotes das ditas ferramentas sgml (para db2html,
 210 db2ps, db2pdf):
 211 Debian:         docbook-utils
 212 Mandrake:       sgml-tools-A.B.C-DDmdk
 213 SuSE:           docbktls-A.BB.C-DD
 214
 215 8. OBTENDO MAIS INFORMAÇÃO
 216
 217 WWW:    Uma grande quantidade de informação sobre o Wine está disponivel
 218         pelo WineHQ em http://www.winehq.com/ : vários guias do Wine,
 219         base de dados de aplicações, rastreamento de erros. Este é
 220         provavelmente o melhor ponto para começar.
 221
 222 FAQ:    A Wine FAQ está localizada em http://www.winehq.com/FAQ
 223
 224 Usenet: Pode-se discutir tópicos relacionados ao Wine e obter ajuda em
 225         comp.emulators.ms-windows.wine.
 226
 227 Bugs:   Relate erros ao Wine Bugzilla em http://bugs.winehq.com
 228         Por favor pesquise a base de dados do bugzilla para verificar se
 229         seu problema já tenha sido encontrado, antes de enviar um
 230         relatório do erro. Você pode também afixar relatórios do erro em
 231         comp.emulators.ms-windows.wine. Por favor leia o arquivo
 232         documentation/bugs.sgml para ver qual informação é requerida.
 233
 234 IRC:    A ajuda online está disponível em #WineHQ em irc.freenode.net.
 235
 236 CVS:    O árvore de desenvolvimento atual do Wine está disponível por CVS.
 237         Vá em http://www.winehq.com/cvs para mais informação.
 238
 239 Mailing Lists:
 240         Há diversas listas de mensagens para colaboradores no desenvolvimento
 241         do Wine; veja http://www.winehq.com/forums para mais informação.
 242
 243 Se você adicionar algo, ou reparar um erro, envie por favor um remendo
 244 (no formato 'diff -u') à lista wine-patches@winehq.com para inclusão na
 245 próxima distribuição.
 246
 247 --
 248 Alexandre Julliard
 249 julliard@winehq.com
 250
 251 --
 252 Tradução para Português do Brasil: Marcelo Duarte