More notes about the inner workings of DCOM.
[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 5.3 ou seguinte
33                 Solaris x86 2.5 ou seguinte
34                 NetBSD-current
35
36 Como o Wine requer sequências kernel-level para poder correr, apenas
37 os sistemas operativos acima mencionados são suportados.
38 Outros sistemas operativos que suportam sequências kernel, talvez 
39 venham a ser suportados no futuro.
40
41 Linux info:
42 Enquanto o Linux 2.2.x irá sobretudo trabalhar e Linux 2.0.x poderá
43 irá contudo trabalhar (versões 2.0.x antigas tem mal funcionamento 
44 relacionados a tarefas), será muito melhor teres um kernel atualizado
45 como 2.4.x.
46
47 FreeBSD info:
48 Wine deverá construir no FreeBSD 4.x e FreeBSD 5.x, mas versões anteriores
49 a FreeBSD 5.3 geralmente não trabalham corretamente.
50
51 Mais informações 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 construir 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 Requisitos básicos:
76 Tu precisas de ter instalados os fucheiros de include do X11 development
77 (chamados xlib6g-dev em Debian e Xfree86-devel no RedHat).
78
79 Requisitos para as ferramentas de construção:
80 Em sistemas x86 o gcc >= 2.7.2 é requerido.
81 Versões anteriores à 2.7.2.3 poderão ter problemas quando certos 
82 ficheiros são compilados com optimização, frequentemente devido a 
83 problemas relacionados com as gestôes dos cabeçalhos dos ficheiros. 
84 Actualmente o pgcc não trabalha com o Wine. A causa deste problema é 
85 desconhecida.
86
87 Claro que também precisas fazer "make" (geralmente como o GNU make).
88
89 Tu também necessitas do flex versao 2.5 ou superior e o bison.
90 Se estiveres a usar RedHat ou Debian, instala os pacotes do flex e do bison.
91
92 Bibliotecas de suporte opcionais:
93 Se desejares suporte de impressão do CUPS, por favor instala os pacotes
94 cups e cups-devel.
95
96 Para os requesitos no caso de tu quereres contruir a documentação, ve a 
97 secção "DOCUMENTAÇÃO".
98
99 4.COMPILAÇÃO
100
101 No caso de escolheres não usar wineinstall, corre os seguintes comandos 
102 para contruir o Wine:
103
104 ./configure
105 make depend
106 make
107
108 Isto irá contruir o programa "wine" e numerosos suportes livraris/binarios.
109 O programa "wine" irá carregar e correr executaveis do Windows.
110 A livraria "libwine" ("winelib") pode ser usada para compilar e ligar 
111 Windows source code sob o Unix.
112
113 Para ver as opções de compilação da configuração, faz ./configure -help.
114
115 Para fazeres o upgrade de uma nova versão atravez de um ficheiro patch, 
116 primeiro cd para a directoria top da distribuição (a que contem este 
117 ficheiro README). A seguir faz um "make clean", e faz o patch da 
118 distribuição com:
119
120         gunzip -c patch-file | patch -p1
121
122 onde "patch-file" é o nome do ficheiro patch ( qualquer coisa como 
123 Wine.yymmdd.diff.gz). Tu podes entao correr fazendo "./configure", e 
124 depois corre "make depend && make"
125
126 5.SETUP
127
128 Uma vez o Wine contruido correctamente, tu podes entao fazer o "make 
129 install"; isto irá instalar o wine executavel, o Wine man page, e alguns 
130 outros ficheiros necessários.
131
132 Não esquecer de primeiro desinstalar qualquer previo conflito relativo a 
133 instalação do Wine.
134 Tenta outro "dpkg -r wine" ou "rpm -e wine" ou "make uninstall" antes de 
135 installar.
136
137 O Wine requer um ficheiro de configuração chamado "config" na directoria 
138 -/.wine. O formato deste ficheiro é explicado no ficheiro config man 
139 page (documentation/wine.conf.man).
140 O ficheiro documentation/samples/config contém um exemplo de ficheiro de 
141 configuraçao o qual tem que ser adaptado e copiado para a localização 
142 mencionada em cima.
143
144 Ver http://www.winehq.org/support/ para mais informação sobre a 
145 configuraçao.
146
147 No caso da livraria carregar erros (e.g. "Error while loading shared 
148 libraries: libntdll.so"), tem a certeza de adicionar o caminho da 
149 livraria para /etc/ld.so.conf e correr ldconfig como root.
150
151 Para verificar a correcção do ambiente, tu precisas para que o Wine 
152 corra com sucesso, tu podes correr "./tools/winecheck | less".
153 Tu irás obter uma percentagem do resultado indicando "Wine configuration 
154 correctness".
155 Como este programa é alpha, ainda não correu um verdadeiro e exaustivo 
156 teste, onde, então deve ser levado apenas como um primeiro passo de 
157 verificação.
158
159 Ver wine.confman page, como se muda apenas para o suporte em modo texto 
160 se desejado.
161
162 6.CORRER PROGRAMAS
163
164 Quando e invoca o Wine, tens que especificar o caminho (patch) complecto 
165 do executavel, ou apenas o nome do ficheiro.
166
167 Por exemplo:  para correr o Solitário:
168         wine sol                        (usando o searchpatch para lozalizar o ficheiro)
169         wine sol.exe
170
171         wine c:\\windows\\sol.exe       (usando um nome de ficheiro DOS)
172
173         wine /usr/windows/sol.exe       (usando um nome de ficheiro Unix)
174
175 Nota: o caminho do ficheiro também irá ser adicionado ao caminho(patch) 
176 quando um nome complecto é fornecido na linha de comando.
177
178 O Wine ainda não está complecto.então poderão vários programas 
179 quebrar(crash). Providenciamos-te bem para que o winedbg esteja 
180 correctamente e de acordo com a documentation/debugger.sgml, sera-te 
181 dado um detector de erros (debugger) para que possas investigar e 
182 corrigir os problemas.
183 Para mais informação como em fazer isto ou aquilo, por favor lê o 
184 ficheiro documentation/debugging.sgml.
185
186 Tu deves fazer um backup de todos os teus ficheiros importantes em que 
187 destes acesso ao Wine, ou usa uma especial cópia deles.tem havido casos 
188 de certos users que têm feito relatos de ficheiros corronpidos. Não 
189 corrar o Explorer, por exemplo, se não tiveres um backup próprio, que 
190 por vezes renomeia e estraga algumas directorias. Nem todos os MS apps 
191 como o e.g. Messenger são seguros, ao correrem o Explorer de alguma 
192 maneira. Este caso particular de corrupeçao (!$!$!$!$.pfr) podem ao 
193 menos parcialmente podem ser corrigidos usando
194 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
195
196 7.DOCUMENTAÇÃO
197
198 Alguma documentação (vários giuas de Wineetc.) podem ser encontrados na 
199 directoria documentation/ (aparte de também estar disponível em WineHQ).
200
201 Se quiseres lá processar ficheiros SGML, então podes correr "make doc" 
202 na directoria documentation/
203 Fazer isto requer que os pacotes das ferramentas sgml (para db2html, 
204 db2ps, db2pdf) chamados:
205 Debian:         docbook-utils
206 Mandrake:               sgml-tools-A.B.C-DDmdk
207 SuSE:           docbktls-A.BB.C-DD
208
209 8.ARRANJAR MAIS INFORMAÇÃO
210
211 www:    Uma grande quantidade de informação acerca do Wine está disponivel 
212         pelo WineHQ em http://www.winehq.org/ : varios guias Wine, base de  
213         dados de aplicações, localizaçao de erros. Isto é provavelmente o 
214         melhor ponto de começo.
215
216 FAQ:    A Wine FAQ está localizada em http://www.winehq.org/FAQ
217
218 Usenet: Tu podes discutor tópicos relacionados de Wine e obter ajuda em
219         comp.emulators.ms-windows.wine.
220
221 IRC:    Ajuda online está disponivel em #WineHQ on irc.freenode.net.
222
223
224 CVS:    O currente desenvolvimento do Wine está disponivel por CVS.
225         Vai a http://www.winehq.org/cvs para mais informação.
226
227 Mailing Lists:
228         Há algumas mailing list para responsaveis pelo desenvolvimento Wine; ver em
229         http://www.winehq.org/forums para mais informação.
230
231 Se tu acrescentaste algo,ou corrigiste um bug, por favor envia um patch 
232 (em 'diff -u' format) para wine-patches_at_winehq.org lista para inclusão 
233 no próximo lançamento.