Sweden-Number/documentation
Francois Gouget 0d574d435d Fix/make the case of Bochs and Plex86 more consistent.
Add CodeWeavers to the list of contributors (currently hosts WineHQ).
Tweak the 'how to submit patches' FAQ.
Add Kylix and MusicMatch JukeBox to the list of applications ported
using Wine(lib).
2003-08-22 05:28:21 +00:00
..
samples Replaced remaining calls to PROFILE_GetWineIniString/Bool by direct 2003-08-19 03:21:04 +00:00
status Typos/spelling fixes. 2003-06-18 03:30:39 +00:00
.cvsignore Name all sections of type sect1. 2003-07-21 22:13:19 +00:00
ChangeLog.OLD Moved old ChangeLog to documentation/ChangeLog.OLD. 1998-10-18 16:34:50 +00:00
HOWTO-winelib Typos/spelling fixes. 2003-06-18 03:30:39 +00:00
Makefile.in Make sure to return an error if the file generation fails. 2003-06-23 19:51:21 +00:00
PACKAGING 'grep -q' is not portable -> don't use it. 2003-07-30 03:43:55 +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
README.pt_br Localization to Portuguese of Brazil of README file. 2003-06-30 20:20:16 +00:00
architecture.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
authors.ent The begining of a "building wine" documentation. More detailed 2003-07-09 02:50:59 +00:00
bugs.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
build.sgml Fixed typos. 2003-07-11 03:49:53 +00:00
compiling.sgml Remove the generation of all documentation in one document. 2003-04-19 02:50:57 +00:00
configuring.sgml Remove from docs / config tool useless / obsoleted options. 2003-08-15 03:50:48 +00:00
consoles.sgml Name all sections of type sect1. 2003-07-21 22:13:19 +00:00
cvs-regression.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
cvs.sgml Name all sections of type sect1. 2003-07-21 22:13:19 +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 Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
debugging.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
default.dsl Documentation update. 2000-12-13 21:52:37 +00:00
dlls.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
documentation.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
faq.sgml Fix/make the case of Bochs and Plex86 more consistent. 2003-08-22 05:28:21 +00:00
fonts.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
getting.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
glossary.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
gui Window style updates. 1999-07-03 12:06:26 +00:00
i18n.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
implementation.sgml Spelling and URL fixes. 2003-07-09 19:50:14 +00:00
installation-und-konfiguration.german Remove from docs / config tool useless / obsoleted options. 2003-08-15 03:50:48 +00:00
installing.sgml Begin to uniformize sample commands in documentation. 2003-07-21 22:23:38 +00:00
introduction.sgml Spelling and case fixes. 2003-08-18 20:11:29 +00:00
make_winehq Use the standard db2html instead of our db2html-winehq script. 2003-04-20 02:43:22 +00:00
multimedia.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
ole.sgml Revert bogus spelling "fix". 2003-07-21 20:04:16 +00:00
opengl.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
patches.sgml Spelling and URL fixes. 2003-07-09 19:50:14 +00:00
porting.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
print.dsl Better formatting for PDF output. 2001-09-26 23:02:31 +00:00
printing.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
registry.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
running.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
shell32 Typos/spelling fixes. 2003-06-18 03:30:39 +00:00
testing.sgml Spelling and URL fixes. 2003-07-09 19:50:14 +00:00
tools.sgml Spelling and URL fixes. 2003-07-09 19:50:14 +00:00
wine-devel.sgml The begining of a "building wine" documentation. More detailed 2003-07-09 02:50:59 +00:00
wine-doc.sgml Removed extra /book tag. 2003-07-15 20:54:39 +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 Spelling and URL fixes. 2003-07-09 19:50:14 +00:00
winelib-intro.sgml Name all sections of type sect1. 2003-07-21 22:13:19 +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 Spelling and URL fixes. 2003-07-09 19:50:14 +00:00
winelib-toolkit.sgml Fixed indentation of list items. 2003-07-21 22:42:50 +00:00
winelib-user.sgml - Split Winelib User Guide into smaller files for easier maintenance 2001-01-24 19:36:24 +00:00

README.pt_br

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

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 yacc.
O Bison funciona como um substituto do yacc. 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.com/ 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.com/ : 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.com/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.com
	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.com/cvs para mais informação.

Mailing Lists:
	Há diversas listas de mensagens para colaboradores no desenvolvimento 
	do Wine; veja http://www.winehq.com/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.com para inclusão na 
próxima distribuição.

--
Alexandre Julliard
julliard@winehq.com

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