wine/documentation
2003-06-23 19:51:21 +00:00
..
samples - added stubs for GetOpenFileNamePreview{A,W} 2003-06-23 03:33:25 +00:00
status Typos/spelling fixes. 2003-06-18 03:30:39 +00:00
.cvsignore Transform the Packaging Guide into a nice ASCII file. 2003-04-14 21:31:48 +00:00
architecture.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
authors.ent Updated my e-mail address. 2003-06-04 20:26:34 +00:00
bugs.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
build.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
ChangeLog.OLD Moved old ChangeLog to documentation/ChangeLog.OLD. 1998-10-18 16:34:50 +00:00
compiling.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
configuring.sgml Mention the necessary configuration file header. 2003-05-06 18:36:09 +00:00
consoles.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
cvs-regression.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
cvs.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
ddraw.txt Authors: Andrew Lewycky <andrew@transgaming.com>, Gavriel State <gav@transgaming.com>, Ove Kaaven <ovek@transgaming.com> 2001-01-04 22:44:55 +00:00
debugger.sgml Added a section about using kgdb and ddd to debug wine. 2003-06-20 21:27:27 +00:00
debugging.sgml Typos/spelling fixes. 2003-06-18 03:30:39 +00:00
default.dsl Documentation update. 2000-12-13 21:52:37 +00:00
dlls.sgml Typos/spelling fixes. 2003-06-18 03:30:39 +00:00
documentation.sgml Fix miscellaneous spelling errors and typos. 2003-05-13 00:41:57 +00:00
faq.sgml Remove stale links from the FAQ. 2003-05-02 20:10:50 +00:00
fonts.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
getting.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
glossary.sgml Fix a few incorrect tags. 2003-04-07 23:20:08 +00:00
gui Window style updates. 1999-07-03 12:06:26 +00:00
HOWTO-winelib Typos/spelling fixes. 2003-06-18 03:30:39 +00:00
i18n.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
implementation.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
installation-und-konfiguration.german - new, much more detailed and easier "step-by-step" layout 2003-04-01 03:26:13 +00:00
installing.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
introduction.sgml - improve intro text 2003-05-02 20:09:58 +00:00
make_winehq Use the standard db2html instead of our db2html-winehq script. 2003-04-20 02:43:22 +00:00
Makefile.in Make sure to return an error if the file generation fails. 2003-06-23 19:51:21 +00:00
multimedia.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
ole.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
opengl.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
PACKAGING Typos/spelling fixes. 2003-06-18 03:30:39 +00:00
patches.sgml Typos/spelling fixes. 2003-06-18 03:30:39 +00:00
porting.sgml Fix miscellaneous spelling errors and typos. 2003-05-13 00:41:57 +00:00
print.dsl Better formatting for PDF output. 2001-09-26 23:02:31 +00:00
printing.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
README.fr Keep README.fr in sync. 2003-04-09 23:32:16 +00:00
README.it Italian translation of the README file. 2003-05-20 02:16:17 +00:00
README.pt Tranlation of English README to Portuguese. 2003-06-18 03:18:48 +00:00
registry.sgml - new, much more detailed and easier "step-by-step" layout 2003-04-01 03:26:13 +00:00
running.sgml - improve intro text 2003-05-02 20:09:58 +00:00
shell32 Typos/spelling fixes. 2003-06-18 03:30:39 +00:00
testing.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
tools.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
wine-devel.sgml - new, much more detailed and easier "step-by-step" layout 2003-04-01 03:26:13 +00:00
wine-doc.sgml Transform the Packaging Guide into a nice ASCII file. 2003-04-14 21:31:48 +00:00
wine-faq.sgml Store the HTML into index.html like for the other docs. 2003-05-11 03:38:37 +00:00
wine-user.sgml - new, much more detailed and easier "step-by-step" layout 2003-04-01 03:26:13 +00:00
wine.conf.man Application specific settings are also supported for dsound and 2003-05-01 00:00:28 +00:00
wine.man.in Removed SO loading type. 2003-03-05 02:50:25 +00:00
wine.texinfo Added information about POSIX, Unix, X11 trademarks. 2002-09-20 19:28:04 +00:00
winehq.dsl Better formatting for PDF output. 2001-09-26 23:02:31 +00:00
winelib-bindlls.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
winelib-intro.sgml Fix a few style issues. 2003-05-13 04:48:11 +00:00
winelib-mfc.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
winelib-pkg.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
winelib-porting.sgml Fix miscellaneous spelling errors and typos. 2003-05-13 00:41:57 +00:00
winelib-toolkit.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
winelib-user.sgml - Split Winelib User Guide into smaller files for easier maintenance 2001-01-24 19:36:24 +00:00

1. INTRODUÇÃO

Wine é um programa que permite correr programas Microsoft Windows 
(incluindo DOS, Windows 3.x e Win32 executáveis) em Unix.
Consiste num carregador (loader), que carrega e executa um binário 
Microsoft Windows, e uma livraria (chamada Winelib) que implementa 
Windows API calls usando o Unix ou X11 equivalentes. A livraria também 
pode ser usada para "porting" Win32 código para executáveis do nativo Unix .

Wine é software grátis,autorizado segundo a GNU LGPL; ver o ficheiro 
LICENÇA para os detalhes.

2.ARRANQUE RÁPIDO

Sempre que se compila da source, é recomendado que se use o Wine 
Installer para construir e instalar o Wine. Desde a primeira directoria 
do Wine source (que contém este ficheiro),corre:

./tools/wineinstall

Corre os programas conforme as "wine [options] program". Para mais 
informações e resoçução de problemas. Lê o resto deste ficheiro, a Wine 
man page, os ficheiros incluidos na directoria de documentação  do Wine 
source (ver "DOCUMENTATION"), e especialmente a abundância de informação 
encontrada em http://www.winehq.com.

3.REQUERIMENTOS

Para compilar e correr o Wine, deves ter o seguinte:

		Linux version 2.0.36 ou superior
		FreeBSD 4.x ou FreeBSD 5-CURRENT
		Solaris x86 2.5 ou seguinte
		NetBSD-current

Linux info:
Contudo o Linux versão 2.0.x irá sobretudo trabalhar, certos aspectos 
(especificamente LDT      sharing) requesitado para propriamente 
suportar  sequências Win32 não foram implementadas até a versão do 
kernel 2.2. Se tiveres quebras (crashes) com uma certa sequência ou que 
estejam relacionados, tu poderas querer fazer o upgrade pelo menos até a 
versão 2.2.
Também, alguns bugs foram arranjados e certas funcionalidades foram 
tardiamente adicionadas nas séries do Linux 2.0.x, então se tiveres um 
Linux Kernel muito antigo.será melhor fazer o upgrade até ao lançamento 
da versão 2.0.x.

FreeBSD info:
Certificar-se que tem as opções USER_LDT, SYSVSHM, SYSVSEM; e SYSVMSG, 
ligadas ao kernel. Mais informação
encontra-se em: 
ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/


Solaris info:
Tu irás provavelmente ter que contruir o Wine com as ferramentas GNU 
(gcc, gas, etc.). Aviso: ao instalar gas *não* assegura que será usado 
pelo gcc. Recompilar o gcc depois de instalar o gas ou symking cc, as e 
ld para as ferramentas gnu é dito que é necessário.

NetBSD info:
Certifica-te que tens as opções USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG 
ligadas ao teu kernel.

File systems info:
O Wine deverá correr na maioria dos file systems. Contudo, o Wine falha 
no aranque se umsdos é usado para a directoria /tmp. Alguns problemas de 
compatibilidades foram relatados estando a usar ficheiros acessados 
através do Samba. Também, como o NTFS apenas pode ser usado com 
segurança com acesso readonly por agora, nós não recomendamos o uso de 
NTFS. Como os programas de Windows precisam de acesso write em quase tudo.
No caso de NTFS files, copia por cima para uma localização em que se 
possa escrever.

O Wine requer sequências kernel-level para poder correr. Actualmente, 
apenas as versões 2.0 ou superiores do Linux. FreeBSD 4.x ou superiores, 
Solaris x86 versão 2.5 ou superiores, e NetBSD-actual são suportados.
Outros sistemas operativos que suportam sequências kernel, talvez venham 
a ser suportados no futuro.

Tu precisas de ter o X11 development que inclua fucheiros instalados 
(chamados xlib6g-dev em Debian e Xfree86-devel no RedHat).
Para usar o suporte do Wine para aplicacões multi-sequnciai, as tuas 
livrarias X têm que ser reentrantes, que é provavelmente "defaul" por agora.
Se tu tens o libc6 (glibc2), ou compilaste as librarias X por ti prório, 
eles foram provavelmente compiladas com a opção de reentrância activada.

Em sistemas x86 o gcc >= 2.7.2 é requerido.
Versões anteriores à 2.7.2.3 poderão ter problemas quando certos 
ficheiros são compilados com optimização, frequentemente devido a 
problemas relacionados com as gestôes dos cabeçalhos dos ficheiros. 
Actualmente o pgcc não trabalha com o Wine. A causa deste problema é 
desconhecida.

Claro que tambm precisas fazer "make" (geralmente como o GNU make).

Tu também necessitas do flex versao 2.5 ou superior e o yacc.
Bison irá trabalhar como substituição do yacc. Se estiveres a usar 
RedHat ou Debian, instala os pacotes do flex e do bison.

Para o processamento automático dos scripts de teste, tu também irás 
precisar do libperl "development header support" (pacote libperl-dev em 
Debian).

Para os requesitos no caso de tu quereres contruir a documentação, ve a 
secção "DOCUMENTAÇÃO".

4.COMPILAÇÃO

No caso de escolheres não usar wineinstall, corre os seguintes comandos 
para contruir o Wine:

./configure
make depend
make

Isto irá contruir o programa "wine" e numerosos suportes livraris/binarios.
O programa "wine" irá carregar e correr executaveis do Windows.
A livraria "libwine" ("winelib") pode ser usada para compilar e ligar 
Windows source code sob o Unix.

Para ver as opções de compilação da configuração, faz ./configure -help.

Para fazeres o upgrade de uma nova versão atravez de um ficheiro patch, 
primeiro cd para a directoria top da distribuição (a que contem este 
ficheiro README). A seguir faz um "make clean", e faz o patch da 
distribuição com:

	gunzip -c patch-file | patch -p1

onde "patch-file" é o nome do ficheiro patch ( qualquer coisa como 
Wine.yymmdd.diff.gz). Tu podes entao correr fazendo "./configure", e 
depois corre "make depend && make"

5.SETUP

Uma vez o Wine contruido correctamente, tu podes entao fazer o "make 
install"; isto irá instalar o wine executavel, o Wine man page, e alguns 
outros ficheiros necessários.

Não esquecer de primeiro desinstalar qualquer previo conflito relativo a 
instalação do Wine.
Tenta outro "dpkg -r wine" ou "rpm -e wine" ou "make uninstall" antes de 
installar.

O Wine requer um ficheiro de configuração chamado "config" na directoria 
-/.wine. O formato deste ficheiro é explicado no ficheiro config man 
page (documentation/wine.conf.man).
O ficheiro documentation/samples/config contém um exemplo de ficheiro de 
configuraçao o qual tem que ser adaptado e copiado para a localização 
mencionada em cima.

Ver http://www.winehq.com/support/ para mais informação sobre a 
configuraçao.

No caso da livraria carregar erros (e.g. "Error while loading shared 
libraries: libntdll.so"), tem a certeza de adicionar o caminho da 
livraria para /etc/ld.so.conf e correr ldconfig como root.

Para verificar a correcção do ambiente, tu precisas para que o Wine 
corra com sucesso, tu podes correr "./tools/winecheck | less".
Tu irás obter uma percentagem do resultado indicando "Wine configuration 
correctness".
Como este programa é alpha, ainda não correu um verdadeiro e exaustivo 
teste, onde, então deve ser levado apenas como um primeiro passo de 
verificação.

Ver wine.confman page, como se muda apenas para o suporte em modo texto 
se desejado.

6.CORRER PROGRAMAS

Quando e invoca o Wine, tens que especificar o caminho (patch) complecto 
do executavel, ou apenas o nome do ficheiro.

Por exemplo:  para correr o Solitário:
	wine sol			(usando o searchpatch para lozalizar o ficheiro)
	wine sol.exe

	wine c:\\windows\\sol.exe	(usando um nome de ficheiro DOS)

	wine /usr/windows/sol.exe	(usando um nome de ficheiro Unix)

Nota: o caminho do ficheiro também irá ser adicionado ao caminho(patch) 
quando um nome complecto é fornecido na linha de comando.

O Wine ainda não está complecto.então poderão vários programas 
quebrar(crash). Providenciamos-te bem para que o winedbg esteja 
correctamente e de acordo com a documentation/debugger.sgml, sera-te 
dado um detector de erros (debugger) para que possas investigar e 
corrigir os problemas.
Para mais informação como em fazer isto ou aquilo, por favor lê o 
ficheiro documentation/debugging.sgml.

Tu deves fazer um backup de todos os teus ficheiros importantes em que 
destes acesso ao Wine, ou usa uma especial cópia deles.tem havido casos 
de certos users que têm feito relatos de ficheiros corronpidos. Não 
corrar o Explorer, por exemplo, se não tiveres um backup próprio, que 
por vezes renomeia e estraga algumas directorias. Nem todos os MS apps 
como o e.g. Messenger são seguros, ao correrem o Explorer de alguma 
maneira. Este caso particular de corrupeçao (!$!$!$!$.pfr) podem ao 
menos parcialmente podem ser corrigidos usando
http://home.nexgo.de/andi.mohr/download/decorrupt_explorer

7.DOCUMENTAÇÃO

Alguma documentação (vários giuas de Wineetc.) podem ser encontrados na 
directoria documentation/ (aparte de também estar disponível em WineHQ).

Se quiseres lá processar ficheiros SGML, então podes correr "make doc" 
na directoria documentation/
Fazer isto requer que os pacotes das ferramentas sgml (para db2html, 
db2ps, db2pdf) chamados:
Debian:		docbook-utils
Mandrake: 		sgml-tools-A.B.C-DDmdk
SuSe:		docbktls-A.BB.C-DD

8.ARRANJAR MAIS INFORMAÇÃO

www:	Uma grande quantidade de informação acerca do Wine está disponivel 
        pelo WineHQ em http://www.winehq.com/ : varios guias Wine, base de  
        dados de aplicações, localizaçao de erros. Isto é provavelmente o 
        melhor ponto de começo.

FAQ:	A Wine FAQ está localizada em http://www.winehq.com/FAQ

Usenet:	Tu podes discutor tópicos relacionados de Wine e obter ajuda em
	comp.emulators.ms-windows.wine.

IRC:	Ajuda online está disponivel em #WineHQ on irc.freenode.net.


CVS:	O currente desenvolvimento do Wine está disponivel por CVS.
	Vai a http://www.winehq.com/cvs para mais informação.

Mailing Lists:
	Há algumas mailing list para responsaveis pelo desenvolvimento Wine; ver em
	http://www.winehq.com/forums para mais informação.

Se tu acrescentaste algo,ou corrigiste um bug, por favor envia um patch 
(em 'diff -u' format) para wine-patches_at_winehq.com lista para inclusão 
no próximo lançamento.