wine/documentation
Alexandre Julliard 1de20ae4af Rewrote handling of COM and LPT devices to use symlinks in
$WINEPREFIX/dosdevices, with suitable defaults if the symlinks are
missing.
Rewrote QueryDosDevice and DefineDosDevice to use the new scheme.
Added temporary code to create the symlinks based on the contents of
the config file.
2004-03-20 02:28:51 +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 Assorted spelling and case fixes. 2004-02-09 22:07:42 +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 Tips for using native MS SQL ODBC drivers. 2004-03-15 20:11:11 +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.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 - 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 Remove a bunch of dummy and/or obsolete info from the Winelib 2004-01-28 20:07:59 +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 Merge the non-obsolete bits from wine.texinfo into the Wine Developers 2003-09-25 23:48:39 +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