17/12/2010 15:05 +0400, M. Zaur wrote:
> About version of README, I downloaded  current supported release
> thats why I translated old version of file..  
> Anyway, I will translate last version with all given notes.

Ok, Zaur -- we made some corrections and changes in translated file for
synchronization with a current Git's README (see attach). I hope that
will be helpful to you.

> Also I plan to translate online docs , by my oppinion  it is more 
> important than READMEs included in sources pack, dont you think so? 

I think, translated online docs (especially for beginners) is more
important.

> P.S. Its first time I take part in opensource project, I dont know
> how to use message system ( for example what should be in  Subject
> line of a mail ? )

Subject must reflects the essence of message. "README.ru translation" is
not bad.

> 2010/12/17 Konovalov, Vadim (Vadim)** CTR **
> <[email protected]>
> 
>         Hi.
>         
>         attached was cp1251 and not UTF8, but this is matter of just
>         single "iconv" command, so no problem.
>         Subject line of a mail is also confusing.
>         
>         There are some problems with translation itself though.
>         
>         1),
>         it is immediately outdated - it says its about version 2.9.1,
>         and already existing READMEs for DE, PL and ES are against
>         2.10.1, which is obviously better, so there is missing a large
>         section about downloading parrot.
>         
>         2),
>         punctuation is seemingly random, and there are grammatic
>         errors also.
>         
>         3),
>         factual translation errors are here also "Perl 5.8.4 or newer,
>         and Storable 2.12 or newer" translated like it was "Perl 5.8.4
>         or older, and Storable 2.12 or older"
>         
>         Also, first 2 lines in Russian translation are fine, but DE,
>         ES and PL translation do not have those.
>         
>         All these errors are fixable though,
>         and I agree with opinion here that all translations should be
>         held separately - either in subdirectory, or elsewhere.
>         
>         Regards,
>         Vadim.
>         
>         ________________________________
>         
>                From: [email protected]
>         [mailto:[email protected]] On Behalf Of M.
>         Zaur
>                Sent: Friday, December 17, 2010 12:27 PM
>                To: [email protected]
>         
>                Subject: Re: parrot-dev Digest, Vol 28, Issue 22
>         
>         
>         
>                Oleg ,  Parrot, v 2.9.1 ,
>                in attachment UTF8 variant of translation
>         
>         
>         
>                
> 
> _______________________________________________
> http://lists.parrot.org/mailman/listinfo/parrot-dev
Это Parrot, версия 2.10.1
------------------------------

Права на Parrot (C) принадлежат  фонду Parrot 2001-2010.


ИНФОРМАЦИЯ О ЛИЦЕНЗИИ
-------------------

Этот исходный код распространяется на условиях Artistic License 2.0.
Для получения более подробных сведений вы можете прочесть полный текст лицензии в файле LICENSE.

ОПИСАНИЕ
--------
Parrot -- виртуальная машина, разработанная для эффективной компиляции и выполнения байт-кода для
языков с динамическими типами данных. 


СИСТЕМНЫЕ ТРЕБОВАНИЯ 
-------------

Для сборки Parrot требуется компилятор языка C, программа-компоновщик, и утилита make.

Если вы  планируете использование библиотеки ICU, вам необходимо скачать и установить 
ее до настройки Parrot. Скачать ICU вы можете по следующей ссылке: http://site.icu-project.org/download

Также необходим  Perl 5.8.4 или старше и Storable 2.12 или старше для выполнения различных
настроек и сборочных скриптов.

Для большинства изначально поддерживаемых платформ Parrot должен компилироваться 
без предварительного конфигурирования. Файл docs/parrot.pod содержит список базовых платформ.
В файле PLATFORMS дана информация о платформах, на которых Parrot был собран и протестирован.


КАК ПОЛУЧИТЬ PARROT С GITHUB
-----------------------------
I.  Установить Git.

Linux:
Метод зависит от дистрибутива. Для установки следует выполнить (от суперпользователя root
или через sudo <cmd>):

В Ubuntu/Debian (apt-based):

    apt-get install git-core

В Red Hat, Fedora (rpm-based):

    yum install git

В Gentoo (portage):

    emerge -av dev-vcs/git

Windows:
Два варианта Git для Windows:

msysgit 	    http://code.google.com/p/msysgit/downloads/list
TortoiseGit 	http://code.google.com/p/tortoisegit/downloads/list

Macintosh OS X:

Поиск в Интернете выдаст различные варианты инсталляторов git для Mac OS X,
включая такой:

    http://help.github.com/mac-git-installation/

II. Получение Parrot с github.com

Копирование Git-репозитория Parrot:

    git clone git://github.com/parrot/parrot.git


Checkout по умолчанию производится с мастер-веткой. Для создания локальной ветки с названием
"some_branch" выполните:

    git checkout -b --track some_branch origin/some_branch

Все указанные выше URL'и доступны только на чтение. Если вы входите в группу разработчиков Parrot,
используйте URL с возможностью записи:

    git clone [email protected]:parrot/parrot.git

Со списком веток можно ознакомиться на http://github.com/parrot/parrot


ИНСТРУКЦИИ
------------
После того как вы скачали и разархивировали архив с исходными файлами
выполните в каталоге с файлами следующую команду для запуска конфигурационного скрипта:

    perl Configure.pl


Скрипт Configure.pl для perl5 генерирует настройки для сборки. Вы можете дополнительно указать
конфигуратору, какой компилятор и компоновщик следует использовать. К примеру, для компиляции C
файлов программой 'cc',  C++ файлов программой 'CC' и компоновкой с помощью 'CC' необходимо
набрать :

    perl Configure.pl --cc=cc --cxx=CC --link=CC --ld=CC

Для получения дополнительной информации воспользуйтесь командой "perl Configure.pl --help" или
описанием docs/configuration.pod.

Для систем типа HPUX, которые не поддерживают inet_pton, следует выполнить

    perl Configure.pl --define=inet_aton

В результате запуска Configure.pl будут созданы заголовочный файл config.h, модуль Parrot::Config,
платформо-зависимые файлы, а также различные 'Make'-файлы.

Файл "myconfig" содержит обзор настроек конфигурации.

Следующим шагом является запуск команды make. (Конфигуратор Configure.pl подскажет, какая версия
make рекомендуется для вашей системы.)

Теперь следует собрать интерпретатор. Если вы производите сборку вместе с библиотекой
ICU (по умолчанию присутствует в большинстве систем), следует использовать GNU Make
(или что-либо совместимое).

Вы можете протестировать Parrot, выполнив "make test". Также вы можете выполнить тестирование 
параллельно с помощью "make TEST_JOBS=3 test".

Для выполнения полного набора тестов наберите команду

    make fulltest

Примечание: В файле PLATFORMS содержатся замечания касательно ожидаемых результатов тестов
на данной системе.

Установка Parret производится с помощью команды:

    make install

По умолчанию производится установка в каталог /usr/local с размещением исполняемого файла 
Parrot в каталог /usr/local/bin. Для установки Parrot в другой каталог используйте:

    perl Configure.pl --prefix=/home/joe/bird
    make install

Пожалуйста, учтите, что при установке в нестандартный каталог динамические библиотеки не будут
найдены до тех пор, пока не будут установлены необходимые значения в переменных окружения
(LD_LIBRARY_PATH и т.п.)

Для дальнейшей работы ознакомьтесь с файлами docs/parrot.pod и docs/intro.pod.
Если у вас возникли какие-либо проблемы, прочтите раздел "Как отправить отчет об ошибке" 
в файле docs/submissions.pod. Эти документы в POD формате, для того чтобы их просмотреть
выполните команду:

    perldoc -F docs/intro.pod


ИЗМЕНЕНИЯ
-------
	
Для ознакомления с изменениями пользовательского уровня между текущей и предыдущими версиями
смотрите раздел NEWS.


ПОЧТОВЫЕ РАССЫЛКИ
-------------

Parrot-рассылки для пользователей -- [email protected]. 
Для подписки на рассылку заполните форму на странице 
http://lists.parrot.org/mailman/listinfo/parrot-users.
Рассылки архивируются на странице: http://lists.parrot.org/pipermail/parrot-users/ .

Для обсуждений разработки смотрите информацию в файле docs/gettingstarted.pod.

ОТЗЫВЫ, ПАТЧИ и т.п.
-----------------------
В файле docs/submissions.pod вы найдете информацию касательно отзывов об ошибках
и исправлениях.

САЙТЫ В ИНТЕРНЕТЕ
---------
Следующие веб-сайты содержат всю необходимую информацию о Parrot:
    http://www.parrot.org/
    http://trac.parrot.org/
    http://docs.parrot.org/


Удачных экспериментов,
команда Parrot.
_______________________________________________
http://lists.parrot.org/mailman/listinfo/parrot-dev

Reply via email to