documentation/README.pt

   1 1. INTRODUÇÃO
   2
   3 Wine é um programa que permite correr programas Microsoft Windows
   4 (incluindo DOS, Windows 3.x e Win32 executáveis) em Unix.
   5 Consiste num carregador (loader), que carrega e executa um binário
   6 Microsoft Windows, e uma livraria (chamada Winelib) que implementa
   7 Windows API calls usando o Unix ou X11 equivalentes. A livraria também
   8 pode ser usada para "porting" Win32 código para executáveis do nativo Unix .
   9
  10 Wine é software grátis,autorizado segundo a GNU LGPL; ver o ficheiro
  11 LICENÇA para os detalhes.
  12
  13 2.ARRANQUE RÁPIDO
  14
  15 Sempre que se compila da source, é recomendado que se use o Wine
  16 Installer para construir e instalar o Wine. Desde a primeira directoria
  17 do Wine source (que contém este ficheiro),corre:
  18
  19 ./tools/wineinstall
  20
  21 Corre os programas conforme as "wine [options] program". Para mais
  22 informações e resoçução de problemas. Lê o resto deste ficheiro, a Wine
  23 man page, os ficheiros incluidos na directoria de documentação  do Wine
  24 source (ver "DOCUMENTATION"), e especialmente a abundância de informação
  25 encontrada em http://www.winehq.com.
  26
  27 3.REQUERIMENTOS
  28
  29 Para compilar e correr o Wine, deves ter o seguinte:
  30
  31                 Linux version 2.0.36 ou superior
  32                 FreeBSD 4.x ou FreeBSD 5-CURRENT
  33                 Solaris x86 2.5 ou seguinte
  34                 NetBSD-current
  35
  36 Linux info:
  37 Contudo o Linux versão 2.0.x irá sobretudo trabalhar, certos aspectos
  38 (especificamente LDT      sharing) requesitado para propriamente
  39 suportar  sequências Win32 não foram implementadas até a versão do
  40 kernel 2.2. Se tiveres quebras (crashes) com uma certa sequência ou que
  41 estejam relacionados, tu poderas querer fazer o upgrade pelo menos até a
  42 versão 2.2.
  43 Também, alguns bugs foram arranjados e certas funcionalidades foram
  44 tardiamente adicionadas nas séries do Linux 2.0.x, então se tiveres um
  45 Linux Kernel muito antigo.será melhor fazer o upgrade até ao lançamento
  46 da versão 2.0.x.
  47
  48 FreeBSD info:
  49 Certificar-se que tem as opções USER_LDT, SYSVSHM, SYSVSEM; e SYSVMSG,
  50 ligadas ao kernel. Mais informação
  51 encontra-se em:
  52 ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/
  53
  54
  55 Solaris info:
  56 Tu irás provavelmente ter que contruir o Wine com as ferramentas GNU
  57 (gcc, gas, etc.). Aviso: ao instalar gas *não* assegura que será usado
  58 pelo gcc. Recompilar o gcc depois de instalar o gas ou symking cc, as e
  59 ld para as ferramentas gnu é dito que é necessário.
  60
  61 NetBSD info:
  62 Certifica-te que tens as opções USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG
  63 ligadas ao teu kernel.
  64
  65 File systems info:
  66 O Wine deverá correr na maioria dos file systems. Contudo, o Wine falha
  67 no aranque se umsdos é usado para a directoria /tmp. Alguns problemas de
  68 compatibilidades foram relatados estando a usar ficheiros acessados
  69 através do Samba. Também, como o NTFS apenas pode ser usado com
  70 segurança com acesso readonly por agora, nós não recomendamos o uso de
  71 NTFS. Como os programas de Windows precisam de acesso write em quase tudo.
  72 No caso de NTFS files, copia por cima para uma localização em que se
  73 possa escrever.
  74
  75 O Wine requer sequências kernel-level para poder correr. Actualmente,
  76 apenas as versões 2.0 ou superiores do Linux. FreeBSD 4.x ou superiores,
  77 Solaris x86 versão 2.5 ou superiores, e NetBSD-actual são suportados.
  78 Outros sistemas operativos que suportam sequências kernel, talvez venham
  79 a ser suportados no futuro.
  80
  81 Tu precisas de ter o X11 development que inclua fucheiros instalados
  82 (chamados xlib6g-dev em Debian e Xfree86-devel no RedHat).
  83 Para usar o suporte do Wine para aplicacões multi-sequnciai, as tuas
  84 livrarias X têm que ser reentrantes, que é provavelmente "defaul" por agora.
  85 Se tu tens o libc6 (glibc2), ou compilaste as librarias X por ti prório,
  86 eles foram provavelmente compiladas com a opção de reentrância activada.
  87
  88 Em sistemas x86 o gcc >= 2.7.2 é requerido.
  89 Versões anteriores à 2.7.2.3 poderão ter problemas quando certos
  90 ficheiros são compilados com optimização, frequentemente devido a
  91 problemas relacionados com as gestôes dos cabeçalhos dos ficheiros.
  92 Actualmente o pgcc não trabalha com o Wine. A causa deste problema é
  93 desconhecida.
  94
  95 Claro que tambm precisas fazer "make" (geralmente como o GNU make).
  96
  97 Tu também necessitas do flex versao 2.5 ou superior e o yacc.
  98 Bison irá trabalhar como substituição do yacc. Se estiveres a usar
  99 RedHat ou Debian, instala os pacotes do flex e do bison.
 100
 101 Para o processamento automático dos scripts de teste, tu também irás
 102 precisar do libperl "development header support" (pacote libperl-dev em
 103 Debian).
 104
 105 Para os requesitos no caso de tu quereres contruir a documentação, ve a
 106 secção "DOCUMENTAÇÃO".
 107
 108 4.COMPILAÇÃO
 109
 110 No caso de escolheres não usar wineinstall, corre os seguintes comandos
 111 para contruir o Wine:
 112
 113 ./configure
 114 make depend
 115 make
 116
 117 Isto irá contruir o programa "wine" e numerosos suportes livraris/binarios.
 118 O programa "wine" irá carregar e correr executaveis do Windows.
 119 A livraria "libwine" ("winelib") pode ser usada para compilar e ligar
 120 Windows source code sob o Unix.
 121
 122 Para ver as opções de compilação da configuração, faz ./configure -help.
 123
 124 Para fazeres o upgrade de uma nova versão atravez de um ficheiro patch,
 125 primeiro cd para a directoria top da distribuição (a que contem este
 126 ficheiro README). A seguir faz um "make clean", e faz o patch da
 127 distribuição com:
 128
 129         gunzip -c patch-file | patch -p1
 130
 131 onde "patch-file" é o nome do ficheiro patch ( qualquer coisa como
 132 Wine.yymmdd.diff.gz). Tu podes entao correr fazendo "./configure", e
 133 depois corre "make depend && make"
 134
 135 5.SETUP
 136
 137 Uma vez o Wine contruido correctamente, tu podes entao fazer o "make
 138 install"; isto irá instalar o wine executavel, o Wine man page, e alguns
 139 outros ficheiros necessários.
 140
 141 Não esquecer de primeiro desinstalar qualquer previo conflito relativo a
 142 instalação do Wine.
 143 Tenta outro "dpkg -r wine" ou "rpm -e wine" ou "make uninstall" antes de
 144 installar.
 145
 146 O Wine requer um ficheiro de configuração chamado "config" na directoria
 147 -/.wine. O formato deste ficheiro é explicado no ficheiro config man
 148 page (documentation/wine.conf.man).
 149 O ficheiro documentation/samples/config contém um exemplo de ficheiro de
 150 configuraçao o qual tem que ser adaptado e copiado para a localização
 151 mencionada em cima.
 152
 153 Ver http://www.winehq.com/support/ para mais informação sobre a
 154 configuraçao.
 155
 156 No caso da livraria carregar erros (e.g. "Error while loading shared
 157 libraries: libntdll.so"), tem a certeza de adicionar o caminho da
 158 livraria para /etc/ld.so.conf e correr ldconfig como root.
 159
 160 Para verificar a correcção do ambiente, tu precisas para que o Wine
 161 corra com sucesso, tu podes correr "./tools/winecheck | less".
 162 Tu irás obter uma percentagem do resultado indicando "Wine configuration
 163 correctness".
 164 Como este programa é alpha, ainda não correu um verdadeiro e exaustivo
 165 teste, onde, então deve ser levado apenas como um primeiro passo de
 166 verificação.
 167
 168 Ver wine.confman page, como se muda apenas para o suporte em modo texto
 169 se desejado.
 170
 171 6.CORRER PROGRAMAS
 172
 173 Quando e invoca o Wine, tens que especificar o caminho (patch) complecto
 174 do executavel, ou apenas o nome do ficheiro.
 175
 176 Por exemplo:  para correr o Solitário:
 177         wine sol                        (usando o searchpatch para lozalizar o ficheiro)
 178         wine sol.exe
 179
 180         wine c:\\windows\\sol.exe       (usando um nome de ficheiro DOS)
 181
 182         wine /usr/windows/sol.exe       (usando um nome de ficheiro Unix)
 183
 184 Nota: o caminho do ficheiro também irá ser adicionado ao caminho(patch)
 185 quando um nome complecto é fornecido na linha de comando.
 186
 187 O Wine ainda não está complecto.então poderão vários programas
 188 quebrar(crash). Providenciamos-te bem para que o winedbg esteja
 189 correctamente e de acordo com a documentation/debugger.sgml, sera-te
 190 dado um detector de erros (debugger) para que possas investigar e
 191 corrigir os problemas.
 192 Para mais informação como em fazer isto ou aquilo, por favor lê o
 193 ficheiro documentation/debugging.sgml.
 194
 195 Tu deves fazer um backup de todos os teus ficheiros importantes em que
 196 destes acesso ao Wine, ou usa uma especial cópia deles.tem havido casos
 197 de certos users que têm feito relatos de ficheiros corronpidos. Não
 198 corrar o Explorer, por exemplo, se não tiveres um backup próprio, que
 199 por vezes renomeia e estraga algumas directorias. Nem todos os MS apps
 200 como o e.g. Messenger são seguros, ao correrem o Explorer de alguma
 201 maneira. Este caso particular de corrupeçao (!$!$!$!$.pfr) podem ao
 202 menos parcialmente podem ser corrigidos usando
 203 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
 204
 205 7.DOCUMENTAÇÃO
 206
 207 Alguma documentação (vários giuas de Wineetc.) podem ser encontrados na
 208 directoria documentation/ (aparte de também estar disponível em WineHQ).
 209
 210 Se quiseres lá processar ficheiros SGML, então podes correr "make doc"
 211 na directoria documentation/
 212 Fazer isto requer que os pacotes das ferramentas sgml (para db2html,
 213 db2ps, db2pdf) chamados:
 214 Debian:         docbook-utils
 215 Mandrake:               sgml-tools-A.B.C-DDmdk
 216 SuSe:           docbktls-A.BB.C-DD
 217
 218 8.ARRANJAR MAIS INFORMAÇÃO
 219
 220 www:    Uma grande quantidade de informação acerca do Wine está disponivel
 221         pelo WineHQ em http://www.winehq.com/ : varios guias Wine, base de
 222         dados de aplicações, localizaçao de erros. Isto é provavelmente o
 223         melhor ponto de começo.
 224
 225 FAQ:    A Wine FAQ está localizada em http://www.winehq.com/FAQ
 226
 227 Usenet: Tu podes discutor tópicos relacionados de Wine e obter ajuda em
 228         comp.emulators.ms-windows.wine.
 229
 230 IRC:    Ajuda online está disponivel em #WineHQ on irc.freenode.net.
 231
 232
 233 CVS:    O currente desenvolvimento do Wine está disponivel por CVS.
 234         Vai a http://www.winehq.com/cvs para mais informação.
 235
 236 Mailing Lists:
 237         Há algumas mailing list para responsaveis pelo desenvolvimento Wine; ver em
 238         http://www.winehq.com/forums para mais informação.
 239
 240 Se tu acrescentaste algo,ou corrigiste um bug, por favor envia um patch
 241 (em 'diff -u' format) para wine-patches_at_winehq.com lista para inclusão
 242 no próximo lançamento.