/
README.pt-BR
192 lines (125 loc) · 5.88 KB
/
README.pt-BR
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
Este é o Parrot, versão 2.10.1
------------------------------
Parrot Copyright (C) 2001-2010, Parrot Foundation.
INFORMAÇÕES SOBRE A LICENÇA
---------------------------
Este código é distribuído através dos termos da Licença Artística 2.0.
Para mais detalhes, veja o texto completo da licença no arquivo LICENSE.
RESUMO
------
Parrot é uma máquina virtual desenhada para compilar e executar de
maneira eficiente bytecode para linguagens dinâmicas.
PRÉ-REQUISITOS
--------------
Você vai precisar de um compilador de C, um ligador (linker) e, é claro,
um programa de "make".
Se você for usar a biblioteca ICU você vai precisar fazer o download e
a instalação antes de configurar o Parrot. A biblioteca está disponível
através do site http://site.icu-project.org/download.
Você também vai precisar do Perl 5.8.4 ou mais novo, e do Storable 2.12 ou
mais novo para executar os scripts de configuração e de compilação.
Para a maioria das plataformas que nós damos suporte, Parrot consegue ser
compilado sem a necessidade de pacotes adicionais. docs/parrot.pod contém
uma lista com estas plataformas. O arquivo PLATFORMS dispõe de relatórios
sobre as plataformas a qual o Parrot já foi compilado e testado.
COMO INSTALAR O PARROT PELO GITHUB
----------------------------------
I. Instalando o Git.
Linux:
Esta etapa depende da sua distribuição. Para instalar pacotes você deve
executar os comandos como "root" (ou através do comando "sudo"):
No Ubuntu/Debian (baseado no apt):
apt-get install git-core
No Red Hat, Fedora (baseado em rpm):
yum install git
No Gentoo (portage):
emerge -av dev-vcs/git
Windows:
Existe 2 versões de compatibilidade do Git no Windows:
msysgit http://code.google.com/p/msysgit/downloads/list
TortoiseGit http://code.google.com/p/tortoisegit/downloads/list
Macintosh OS X:
Uma busca na Internet irá resultar em uma varidade de instaladores do
Git para o Mac OS X, incluíndo este:
http://help.github.com/mac-git-installation/
II. Obtendo o Parrot pelo github.com
Para obter uma cópia do repositório Git do Parrot:
git clone git://github.com/parrot/parrot.git
Por padrão, apenas a "branch" "master" é baixada. Para criar um "branch"
local que que siga o curso da branch "some_branch":
git checkout -b --track some_branch origin/some_branch
Todas as URLs acima são apenas para leitura. Se você é um desenvolvedor
do núcleo do Parrot você deve usar a URL com permissão de escrita:
git clone git@github.com:parrot/parrot.git
Uma lista com todos os "branches" pode ser encontrada em
http://github.com/parrot/parrot
INSTRUÇÕES
----------
Se você baixou uma versão compactada do Parrot você vai precisar
descompactar o pacote antes de prosseguir. Em seguida, entre na
pasta do Parrot e execute o seguinte comando
perl Configure.pl
para rodar o script de configuração. Este script extrai a configuração
do perl5 que está sendo executado. Pode ser que você precise mostrar
explicitamente ao Configure.pl qual compilador e qual ligador (linker)
você deseja usar. Por exemplo, para compilar os arquivos em C com o "cc",
os arquivos em C++ com o "CC" e ligar tudo com o "CC", basta executar o
script da seguinte forma:
perl Configure.pl --cc=cc --link=CC --ld=CC
Consulte "perl Configure.pl --help" para mais informações e
docs/configuration.pod para mais detalhes.
Para sistemas como o HPUX, que não contém o inet_pton, execute
perl Configure.pl --define=inet_aton
O Configure.pl irá gerar o cabeçalho config.h, o módulo Parrot::Config,
arquivos específicos da plataforma e vários arquivos "Makefile".
O arquivo "myconfig" contém um resumo com todas as opções de configuração.
A seguir, execute o comando "make". Configure.pl irá reportar qual a
versão do make que ele recomenda ao seu sistema.
Agora o interpretador será compilado. Se você está compilando a
biblioteca ICU (padrão na maioria dos sistemas), você vai precisar
do GNU make (ou algo compatível com ele).
Você pode testar o Parrot através do comando "make test". Também é
possível rodar os testes em paralelo, executando "make TEST_JOBS=3 test".
Para rodar a suíte completa de testes, execute:
make fulltest
Nota: o arquivo PLATFORMS contém notas sobre falhas esperadas nos testes
de acordo com os diferentes sistemas.
Para instalar o Parrot:
make install
Por padrão ele será instalado em /usr/local, com os executáveis em
/usr/local/bin. Se você quer instalar Parrot em alguum outro lugar, use:
perl Configure.pl --prefix=/home/joe/bird
make install
Mas por favor, note que as bibliotecas dinâmicas não serão encontradas
nos lugares não convencionais, ao menos que você as inclua no
LD_LIBRARY_PATH ou similar.
Leia o docs/parrot.pod e docs/intro.pod para saber onde ir a partir
daqui. Se você encontrar algum problema, olhe a seção "How To Submit
A Bug Report" em docs/submissions.pod. Esses documentos estão no formato
POD. Você pode os ler através do comando:
perldoc -F docs/intro.pod
ATUALIZAÇÕES
------------
Para documentação sobre as mudanças visíveis aos usuários ao longo
das diferentes versões, por favor confira o arquivo NEWS.
LISTAS DE EMAIL
---------------
A lista de usuários do Parrot é parrot-users@lists.parrot.org.
Subscreva-se preenchendo o formulário em
http://lists.parrot.org/mailman/listinfo/parrot-users. A lista é
arquivada em http://lists.parrot.org/pipermail/parrot-users/.
Para discussões sobre desenvolvimento, confira o arquivo
docs/gettingstarted.pod.
FEEDBACK, PATCHES, etc.
-----------------------
Dê uma olhada em docs/submissions.pod para mais informações sobre
como reportar bugs e submeter patches.
WEB SITES
---------
Os seguintes sites contém todas as informações que você precisa saber
sobre Parrot.
http://www.parrot.org/
http://docs.parrot.org/
https://github.com/parrot/parrot/
Se divirta,
A equipe do Parrot.