wine/documentation
Chris Morgan 29623c2e6b Remove references to winecheck from the documentation and insert a
TODO that  mentions that the functionality is to be moved into
winecfg.
2004-03-29 23:07:39 +00:00
..
samples Rewrote handling of COM and LPT devices to use symlinks in 2004-03-20 02:28:51 +00:00
.cvsignore Build the HTML documents as one big file. 2003-09-19 00:10:02 +00:00
architecture.sgml Remove obsolete info about the service thread. 2003-09-22 19:35:03 +00:00
bugs.sgml Remove references to winecheck from the documentation and insert a 2004-03-29 23:07:39 +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 Remove references to winecheck from the documentation and insert a 2004-03-29 23:07:39 +00:00
consoles.sgml Cleanup formatting a bit. 2003-09-22 19:36:10 +00:00
cvs-regression.sgml Make the winehq.org domain the official one. 2003-11-26 03:55:01 +00:00
ddraw.sgml Added missing para tag. 2004-03-22 20:40:23 +00:00
debugger.sgml - get rid of winedbg internal channels for output 2003-12-15 19:53:08 +00:00
debugging.sgml Some spelling fixes. 2003-09-29 20:20:53 +00:00
documentation.sgml Make the winehq.org domain the official one. 2003-11-26 03:55:01 +00:00
faq.sgml A few updates. 2004-03-16 01:17:45 +00:00
fonts.sgml Move keyboard programming instructions to the Devel Guide. 2004-01-30 22:58:26 +00:00
getting.sgml Fix location of the FreeBSD port (thanks to lazybones). 2004-02-13 20:21:12 +00:00
glossary.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
i18n.sgml Rewrite the i18n section. 2003-09-22 19:34:48 +00:00
implementation.sgml Move keyboard programming instructions to the Devel Guide. 2004-01-30 22:58:26 +00:00
installing.sgml Assorted spelling and case fixes. 2004-02-09 22:07:42 +00:00
introduction.sgml Make the winehq.org domain the official one. 2003-11-26 03:55:01 +00:00
Makefile.in Convert ddraw.txt to ddraw.sgml and add it to the wine-devel 2004-03-20 19:23:56 +00:00
multimedia.sgml Documentation updates. 2003-09-22 21:15:12 +00:00
ole.sgml Trivial cleanups to the OLE section. 2003-09-22 19:35:14 +00:00
opengl.sgml Remove obsolete section about thread-safety. 2004-01-27 20:10:27 +00:00
PACKAGING Make the winehq.org domain the official one. 2003-11-26 03:55:01 +00:00
patches.sgml Small cleanups on how to send in patches. 2003-09-22 19:34:07 +00:00
porting.sgml Cleanup the introduction a bit. 2003-09-22 19:35:58 +00:00
printing.sgml Move keyboard programming instructions to the Devel Guide. 2004-01-30 22:58:26 +00:00
README.de Require bison to compile Wine. 2004-03-16 03:11:39 +00:00
README.fr Require bison to compile Wine. 2004-03-16 03:11:39 +00:00
README.it Require bison to compile Wine. 2004-03-16 03:11:39 +00:00
README.pt Require bison to compile Wine. 2004-03-16 03:11:39 +00:00
README.pt_br Require bison to compile Wine. 2004-03-16 03:11:39 +00:00
registry.sgml Move keyboard programming instructions to the Devel Guide. 2004-01-30 22:58:26 +00:00
running.sgml Remove reference to Calmira file manager, add bit about Winefile. 2004-02-20 01:09:49 +00:00
testing.sgml Document building tests with MinGW. 2004-02-26 05:30:15 +00:00
wine-devel.sgml Convert ddraw.txt to ddraw.sgml and add it to the wine-devel 2004-03-20 19:23:56 +00:00
wine-faq.sgml Small cleanups, remove references to authors.ent. 2003-09-24 05:11:51 +00:00
wine-user.sgml Small cleanups, remove references to authors.ent. 2003-09-24 05:11:51 +00:00
wine.conf.man Rewrote handling of COM and LPT devices to use symlinks in 2004-03-20 02:28:51 +00:00
wine.man.in Get rid of the WINEOPTIONS variable and instead use WINEDEBUG to 2004-03-11 23:22:29 +00:00
winelib-bindlls.sgml Remove a bunch of dummy and/or obsolete info from the Winelib 2004-01-28 20:07:59 +00:00
winelib-intro.sgml Make the winehq.org domain the official one. 2003-11-26 03:55:01 +00:00
winelib-mfc.sgml Remove a bunch of dummy and/or obsolete info from the Winelib 2004-01-28 20:07:59 +00:00
winelib-porting.sgml Remove a bunch of dummy and/or obsolete info from the Winelib 2004-01-28 20:07:59 +00:00
winelib-toolkit.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
winelib-user.sgml Remove a bunch of dummy and/or obsolete info from the Winelib 2004-01-28 20:07:59 +00:00

1. INTRODUÇÃO

Wine é um programa que permite executar programas Microsoft Windows 
(incluindo executáveis DOS, Windows 3.x e Win32) no Unix.
Constituído de um programa carregador (loader) que carrega e executa 
um binário Microsoft Windows, e uma biblioteca (chamada Winelib) que 
implementa chamdas da API do Windows usando o equivalentes do Unix 
ou do X11. A biblioteca também pode ser usada para portar código 
Win32 em executáveis nativos Unix.

Wine é software livre, liberado segundo a GNU LGPL; veja o arquivo 
LICENÇA para detalhes.

2.ÍNICIO RÁPIDO

Sempre que se compila os fontes, é recomendado usar o Wine Installer 
para construir e instalar o Wine. Estando no diretório de mais alto
nível do fonte do Wine (que contém este arquivo), execute:

./tools/wineinstall

Execute programas conforme "wine [opções] programa". Para maiores 
informações e resolução de problemas, leia o restante deste arquivo, 
a página "man" do Wine (man wine), os arquivos incluídos no diretório 
de documentação do fonte do Wine (veja "DOCUMENTATION"), e especialmente 
a abundância de informação encontrada em http://www.winehq.org.

3.REQUERIMENTOS

Para compilar e executaro Wine, você deve ter o seguinte:

		Linux versão 2.0.36 ou superior
		FreeBSD 4.x ou FreeBSD 5-CURRENT ou posterior
		Solaris x86 2.5 ou posterior
		NetBSD-current

Como o Wine requer suport a tarefas a nível de kernel para executar, 
somente os sistemas operacionais acima mencionados são suportados.
Outros sistemas operacionais que suportarem tarefas do kernel poderão 
ter suporte no futuro.

Informações para o Linux:
Enquanto o Linux 2.2.x deve continuar em uso e Linux 2.0.x poderá
continuar em uso (versões antigas 2.0.x mal funcionamento relacionados a
tarefas), será muito melhor ter um kernel mais atualizado como 2.4.x.

Informações para o FreeBSD:
Certifique-se de ter as opções USER_LDT, SYSVSHM, SYSVSEM; e SYSVMSG, 
ligadas ao kernel. Mais informações encontram-se em: 
ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/

Informações para o Solaris:
Você provavelmente necessitará construir o Wine com as ferramentas GNU 
(gcc, gas, etc.). Aviso: instalar gas NÂO assegura que será usado pelo 
gcc. Recompilar o gcc depois de instalar o gas ou criar uma ligação ao cc, as e 
ld para as ferramentas gnu é dito ser necessário.

Informações para o NetBSD:
Certifique-se ter as opções USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG 
ligadas ao kernel.


Sistema de arquivo suportados:
O Wine deverá executar na maioria dos sistema de arquivo. Contudo, o Wine falha 
ao iniciar se umsdos for usado para o diretório /tmp. Alguns problemas de 
compatibilidade foram relatados acessando arquivos usando o Samba. Também, 
como o NTFS apenas pode ser usado seguramente com acesso de somente leitura por
enquanto, somos contrários ao uso do NTFS, pois os programas Windows precisam de 
acesso à escrita em quase tudo.
No caso de arquivos NTFS, copie-os em um local em que se possa escrever.

Requisitos básicos:
Você necessita ter instalados os arquivos de inclusão para desenvolvimento em X11
(called xlib6g-dev no Debian e XFree86-devel no RedHat).

Requisitos para as ferramentas de construção:
Em sistemas x86 o gcc >= 2.7.2 é requerido.
Versões anteriores à 2.7.2.3 poderão ter problemas quando certos arquivos são 
compilados com optimização, frequentemente devido a problemas gerenciamento de 
arquivos de cabeçalho. Atualmente o pgcc não trabalha com o Wine. A causa deste 
problema é desconhecida.

Naturalmente que necessita do "make" (comumente o GNU make).

Tamném precisa do flex versão 2.5 ou posterior e do bison.
Se estiver usando RedHat ou Debian, instale os pacotes do flex e do bison.

Bibliotecas de suporte opcionais:
Se desejar o suporte de impressão do CUPS, por favor instale os pacotes
cups e cups-devel.

Para o processamento automático dos scripts de teste, também precisará
do suporte a cabeçalhos do libperl (pacote libperl-dev no Debian).

Para os requesitos no caso de ter a intenção de contruir a documentação, veja 
a seção "DOCUMENTAÇÃO".

4.COMPILAÇÃO

No caso de escolher não usar o wineinstall, execute os comandos a seguir
para construir o Wine:

./configure
make depend
make

Isto construirá o programa "wine" e suporte a várias bibliotecas/binários.
O programa "wine" carregará e executará executáveis do Windows.
A biblioteca "libwine" ("winelib") pode ser usada para compilar e ligar 
código-fonte do Windows sob o Unix.

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

Para atualizar para uma nova distribuição usando arquivos de remendo (patch),
primeiro mude para o diretório de mais alto nível da distribuição (que 
contém o arquivo README). A seguir faça um "make clean", e remende a 
distribuição com:

	gunzip -c patch-file | patch -p1

onde "patch-file" é o nome do arquivo de remendo patch (algo como
Wine.aammdd.diff.gz). Pode então reexecutar "./configure", e depois 
executar "make depend && make"

5.CONFIGURAÇÃO

Uma vez que o Wine esteja construído corretamente, você pode executar
"make install"; assim irá instalar o executável do wine, as páginas 
"man" do Wine, e alguns outros arquivos necessários.

Não esqueça de desinstalar primeiramente qualquer instalação prévia do 
Wine que possa confitante. Tente qualquer um dos comandos "dpkg -r wine" ou "rpm -e wine" ou "make uninstall" antes de 
instalar.

Se você quiser ler a documentação fornecida com a fonte do Wine, 
veja a seção "DOCUMENTAÇÃO".

O Wine requer um arquivo de configuração chamado "config" no diretório 
~/.wine. O formato deste arquivo é explicado em "man wine.conf"
(documentation/wine.conf.man).
O arquivo documentation/samples/config contém um exemplo de arquivo de 
configuração para ser adaptado e copiado para a localização anteriormente
mencionada.

Não se esqueça de adicionar entradas vitais no registro, aplicando 
winedefault.reg com programs/regedit/. Veja o diretório documentation/ 
para detalhes.

Veja a área de suporte em http://www.winehq.org/ para mais sugestões 
sobre a configuraçao.

No caso de erros de carga da biblioteca
(ex: "Error while loading shared libraries: libntdll.so"), certifique-se
de adicionar o caminho da biblioteca a /etc/ld.so.conf e executar
ldconfig como root.

A fim verificar a exatidão do ambiente que você necessita para que o 
Wine funcione com sucesso, você pode executar "./tools/winecheck | less".
Você irá obter um percentual do resultado indicando "Wine configuration 
correctness".
Como este programa é alfa, não rodou um teste verdadeiramente completo ainda,
embora, assim deve ser feito como uma primeira etapa da verificação somente. 

Veja em "man wine.conf" como se muda para o suporte em modo texto se desejar.

6.EXECUTAR PROGRAMAS

Ao invocar o Wine, você pode especificar o caminho completo do executável,
ou somente um nome de arquivo.

Por exemplo:  para executar a Paciência:
	wine sol			(usando o caminho de pesquisa como
	wine sol.exe                     especificado no arquivo config)

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

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

        wine -- sol.exe /parameter1 -parameter2 parameter3
				   (chamando o programa com parãmetros)

Nota: o caminho do arquivo será também adicionado ao caminho 
quando um nome completo for fornecido na linha de comando.

O Wine ainda não está completo, então vários programas poderão funcionar mal.
Desde que você ajuste corretamente o winedbg de acordo com o arquivo
documentation/debugger.sgml, você irá entrar no depurador de modo que possa 
investigar e reparar o problema. Para mais informação como fazer isto, por favor
leia o arquivo documentation/debugging.sgml.

Você deve fazer uma cópia de segurança de todos os seus arquivos importantes
que o Wine possa acessar, ou usar uma cópia especial deles com o Wine, pois 
houveram alguns casos de corrupção de arquivos reportados por usuários. NÃO 
execute o Explorer, por exemplo, se você não tiver um cópia de segurança 
apropriada, como ele renomeia/cripples diversos diretórios às vezes. Mesmo 
executar outros aplicativos MS tais como por exemplo o Messenger é seguro,
porque carrega o Explorer de algum modo. Este corrupção em particular 
(!$!$!$!$.pfr) pode ao menos parcialmente ser reparado usando 
http://home.nexgo.de/andi.mohr/download/decorrupt_explorer 

7. DOCUMENTAÇÃO

Alguma documentação (vários guias do Wine, etc.) podem ser encontrados no
diretório documentation/ (apesar de também estar disponível em WineHQ).

Se quizer processar arquivos SGML que lá estão, então execute "make doc" 
no diretório documentation/.
Fazer isto requer que os pacotes das ditas ferramentas sgml (para db2html, 
db2ps, db2pdf):
Debian:		docbook-utils
Mandrake: 	sgml-tools-A.B.C-DDmdk
SuSE:		docbktls-A.BB.C-DD

8. OBTENDO MAIS INFORMAÇÃO

WWW:	Uma grande quantidade de informação sobre o Wine está disponivel 
        pelo WineHQ em http://www.winehq.org/ : vários guias do Wine,
	base de dados de aplicações, rastreamento de erros. Este é 
	provavelmente o melhor ponto para começar.

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

Usenet:	Pode-se discutir tópicos relacionados ao Wine e obter ajuda em
	comp.emulators.ms-windows.wine.

Bugs:	Relate erros ao Wine Bugzilla em http://bugs.winehq.org
	Por favor pesquise a base de dados do bugzilla para verificar se 
	seu problema já tenha sido encontrado, antes de enviar um 
	relatório do erro. Você pode também afixar relatórios do erro em
	comp.emulators.ms-windows.wine. Por favor leia o arquivo 
	documentation/bugs.sgml para ver qual informação é requerida. 

IRC:	A ajuda online está disponível em #WineHQ em irc.freenode.net.

CVS:	O árvore de desenvolvimento atual do Wine está disponível por CVS.
	Vá em http://www.winehq.org/cvs para mais informação.

Mailing Lists:
	Há diversas listas de mensagens para colaboradores no desenvolvimento 
	do Wine; veja http://www.winehq.org/forums para mais informação.

Se você adicionar algo, ou reparar um erro, envie por favor um remendo
(no formato 'diff -u') à lista wine-patches@winehq.org para inclusão na 
próxima distribuição.

--
Alexandre Julliard
julliard@winehq.org

--
Tradução para Português do Brasil: Marcelo Duarte