wine/documentation
Alexandre Julliard c3116c5e61 Renamed ttydrv and x11drv to winetty.drv and winex11.drv respectively
to follow the namespace conventions and make it clear that they are
drivers and not dlls.
Moved the graphics driver configuration to HKLM\Software\Wine\Drivers.
2005-05-06 19:38:50 +00:00
..
samples Renamed ttydrv and x11drv to winetty.drv and winex11.drv respectively 2005-05-06 19:38:50 +00:00
.cvsignore Build the HTML documents as one big file. 2003-09-19 00:10:02 +00:00
address-space.sgml Updated the documentation on Wine architecture & fundamentals. 2004-06-02 00:34:32 +00:00
architecture.sgml - Using uniform DocBook tags for DLLs, commands, environment vars... 2005-04-18 09:53:39 +00:00
bugs.sgml Assorted spelling fixes. 2004-04-28 00:24:44 +00:00
ChangeLog.OLD Moved old ChangeLog to documentation/ChangeLog.OLD. 1998-10-18 16:34:50 +00:00
configuring.sgml Assorted spelling fixes. 2005-05-06 15:44:31 +00:00
ddraw.sgml Added missing para tag. 2004-03-22 20:40:23 +00:00
debugger.sgml Minor cleanups. 2005-04-18 09:53:02 +00:00
debugging.sgml Assorted spelling fixes. 2005-05-06 15:44:31 +00:00
documentation.sgml Prefer W to A for documentation. Prefer the non-inlined style of 2005-01-06 19:40:19 +00:00
faq.sgml Shorten the id of the question to avoid jade error. 2005-02-24 19:38:32 +00:00
fonts.sgml Fix a broken link. 2005-02-01 14:21:21 +00:00
getting.sgml Fix a link to Wine's HowTo. 2005-03-16 11:28:01 +00:00
glossary.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
introduction.sgml User Guide Chapter 2 rewrite. 2005-02-11 12:17:34 +00:00
Makefile.in User Guide Chapter 2 rewrite. 2005-02-11 12:17:34 +00:00
multimedia.sgml - bring the multimedia doc up-to-date 2004-10-11 19:57:10 +00:00
ole.sgml Assorted spelling fixes. 2005-04-19 09:49:38 +00:00
opengl.sgml Assorted spelling fixes. 2005-05-06 15:44:31 +00:00
PACKAGING Removed whitespace at end of lines, updated a bit. 2005-01-04 11:57:21 +00:00
patches.sgml Suggest testing patches in a gentler way. 2005-01-14 15:14:09 +00:00
printing.sgml Remove references to debugmsg and winedefault.reg. 2004-07-21 21:20:07 +00:00
README.de Keep all REAMDEs in sync. 2005-01-04 11:51:52 +00:00
README.es Added Spanish translation. 2005-01-03 14:45:36 +00:00
README.fr Keep all REAMDEs in sync. 2005-01-04 11:51:52 +00:00
README.it Keep all REAMDEs in sync. 2005-01-04 11:51:52 +00:00
README.pt Update README for Pt_br and Pt. 2005-02-14 11:51:05 +00:00
README.pt_br Update README for Pt_br and Pt. 2005-02-14 11:51:05 +00:00
registry.sgml Remove references to debugmsg and winedefault.reg. 2004-07-21 21:20:07 +00:00
running.sgml Assorted spelling fixes. 2004-12-20 19:27:06 +00:00
testing.sgml Downloading the platform sdk doesn't require IE any more. 2004-11-02 19:26:42 +00:00
wine-devel.sgml Hide authors, we don't know how to format them. 2005-01-04 11:53:17 +00:00
wine-faq.sgml Small cleanups, remove references to authors.ent. 2003-09-24 05:11:51 +00:00
wine-user.sgml User Guide Chapter 2 rewrite. 2005-02-11 12:17:34 +00:00
wine.conf.man Get rid of the remaining registry configuration parameters. 2005-03-14 17:18:40 +00:00
wine.man.in wineclipsrv is no longer used, remove it. 2004-09-01 01:40:57 +00:00
winedev-coding.sgml Assorted spelling fixes. 2005-05-06 15:44:31 +00:00
winedev-graphical.sgml Reorganizing wine-devel: 2004-10-26 22:45:47 +00:00
winedev-kernel.sgml - Using uniform DocBook tags for DLLs, commands, environment vars... 2005-04-18 09:53:39 +00:00
winedev-otherdebug.sgml Assorted spelling fixes. 2005-05-06 15:44:31 +00:00
winedev-windowing.sgml Reorganizing wine-devel: 2004-10-26 22:45:47 +00:00
winelib-bindlls.sgml Remove references to ./configure and Makefile.in files. 2004-12-14 11:42:30 +00:00
winelib-intro.sgml Remove references to ./configure and Makefile.in files. 2004-12-14 11:42:30 +00:00
winelib-mfc.sgml Assorted spelling fixes. 2005-05-06 15:44:31 +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 Remove references to ./configure and Makefile.in files. 2004-12-14 11:42:30 +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 5.3 ou posterior
		Solaris x86 2.5 ou posterior
		NetBSD-current

Como o Wine requer suporte 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 continuar em uso e Linux 2.0.x talvez continue
em uso (versões 2.0.x antigas tem mal funcionamento relacionados a
tarefas), será muito melhor ter um kernel mais atualizado como 2.4.x.

Informações para o FreeBSD:
Wine deve compilar no FreeBSD 4.x e FreeBSD 5.x, mas versões anteriores
a FreeBSD 5.3 geralmente não funcionam corretamente.

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).

També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 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.

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.

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