Keep all REAMDEs in sync.
[wine] / 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.org.
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 bison.
98 Se estiveres a usar RedHat ou Debian, instala os pacotes do flex e do bison.
99
100 Para os requesitos no caso de tu quereres contruir a documentação, ve a 
101 secção "DOCUMENTAÇÃO".
102
103 4.COMPILAÇÃO
104
105 No caso de escolheres não usar wineinstall, corre os seguintes comandos 
106 para contruir o Wine:
107
108 ./configure
109 make depend
110 make
111
112 Isto irá contruir o programa "wine" e numerosos suportes livraris/binarios.
113 O programa "wine" irá carregar e correr executaveis do Windows.
114 A livraria "libwine" ("winelib") pode ser usada para compilar e ligar 
115 Windows source code sob o Unix.
116
117 Para ver as opções de compilação da configuração, faz ./configure -help.
118
119 Para fazeres o upgrade de uma nova versão atravez de um ficheiro patch, 
120 primeiro cd para a directoria top da distribuição (a que contem este 
121 ficheiro README). A seguir faz um "make clean", e faz o patch da 
122 distribuição com:
123
124         gunzip -c patch-file | patch -p1
125
126 onde "patch-file" é o nome do ficheiro patch ( qualquer coisa como 
127 Wine.yymmdd.diff.gz). Tu podes entao correr fazendo "./configure", e 
128 depois corre "make depend && make"
129
130 5.SETUP
131
132 Uma vez o Wine contruido correctamente, tu podes entao fazer o "make 
133 install"; isto irá instalar o wine executavel, o Wine man page, e alguns 
134 outros ficheiros necessários.
135
136 Não esquecer de primeiro desinstalar qualquer previo conflito relativo a 
137 instalação do Wine.
138 Tenta outro "dpkg -r wine" ou "rpm -e wine" ou "make uninstall" antes de 
139 installar.
140
141 O Wine requer um ficheiro de configuração chamado "config" na directoria 
142 -/.wine. O formato deste ficheiro é explicado no ficheiro config man 
143 page (documentation/wine.conf.man).
144 O ficheiro documentation/samples/config contém um exemplo de ficheiro de 
145 configuraçao o qual tem que ser adaptado e copiado para a localização 
146 mencionada em cima.
147
148 Ver http://www.winehq.org/support/ para mais informação sobre a 
149 configuraçao.
150
151 No caso da livraria carregar erros (e.g. "Error while loading shared 
152 libraries: libntdll.so"), tem a certeza de adicionar o caminho da 
153 livraria para /etc/ld.so.conf e correr ldconfig como root.
154
155 Para verificar a correcção do ambiente, tu precisas para que o Wine 
156 corra com sucesso, tu podes correr "./tools/winecheck | less".
157 Tu irás obter uma percentagem do resultado indicando "Wine configuration 
158 correctness".
159 Como este programa é alpha, ainda não correu um verdadeiro e exaustivo 
160 teste, onde, então deve ser levado apenas como um primeiro passo de 
161 verificação.
162
163 Ver wine.confman page, como se muda apenas para o suporte em modo texto 
164 se desejado.
165
166 6.CORRER PROGRAMAS
167
168 Quando e invoca o Wine, tens que especificar o caminho (patch) complecto 
169 do executavel, ou apenas o nome do ficheiro.
170
171 Por exemplo:  para correr o Solitário:
172         wine sol                        (usando o searchpatch para lozalizar o ficheiro)
173         wine sol.exe
174
175         wine c:\\windows\\sol.exe       (usando um nome de ficheiro DOS)
176
177         wine /usr/windows/sol.exe       (usando um nome de ficheiro Unix)
178
179 Nota: o caminho do ficheiro também irá ser adicionado ao caminho(patch) 
180 quando um nome complecto é fornecido na linha de comando.
181
182 O Wine ainda não está complecto.então poderão vários programas 
183 quebrar(crash). Providenciamos-te bem para que o winedbg esteja 
184 correctamente e de acordo com a documentation/debugger.sgml, sera-te 
185 dado um detector de erros (debugger) para que possas investigar e 
186 corrigir os problemas.
187 Para mais informação como em fazer isto ou aquilo, por favor lê o 
188 ficheiro documentation/debugging.sgml.
189
190 Tu deves fazer um backup de todos os teus ficheiros importantes em que 
191 destes acesso ao Wine, ou usa uma especial cópia deles.tem havido casos 
192 de certos users que têm feito relatos de ficheiros corronpidos. Não 
193 corrar o Explorer, por exemplo, se não tiveres um backup próprio, que 
194 por vezes renomeia e estraga algumas directorias. Nem todos os MS apps 
195 como o e.g. Messenger são seguros, ao correrem o Explorer de alguma 
196 maneira. Este caso particular de corrupeçao (!$!$!$!$.pfr) podem ao 
197 menos parcialmente podem ser corrigidos usando
198 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
199
200 7.DOCUMENTAÇÃO
201
202 Alguma documentação (vários giuas de Wineetc.) podem ser encontrados na 
203 directoria documentation/ (aparte de também estar disponível em WineHQ).
204
205 Se quiseres lá processar ficheiros SGML, então podes correr "make doc" 
206 na directoria documentation/
207 Fazer isto requer que os pacotes das ferramentas sgml (para db2html, 
208 db2ps, db2pdf) chamados:
209 Debian:         docbook-utils
210 Mandrake:               sgml-tools-A.B.C-DDmdk
211 SuSE:           docbktls-A.BB.C-DD
212
213 8.ARRANJAR MAIS INFORMAÇÃO
214
215 www:    Uma grande quantidade de informação acerca do Wine está disponivel 
216         pelo WineHQ em http://www.winehq.org/ : varios guias Wine, base de  
217         dados de aplicações, localizaçao de erros. Isto é provavelmente o 
218         melhor ponto de começo.
219
220 FAQ:    A Wine FAQ está localizada em http://www.winehq.org/FAQ
221
222 Usenet: Tu podes discutor tópicos relacionados de Wine e obter ajuda em
223         comp.emulators.ms-windows.wine.
224
225 IRC:    Ajuda online está disponivel em #WineHQ on irc.freenode.net.
226
227
228 CVS:    O currente desenvolvimento do Wine está disponivel por CVS.
229         Vai a http://www.winehq.org/cvs para mais informação.
230
231 Mailing Lists:
232         Há algumas mailing list para responsaveis pelo desenvolvimento Wine; ver em
233         http://www.winehq.org/forums para mais informação.
234
235 Se tu acrescentaste algo,ou corrigiste um bug, por favor envia um patch 
236 (em 'diff -u' format) para wine-patches_at_winehq.org lista para inclusão 
237 no próximo lançamento.