wine/documentation
Dimitrie O. Paun f783cd0305 Prefer W to A for documentation. Prefer the non-inlined style of
documentation, it's the most commonly used one, we should standardize
on it.
2005-01-06 19:40:19 +00:00
..
samples Always clearAllSelections since not clearing CLIPBOARD can get us into 2005-01-04 20:34:46 +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 Reorganizing wine-devel: 2004-10-26 22:45:47 +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
compiling.sgml Augment the compiling documentatin with the actual commands. 2005-01-04 11:53:38 +00:00
configuring.sgml Updated the documentation telling to use the 2004-12-06 16:42:33 +00:00
ddraw.sgml Added missing para tag. 2004-03-22 20:40:23 +00:00
debugger.sgml - fixed regression in ctrl-c handling 2004-09-28 02:13:27 +00:00
debugging.sgml - all symbol information storage is now module relative, so we can 2004-06-04 00:59:16 +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 Updated the documentation telling to use the 2004-12-06 16:42:33 +00:00
fonts.sgml Move keyboard programming instructions to the Devel Guide. 2004-01-30 22:58:26 +00:00
getting.sgml Remove bashing of packages, value judgments. 2005-01-04 11:52:40 +00:00
glossary.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
installing.sgml Assorted spelling and case fixes. 2004-02-09 22:07:42 +00:00
introduction.sgml Fixed missing </sect2> tag. 2004-11-29 17:54:20 +00:00
Makefile.in Reorganizing wine-devel: 2004-10-26 22:45:47 +00:00
multimedia.sgml - bring the multimedia doc up-to-date 2004-10-11 19:57:10 +00:00
ole.sgml Add DCOM documentation to developers guide. 2004-07-29 02:39:37 +00:00
opengl.sgml Replace --debugmsg with WINEDEBUG. 2004-04-20 20:16:54 +00:00
PACKAGING Removed whitespace at end of lines, updated a bit. 2005-01-04 11:57:21 +00:00
patches.sgml Ask for link if patch is related to a bug in Bugzilla. 2004-10-05 04:12: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 Keep all REAMDEs in sync. 2005-01-04 11:51:52 +00:00
README.pt_br Keep all REAMDEs in sync. 2005-01-04 11:51:52 +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
threading.sgml Add documentation on the Wine initialization process. 2004-06-15 18:26:52 +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 Small cleanups, remove references to authors.ent. 2003-09-24 05:11:51 +00:00
wine.conf.man - Add info that the wine config file has/needs a header line. 2004-10-25 21:44:24 +00:00
wine.man.in wineclipsrv is no longer used, remove it. 2004-09-01 01:40:57 +00:00
winedev-coding.sgml Reorganizing wine-devel: 2004-10-26 22:45:47 +00:00
winedev-graphical.sgml Reorganizing wine-devel: 2004-10-26 22:45:47 +00:00
winedev-kernel.sgml Document how SEH works in Wine. 2004-11-04 21:06:14 +00:00
winedev-otherdebug.sgml Reorganizing wine-devel: 2004-10-26 22:45:47 +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 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 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 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 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