harmony-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From var...@apache.org
Subject svn commit: r630108 [3/4] - in /harmony/standard/site: ./ docs/ docs/documentation/ xdocs/ xdocs/documentation/ xdocs/stylesheets/
Date Fri, 22 Feb 2008 07:16:38 GMT
Modified: harmony/standard/site/docs/quickhelp_users.ru.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/quickhelp_users.ru.html?rev=630108&r1=630107&r2=630108&view=diff
==============================================================================
--- harmony/standard/site/docs/quickhelp_users.ru.html (original)
+++ harmony/standard/site/docs/quickhelp_users.ru.html Thu Feb 21 23:16:27 2008
@@ -66,9 +66,9 @@
                 
     <!-- ============================================================ -->
 
-                <p class="menuItem">General</p>
+                <p class="menuItem">Основные ссылки</p>
         <ul>
-                    <li class="menuItem">    <a href="./index.html">Home</a>
+                    <li class="menuItem">    <a href="./index.ru.html">Главная страница</a>
 </li>
            
                         
@@ -84,7 +84,7 @@
 </li>
            
                         
-                    <li class="menuItem">    <a href="./bundles.html">Bundles</a>
+                    <li class="menuItem">    <a href="./bundles.ru.html">Готовые решения ПО</a>
 </li>
            
                         
@@ -94,7 +94,7 @@
                         
         
         </ul>
-            <p class="menuItem">Community</p>
+            <p class="menuItem">Сообщество</p>
         <ul>
                     <li class="menuItem">    <a href="./get-involved.html">Get Involved</a>
 </li>
@@ -118,13 +118,13 @@
                         
         
         </ul>
-            <p class="menuItem">Development</p>
+            <p class="menuItem">Развитие проекта</p>
         <ul>
                     <li class="menuItem">    <a href="./svn.html">Source Code</a>
 </li>
            
                         
-                    <li class="menuItem">    <a href="./quickhelp_contributors.html">Getting Started</a>
+                    <li class="menuItem">    <a href="./quickhelp_contributors.ru.html">Инструкция разработчика</a>
 </li>
            
                         
@@ -142,7 +142,7 @@
                         
         
         </ul>
-            <p class="menuItem">Documentation</p>
+            <p class="menuItem">Документация</p>
         <ul>
                     <li class="menuItem">    <a href="./sitemap.html">Sitemap</a>
 </li>
@@ -170,7 +170,7 @@
                         
         
         </ul>
-            <p class="menuItem">Foundation</p>
+            <p class="menuItem">Организация Апачи</p>
         <ul>
                     <li class="menuItem">    <a href="http://apache.org">ASF</a>
 </li>
@@ -224,7 +224,7 @@
                         <p><strong>Linux</strong>: Запустите tar командой:</p>
                                 <pre>$ tar -tzf &lt;latest-harmony-jre-linux&gt;.tar.gz</pre>
                                 <p>Архив будет распакован в текущую директорию.</p>
-                                <p><strong>Windows</strong>: Ð?спользуйте любой архиватор для Windows, который
+                                <p><strong>Windows</strong>: Используйте любой архиватор для Windows, который
      обрабатывает zip файлы. Наиболее распространены следующие архиваторы:
     </p>
                                 <ul>
@@ -254,7 +254,7 @@
                    
                                     
     <h2>
-        <a name="4. Ð?спользование Apache Harmony">4. Ð?спользование Apache Harmony</a>
+        <a name="4. Использование Apache Harmony">4. Использование Apache Harmony</a>
     </h2>
       
                         <p>После выполнения шагов 1-3, Apache Harmony готова к работе. Обратите внимание, что в сборку в настоящее время не входит компилятор javac, но вы можете использовать компилятор другой среды исполнения, например Eclipse (см. <a href="http://harmony.apache.org/bundles.ru.html"> готовая сборка Apache Harmony с Eclipse</a>). Попробуйте запустить ваше Java приложенÐ
 ¸Ðµ, используя стандартный синтаксис: 

Modified: harmony/standard/site/xdocs/bundles.ru.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/bundles.ru.xml?rev=630108&r1=630107&r2=630108&view=diff
==============================================================================
--- harmony/standard/site/xdocs/bundles.ru.xml (original)
+++ harmony/standard/site/xdocs/bundles.ru.xml Thu Feb 21 23:16:27 2008
@@ -27,6 +27,7 @@
   <body>
 
 <section name="В Гармонии с другими проектами">
+<p style="text-align: right"> RU | <a href="bundles.html">EN</a></p>
   <p>
   Код Apache Harmony поставляется вместе с другими продуктами для
   формирования готовых программных решений и для демонстрации

Modified: harmony/standard/site/xdocs/bundles.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/bundles.xml?rev=630108&r1=630107&r2=630108&view=diff
==============================================================================
--- harmony/standard/site/xdocs/bundles.xml (original)
+++ harmony/standard/site/xdocs/bundles.xml Thu Feb 21 23:16:27 2008
@@ -27,6 +27,7 @@
   <body>
 
 <section name="Harmony with Other Projects">
+<p style="text-align: right"> <a href="bundles.ru.html">RU </a>| EN</p>
   <p>
     We bundle Apache Harmony with other projects to create out-of-the-box solutions
     and to show that Harmony can work successfully with well-known applications.

Modified: harmony/standard/site/xdocs/documentation/build_website.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/documentation/build_website.xml?rev=630108&r1=630107&r2=630108&view=diff
==============================================================================
--- harmony/standard/site/xdocs/documentation/build_website.xml (original)
+++ harmony/standard/site/xdocs/documentation/build_website.xml Thu Feb 21 23:16:27 2008
@@ -41,11 +41,20 @@
 		      <a href="http://ant.apache.org/">Apache Ant</a>
 		    </li>
 			<li>
-			   Java 1.4.2 JDK
+			   Java 1.4.2 JDK (Harmony is highly recommended)
 			</li>
 		</ul>
 	</p>
 	
+    <p class="note">Note:</p>
+    <p class="notetext">
+        Some versions of JRE (e.g. Hotspot 1.5 on Windows) have problems converting Russian pages,
+        in particular they corrupt UTF-8 cyrillic symbols. This can be easily detected, just open
+        any generated <a href="../index.ru.html">Russian</a> page in a browser and check if it contains 
+        unreadable symbols (like empty boxes).
+        If you see them, you must use another JRE - Harmony is the natural choice. Set 
+        <code>JAVA_HOME</code> environment variable to point to an appropriate directory and you're done.
+    </p>
 
 		<ol>
 			<li>

Modified: harmony/standard/site/xdocs/hdk.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/hdk.xml?rev=630108&r1=630107&r2=630108&view=diff
==============================================================================
--- harmony/standard/site/xdocs/hdk.xml (original)
+++ harmony/standard/site/xdocs/hdk.xml Thu Feb 21 23:16:27 2008
@@ -19,24 +19,26 @@
 <document>
 
     <properties>
-        <title>Harmony Development Kit for the Apache Harmony Class Library</title>
+        <title>Harmony Development Kit for the Apache Harmony</title>
         <author email="dev@harmony.apache.org">Harmony Documentation Team</author>
     </properties>
 
     <body>
 
-        <section name="Harmony Development Kit for the Apache Harmony Class Library">
+        <section name="Harmony Development Kit for the Apache Harmony">
             <p>
                 The Harmony Development Kit (HDK) allows a Harmony developer to
-                rebuild any module of the Harmony Classlib in a standalone way by providing all the
-                necesary supplementary binaries and header files. This document describes the layout
-                of such an HDK and its contents.
+                rebuild any module of the Harmony Classlib or DRLVM in a standalone way by providing all the
+                necesary supplementary binaries and header files. 
+                HDK bundles are available for download as a standard part of regular Harmony builds
+                (nightly, stable, etc).
+                This document describes the layout of such an HDK and its contents.
             </p>
 
             <subsection name="Layout of the HDK">
                 <p>
                     An HDK contains all the header files and binaries, both native and Java, required
-                    for a Harmony classlib developer to build against. The directory structure for an
+                    for a Harmony developer to build against. The directory structure for an
                     HDK is as follows:
 <pre>&lt;hdkbase&gt;
     |
@@ -83,13 +85,13 @@
 
                         <li>
                             <code>&lt;hdkbase&gt;/include</code> - this directory contains header files that
-                            are Harmony specific and are used across multiple classlib modules.
+                            are Harmony specific and are used across multiple Harmony modules.
                         </li>
 
                         <li>
                             <code>&lt;hdkbase&gt;/lib</code> - this directory is used in HDKs on Windows for
                             .lib files and on Linux for .a files necessary for linking during compilation of
-                            classlib natives.
+                            Harmony natives.
                         </li>
                     </ul>
                 </p>
@@ -113,14 +115,14 @@
                         <li>
                             <b>Building against an HDK</b> - The location of an HDK must be specified at
                             the Ant command line, and the ouptut will be built into the default (deploy)
-                            directory. The command line for this is <code><nobr>ant -DHY.HDK=path/to/HDK</nobr></code>.
+                            directory. The command line for this is <code><nobr>ant -Dhy.hdk=path/to/HDK</nobr></code>.
                         </li>
                         <li>
-                            <b>Building against an HDK and into a target directory</b> - The location of
+                            <b>Building against an HDK and into a target directory (TBD)</b> - The location of
                             an HDK and of a target directory must be specified on the Ant command line.
                             The Class Library code will be compiled against the libraries contained in
                             the HDK, and the output of those compiles will be placed into the specified
-                            target directory. The command line for this is <code><nobr>ant -DHY.HDK=path/to/HDK
+                            target directory. The command line for this is <code><nobr>ant -Dhy.hdk=path/to/HDK
                             -DHY.TARGET=path/to/target</nobr>
                             </code>.
                         </li>
@@ -134,7 +136,7 @@
                         <li>Checkout the luni module</li>
                         <li>cd into the root directory of the module</li>
                         <li>Execute <code>
-                            <nobr>ant -DHY.HDK=path/to/hdk -DHY.TARGET=path/to/target</nobr>
+                            <nobr>ant -Dhy.hdk=path/to/hdk -DHY.TARGET=path/to/target</nobr>
                         </code></li>
                     </ol></p>
                     <p>The luni Java and native code will be built against the HDK location

Modified: harmony/standard/site/xdocs/index.ru.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/index.ru.xml?rev=630108&r1=630107&r2=630108&view=diff
==============================================================================
--- harmony/standard/site/xdocs/index.ru.xml (original)
+++ harmony/standard/site/xdocs/index.ru.xml Thu Feb 21 23:16:27 2008
@@ -73,7 +73,7 @@
           Java-платформы 1.5.0, версия М4. В эту версию включены многочисленные
           функциональные улучшения и новые оптимизации JIT-компилятора, 
           увеличено покрытие кода библиотек классов, 
-          усовершенствован потоковый дизайн виртуальной машины, и
+          усовершенствован многопоточный дизайн виртуальной машины, и
           добавлена полная поддержка аппаратного адресного пространства на 64-битных
           платформах.
           <br/>
@@ -149,7 +149,7 @@
       <ol>
         <li>
           <a href="http://people.apache.org/builds/harmony/snapshots/">Доступны</a>
-          готовые сборки среды исполнения (JRE) и комплекта разработчика (HDK)
+          последние сборки среды исполнения (JRE), платформы (JDK) и комплекта разработчика (HDK)
         </li>
         <li>Автоматически обновляется <a href="http://people.apache.org/~varlax/harmony-integrity/">статус стабильности кода</a>
         на всех поддерживаемых платформах</li>
@@ -157,7 +157,7 @@
           В нашей реализации среды исполнения JRE успешно работают такие популярные приложения как
           Apache Tomcat, Eclipse, Maven, Derby, и Ant
         </li>
-        <li>Реализовано более 97% интерфейса  Java 5 (завершено но не проверено на совместимость)
+        <li>Реализовано более 99% интерфейса  Java 5 (завершено но не сертифицировано на совместимость)
     </li>
         <li>Общий объем кода превысил 1.25 миллиона строк</li>
       </ol>

Modified: harmony/standard/site/xdocs/index.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/index.xml?rev=630108&r1=630107&r2=630108&view=diff
==============================================================================
--- harmony/standard/site/xdocs/index.xml (original)
+++ harmony/standard/site/xdocs/index.xml Thu Feb 21 23:16:27 2008
@@ -27,7 +27,7 @@
   <body>
 
     <section name="Welcome to Apache Harmony - Open Source Java SE">
-
+	<p style="text-align: right"> <a href="index.ru.html">RU </a>| EN</p>
       <p>
         <big>Welcome to Apache Harmony - Open Source Java SE.</big>
       </p>

Modified: harmony/standard/site/xdocs/quickhelp_contributors.ru.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/quickhelp_contributors.ru.xml?rev=630108&r1=630107&r2=630108&view=diff
==============================================================================
--- harmony/standard/site/xdocs/quickhelp_contributors.ru.xml (original)
+++ harmony/standard/site/xdocs/quickhelp_contributors.ru.xml Thu Feb 21 23:16:27 2008
@@ -28,21 +28,23 @@
 
 <section name="Инструкция по сборке и использованию исходного кода Apache Harmony">
 <p style="text-align: right">RU | <a href="quickhelp_contributors.html">EN</a></p>
-    <P><strong>Внимание</strong>: Данная страница является переводом английской версии на сайте и находится в стадии разработки.</P>
-    <p>Следуйте этой инструкции, чтобы настроить, скомпилировать и работать с исходным кодом Apache Harmony. Для этого, необходимо: </p>
+    
+    <p>Следуйте этой инструкции, чтобы настроить, скомпилировать и работать с исходным 
+    кодом Apache Harmony. Для этого, необходимо: </p>
     <ol type="1">
        <li><a href="#prerequisites">Убедиться, что установлено все необходимое ПО</a>.  </li>
-       <li><a href="#checkout">Загрузить исходный код</a>. </li>
+       <li><a href="#checkout">Получить (скачать) исходный код</a>. </li>
        <li><a href="#building">Скомпилировать исходный код</a>.
     </li>
     </ol>
-    <p>После успешного завершения компиляции кода, вы сможете запускать Java* приложения, используя Harmony. </p>
+    <p>После успешной сборки, вы сможете <a href="#running-harmony">запускать Java приложения</a>
+    , используя Harmony. </p>
     <p>Если вам не нужен весь комплект разработчика Harmony Java SE (HDK),
     и вы намерены работать с отдельными частями кода Apache Harmony, следуйте
     <a href="#step-by-step">пошаговой инструкции</a> для построения
     отдельных компонент этого комплекта.  </p>
     <p>Проект находится на стадии разработки. При обнаружении ошибок,
-    воспользуйтесь поиском по архиву <a href="http://harmony.apache.org/mailing.html">
+    воспользуйтесь поиском по архиву <a href="mailing.html">
     почтовой рассылки проекта</a> - возможно, ваша проблема уже выявлена и решена.
     Если вы не нашли нужную информацию, пришлите нам описание проблемы, и мы постараемся помочь.  </p>
 
@@ -69,10 +71,20 @@
 -Dhttp.proxyPort=&lt;proxy&gt;</pre>
         </li>
         </ul>
+      <p>Необязательным (но рекомендкемым) ПО является Eclipse Java Compiler (ECJ), 
+      версия 3.2 или более поздняя. 
+      Вы можете <a href="http://download.eclipse.org/eclipse/downloads/">скачать</a> 
+      ecj.jar как отдельный файл и поместить его в папку <code>ANT_HOME/lib</code>.
+      В качестве альтернативы, вы можете использовать любой другой компилятор для 
+      Java 1.5, совместимый с Ant, посредством переопределения переменной
+      <code>hy.javac.compiler</code>.
+      </p>
 
     <h3>Tребования для отдельных платформ</h3>
 
-    <p>В зависимости от платформы (см. список поддерживаемых платформ) вам понадобится ряд других программ, наиболее общий список которых приводится ниже.  </p>
+    <p>В зависимости от платформы (см. <a href="roadmap.html#Porting Matrix">
+    список поддерживаемых платформ</a>) вам понадобится ряд 
+    других программ, наиболее общий список которых приводится ниже.  </p>
     <p><strong>Windows</strong> </p>
 
             <ul>
@@ -99,208 +111,180 @@
         <li> x11proto-xext-dev </li>
     </ul>
 
+      <p class="note">Примечание:</p>
+      <p class="notetext">
+      Вам необходимо убедиться, что вы правильно настроили своё окружение для работы с 
+      указанными выше программами. В частности, переменные окружения (такие как PATH)
+      содержат все необходимые файловые пути и т.д., так что вы можете успешно работать
+      со всеми инструментами из командной строки. <br/>
+      Например, для использования C++ компилятора на Windows, как правило, потребуется
+      запустить соответствующий скрипт (такой как  
+      &quot;Visual Studio .NET 2003 Command Prompt&quot;) непосредственно перед началом сборки.
+      </p>
+
     <h3>Дополнительные требования</h3>
 
-    <p>Отдельные компоненты системы сборки также зависит от сторонних программных продуктов и библиотек. Поскольку эти требования постоянно эволюционируют, мы рекомендуем запустить систему сборки и автоматически загрузить недостающие компоненты через Интернет.  </p>
-    <p>Для построения DRLVM отдельным компонентам системы требуются: </p>
+    <p>Отдельные компоненты системы сборки также зависит от сторонних программных продуктов и библиотек. 
+    Поскольку эти требования постоянно эволюционируют, мы рекомендуем запустить систему сборки и 
+    автоматически загрузить недостающие компоненты через Интернет.  </p>
+    <p>Для построения виртуальной машины DRLVM, одного из основных компонентов системы, требуются: </p>
     <ul>
-        <li> Xalan-Java, версия 2.7.0 (копируется из библиотек классов)  </li>
-        <li> Cpp Tasks collection, версия 1.0 beta 3 or higher (загружается из сети)  </li>
-        <li> Ant-Contrib набор задач, версия 0.6 или более поздняя (загружается из сети)  </li>
-        <li> Zlib библиотека, бинарные файлы, версия 1.2.1 или более поздняя (загружается из сети)  </li>
+        <li> Cpp Tasks collection, версия 1.0 beta 3 или более поздняя (загружается из сети)  </li>
+        <li> библиотека Zlib, бинарные файлы, версия 1.2.1 или более поздняя (загружается из сети)  </li>
         <li> Apache Portable Runtime Layer , версия 1.2.6 (загружается из сети)  </li>
         <li> APR-util, версия 1.2.6 (загружается из сети)  </li>
         <li> APR-iconv, версия 1.1.1 (загружается из сети) </li>
         <li> Log4cxx , наиболее поздняя версия, из SVN - 467164 (загружается из сети)  </li>
     </ul>
     <p>Данные компоненты необходимы для построения исходного кода как на Windows, так и на Linux системах. </p>
-    <p>Вы можете загрузить и установить дополнительные компоненты до сборки DRLVM и указать их расположение, как описано <code>файле</code>, шаг 3.3.1. Там же содержится информация о том, как отключить автоматическую загрузку сторонних компонент во время сборки и использовать уже установленные версии.
   Примечание: поскольку требования к ПО периодически изменяются, не рекомендуется самостоятельно устанавливать недостающие компоненты. Система сборки сделает это за вас.  </p>
+    <p>Вы можете загрузить и установить дополнительные компоненты до сборки DRLVM и указать их расположение 
+    (например отредактировав файл <code>make/depends.properties</code> в рабочем пространстве компоненты).
+    Однако, поскольку требования к ПО периодически изменяются, не рекомендуется самостоятельно устанавливать 
+    недостающие программы. Система сборки сделает это за вас.  </p>
 </subsection>
-<subsection name="2. Загрузка дерева каталогов кода">
+<subsection name="2. Загрузка федеративной систему сборки">
   <a id="checkout"></a>
-        <p>Исходный код Harmony ВМ разделен на несколько частей. Для построения всей среды исполнения вам необходимо построить библиотеку классов и виртуальную машину. Используйте объединенную систему сборки для построения всей среды, а затем работайте с библиотекой классов и/или ВМ по вашем
 ƒ выбору. В настоящее время, система сборки использует виртуальную машину DRLVM. </p>
-        <p>Для того, чтобы выгрузить объединенную систему сборки из SVN репозитория, используйте следующую команду:
+        <p>ПО Harmony разделено на несколько компонент. Для построения всего ПО вам 
+        необходимо построить библиотеку классов, виртуальную машину и инструменты Java разработчика. 
+        Используйте федеративную систему сборки для построения всей среды, а затем работайте с библиотекой 
+        классов и/или ВМ по вашему выбору. В настоящее время, система сборки использует виртуальную машину 
+        DRLVM. </p>
+        <p>Для того, чтобы загрузить федеративную систему сборки из SVN репозитория, используйте 
+        следующую команду:
         </p>
-        <pre>$ svn co https://svn.apache.org/repos/asf/harmony/enhanced/trunk</pre>
-        <p>Данная команда выгружает дерево каталогов с пустыми директориями <code>working_classlib</code> и <code>working_vm</code>. После построения исходного кода на следующем этапе, в директорию <code>working_classlib</code> будет выгружена копия  дерева каталогов библиотеки классов, а в директорию <code>working_vm</code> - копия дерева каталогов DRLVM.  </p>
-    <p><strong>Примечание</strong>: в ОС Windows, если корневая директория системы сборки находится на много уровней ниже корневого каталога, излишне длинный путь к библиотеке классов может вызвать ошибку при попытке выгрузить исходный код. Для решения этой проблемы, переместите корневую директорию си
 стемы сборки выше по дереву каталогов или смените операционную систему.  </p>
+        <pre>$ svn co http://svn.apache.org/repos/asf/harmony/enhanced/trunk</pre>
+        <p>Данная команда создаст дерево каталогов с пустыми директориями <code>common_resources</code>,
+        <code>working_classlib</code>, 
+        <code>working_vm</code> и <code>working_jdktools</code>. После загрузки исходного кода 
+        на следующем этапе, директория <code>working_classlib</code> будет содержать копию дерева 
+        каталогов библиотеки классов, директория <code>working_vm</code> - копию дерева каталогов DRLVM, 
+        и так далее. </p>
+    <p><strong>Примечание</strong>: в ОС Windows, если корневая директория системы сборки находится 
+    на много уровней ниже корневого каталога, излишне длинный путь к библиотеке классов может вызвать 
+    ошибку при попытке загрузить исходный код. Для решения этой проблемы, переместите корневую директорию 
+    системы сборки выше по дереву каталогов или смените операционную систему.  </p>
 </subsection>
 
-<subsection name="3. Сборка исходного кода комплекта разработчика HDK">
+<subsection name="3. Использование федеративной систему сборки">
     <a id="building"></a>
-    <p> На этом этапе система готова скомпилировать исходный код. Во время первой сборки система загружает все необходимые дополнительные компоненты. Система сборки оповещает пользователя об отсутствии необходимых компонент или изменении в требованиях, так что процедуру загрузки в
 нешних компонент необходимо будет периодически повторять.  </p>
-    <p>Для того, чтобы загрузить необходимые дополнительные компоненты, исходный код Harmony и построить готовую среду исполнения и комплект разработчика Harmony Java SE (HDK), в корневой папке системы сборки вызовите следующую команду:
+    <p> На этом этапе система готова начать сборку. Во время первого запуска системы потребуется загрузка 
+    всех необходимых внешних компонент. Система сборки оповещает пользователя об отсутствии необходимых 
+    компонент или изменении в требованиях, так что процедуру загрузки внешних компонент необходимо 
+    будет периодически повторять.  </p>
+    <p>Для того, чтобы загрузить необходимые сторонние компоненты, исходные тексты Harmony и построить 
+    готовую среду исполнения и комплекты разработчика Harmony Java SE (JRE, JDK и HDK), в корневой папке 
+    системы сборки вызовите следующую команду:
     </p>
-
     <pre>$ ant -Dauto.fetch=true</pre>
-    <p>Данная команда выгружает все сторонние компоненты, которые могут распространяться под различными лицензиями, отличающимися от лицензии Apache, см. полный список лицензий в файле <code>THIRD_PARTY_NOTICES.txt</code> в корневой папке.  </p>
-    <p>Выгружать дополнительные компоненты нужно только во время первого прогона сборки. Для последующих прогонов, используйте команду
+    <p>Данная команда загружает сторонние компоненты, которые могут распространяться под различными 
+    лицензиями, отличающимися от лицензии Apache, см. полный список лицензий в файле 
+    <code>THIRD_PARTY_NOTICES.txt</code> в корневой папке.  </p>
+    <p>Скачивать дополнительные компоненты потребуется только во время первого прогона сборки. 
+    Для последующих прогонов, достаточно использовать команду
     </p>
     <pre>$ ant</pre>
-    <p> Для построения полной сборки рекомендуется увеличить объем динамической памяти (Java heap), используемой программой Apache Ant.
-     Для этого, измените значение переменной окружения ANT_OPTS в зависимости от вашей операционной системы, например:
+    <p> Для построения полной сборки рекомендуется увеличить объем динамической памяти (Java heap), 
+    используемой программой Apache Ant. Для этого, измените значение переменной окружения ANT_OPTS 
+    доступным для вашей операционной системы способом, например:
     </p>
 
     <pre>ANT_OPTS='-Xms256m -Xmx512m' </pre>
 
-    <p>Если вы предполагаете использовать отдельные части исходного кода, вам не нужен весь комплект разработчика. В таком случае, не вызывайте ant и следуйте пошаговой инструкции.  </p>
+    <p>Если вы предполагаете использовать только отдельные части исходного кода, вам не обязательно 
+    строить весь комплект 
+    разработчика. В таком случае, не вызывайте ant и следуйте пошаговой инструкции как указано ниже.  
+    </p>
 </subsection>
 </section>
 
-<section name="Пошаговая инструкция сборки исходного кода">
+<section name="Пошаговая инструкция сборки отдельных компонент">
 
 <subsection name="1. Извлечение дерева каталогов">
-    <a id="step-by-step"></a>
-    <p>Для извлечения дерева каталогов, используйте соответствующее имя, указанное в скрипте <code>build.xml</code> в объединенной системе сборки. В корневой директории объединенной системы сборки, выполните следующую команду:
+<a id="step-by-step"/>    
+    <p>Для извлечения полного дерева каталогов для всех компонент, удобно использовать скрипт 
+    <code>build.xml</code> федеративной системы сборки. В корневой директории системы сборки, 
+    выполните следующую команду:
     </p>
     <pre>$ ant populate-src</pre>
-    <p>Данная команда выкачивает библиотеку классов и ВМ в директориях  <code>working_classlib</code> и <code>working_vm</code> соответственно, причем версия извлеченного кода соответствует версии файла <code>build.xml</code>. Поскольку дерево каталогов довольно велико, извлечение всего каталога может занять продолжительное время.  </p>
+    <p>Данная команда скачивает из SVN репозитория исходные тексты библиотек классов, 
+    ВМ и утилит в директории <code>working_classlib</code>,
+    <code>working_vm</code> и <code>working_jdktools</code> соответственно, 
+    причем версия извлеченного кода соответствует версии файла <code>build.xml</code>. 
+    Поскольку дерево каталогов довольно велико, загрузка всех каталогов может занять продолжительное время.  </p>
+    <p>
+    При желании, вы можете сэкономить время и сетевые ресурсы, скачав только интересующие вас компоненты вручную. 
+    В таком случае, для сборки вам дополнительно потребуется готовый пакет разработчика 
+      <a href="hdk.html">HDK</a>, который вы можете скачать с сайта Apache Harmony.
+    </p>
+    
 </subsection>
 <subsection name="2. Обновление Дерева Каталогов">
 
-    <p>По прошествии времени, вы можете синхронизировать вашу копию исходного кода с текущей версией на SVN репозитории, вызывая команду <code>svn</code> update в нужной директории, например:
+    <p>По прошествии времени, вы можете синхронизировать вашу копию исходного кода с текущей версией 
+    в SVN репозитории, вызывая команду <code>svn update</code> в нужной директории, например:
     </p>
     <pre>$ cd working_classlib
 $ svn update</pre>
-    <p>Таким способом вы можете получать обновления кода библиотеки классов и ВМ. После исполнения команды в вашем дереве каталогов отобразятся все изменения, внесенные в  SVN репозиторий после предыдущей синхронизации. Если у вас есть доступ к репозиторию с правом записи, вы можете загрÑ
 ƒÐ¶Ð°Ñ‚ÑŒ обновления командой <code>svn checkin</code>. Примечание: если после обновления дерева каталогов появляется ошибка при построении библиотеки классов, удалите результаты предыдущей сборки командой
+    <p>Таким способом вы можете получать обновления кода любого из компонент. 
+    После исполнения команды в вашем дереве каталогов отобразятся все изменения, внесенные в 
+    SVN репозиторий после предыдущей синхронизации. 
+    </p>
+    <p class="note">Примечание:</p>
+	<p class="notetext">
+    если после обновления дерева каталогов появляется ошибка при построении библиотеки классов, 
+    удалите результаты предыдущей сборки командой
     </p>
-
     <pre>$ ant clean</pre>
 </subsection>
-<subsection name="3. Сборка библиотеки классов">
-    <p>На данном этапе система готова скомпилировать исходный код. Сначала происходит сборка библиотеки классов, поскольку от нее зависит сборка виртуальной машины, и наличие библиотеки классов необходимо для функционирования всей среды исполнения.  </p>
-    <p>Во время первой сборки система загружает все необходимые дополнительные компоненты. Система сборки оповещает пользователя об отсутствии необходимых компонент или изменении в требованиях, так что процедуру загрузки внешних компонент необходимо будет периодически повторят
 Œ.  </p>
+
+<subsection name="3. Сборка компонентов">
+    <p>На данном этапе система готова скомпилировать исходный код. Необходимо собирать компоненты в 
+    следующем порядке: сперва библиотеку классов, затем ВМ, затем утилиты. Это важно, поскольку между 
+    компонентами существуют зависимости, каждая последующая компонента использует результаты сборки
+    предыдущей.
+    </p>
+  <p>
+    Все компоненты имеют унифицированные интерфейсы к системам сборки, т.е. они поддерживают
+    одинаковый базовый набор команд и переменных. Поэтому последующие шаги даются на примере
+    библиотеки классов, но применимы ко всем другим компонентам.
+  </p>  
+    
+    <p>Во время первой сборки система загружает все необходимые сторонние компоненты. 
+    Система сборки оповещает пользователя об отсутствии необходимых компонент или изменении в требованиях, 
+    так что процедуру загрузки внешних компонент потребуется периодически повторять.  </p>
     <p>Для загрузки внешних компонент и сборки библиотеки классов используйте следующие команды:
     </p>
     <pre>$ cd working_classlib
 $ ant fetch-depends
 $ ant</pre>
-    <p>Для тестирования библиотеки классов вам необходима виртуальная машина. Если у вас уже есть ВМ, запустите полный набор тестов для библиотеки классов следующей командой:
+    <p> Теперь вы можете протестировать результаты сборки. Каждая компоненты включает
+    достаточно полный набор тестов на функциональность и должна успешно выполнять 100% из них.
+    Примечание: для тестирования библиотеки классов вам необходима виртуальная машина. 
+    Вы можете использовать не только DRLVM, см. раздел 
+    <a href="#assemble-jdk">Конструирование среды исполнения</a>. 
+    Если вы хотите тестировать библиотеку классов вместе с DRLVM, приступайте к сборке DRLVM.<br/>
+    Выполните следующую команду для построения и прогона полного набора тестов:
     </p>
     <pre>$ ant test</pre>
-    <p>Для тестирования подходит не только виртуальная машина DRLVM, см. раздел Составление среды исполнения из построенных компонент. Если вы хотите тестировать библиотеку классов вместе с DRLVM, следуйте дальнейшим инструкциям для ее сборки.  </p>
+    <p>
+    Сборка завершена. Результаты сборки для каждого компонента находятся 
+    в директории <code>deploy/jdk/jre</code> внутри соответствующего рабочего пространства.
+    </p>
+        <p class="note">Примечание</p>
+    <p class="notetext">
+      DRLVM создаёт директорию deploy только если переменная <code>deploy.canonical.flag</code> 
+      была выставлена в значение <code>TRUE</code>. В противном случае результаты сборки
+      расположены глубже по дереву каталогов как <code>build/&lt;ваша-платформа&gt;/deploy/jdk/jre</code>.
+    </p>
+    <p> 
+     Вы можете получить дополнительную информацию о доступных командах и опциях для 
+     каждого из компонент при помощи команды:
+    </p>
+    <source>$ ant help</source>
 </subsection>
-<subsection name="4. Сборка виртуальной машины DRLVM">
-    <h3>4.1. Перейдите в директорию build.</h3>
-    <p>После сборки библиотеки классов, постройте ВМ для получения функционирующей среды исполнения.
-    Для этого, вернитесь в корневую директорию объединенной системы сборки и перейдите в директорию
-    <code>working_vm</code>, а затем в поддиректорию build: </p>
-        <pre>$ cd working_vm/build</pre>
-
-    <h3 >4.2. Настройте рабочее окружение.</h3>
-    <ul>
-        <li> Внесите изменения в файл <code>drlvm.properties</code>.
-        <p>Укажите системе сборки DRLVM директорию с библиотекой классов: в директории <code>build</code>
-        переименуйте файл <code>drlvm.properties.example</code> в <code>drlvm.properties</code>. </p>
-        <pre>$ cp drlvm.properties.example drlvm.properties</pre>
-        <p>Этот файл содержит значение параметра, сообщающего системе сборки DRLVM,
-        что библиотека классов находится в директории <code>working_classlib</code>.
-        Для того чтобы указать другую сборку библиотеки классов, укажите другой файл
-         с соответствующим значением при вызове команды сборки. </p>
-        <p>Проверьте, что в используемом файле параметр <code>deploy.canonical.flag</code>
-        имеет значение TRUE. Этот параметр позволяет системе сборки создать директорию
-        <code>deploy/jre/bin</code>, которая понадобится на следующих этапах сборки.  </p>
-        </li>
-
-        <li> Укажите используемый компилятор.
-        <p>Для того чтобы перейти на другой компилятор или режим сборки
-        с помощью переменных окружения, используйте следующие команды: </p>
-               <table>
-                  <tr>
-                    <th class="TableHeading">
-                      Компилятор
-                    </th>
-                    <th class="TableHeading">
-                       Windows
-                    </th>
-                    <th class="TableHeading">
-                       Linux
-                    </th>
-                  </tr>
-                  <tr>
-                    <td class="TableCell">
-                      MSVC compiler
-                    </td>
-                    <td class="TableCell">
-                      set CXX=msvc
-                    </td>
-                    <td class="TableCell">
-                      N/A
-                    </td>
-                  </tr>
-                  <tr>
-                    <td class="TableCell">
-                      Intel(R) compiler
-                    </td>
-                    <td class="TableCell">
-                      set CXX=icl
-                    </td>
-                    <td class="TableCell">
-                      export CXX=icc
-                    </td>
-                  </tr>
-                  <tr>
-                    <td class="TableCell">
-                      GCC compiler
-                    </td>
-                    <td class="TableCell">
-                      N/A
-                    </td>
-                    <td class="TableCell">
-                      export CXX=gcc
-                    </td>
-                  </tr>
-                </table>
-                </li>
-        <li>Укажите режим сборки: отладочный (debug) или рабочий (release).
-        <p>По умолчанию, система сборки работает в отладочном режиме. Для переключения в рабочий режим, выполните следующие команды: </p>
-        <p><strong>Windows</strong>: </p>
-        <pre>&gt; set BUILD_CFG=release
-&gt; build.bat</pre>
-        <p><strong>Linux</strong>:
-        </p>
-        <pre>$ BUILD_CFG=release ./build.bat</pre>
-        </li></ul>
-    <h3>4.3. Загрузите дополнительные компоненты.</h3>
-
-    <p>Перед тем, как запустить сборку, необходимо загрузить все дополнительные компоненты. Обратите внимание: эта операция может занять длительное время.   </p>
-
-    <p><strong>Windows</strong>: </p>
-    <pre>C:...\trunk\working_vm\build&gt;build.bat update </pre>
-    <p><strong>Linux</strong>: </p>
-    <pre>$ sh build.sh update </pre>
-
-    <h3>4.4 Запустите сборку кода.</h3>
 
-    <p>Чтобы запустить сборку, вызовите следующую команду:  </p>
-    <p><strong>Windows</strong>: </p>
-    <pre>C:...\trunk\working_vm\build&gt;build.bat</pre>
-    <p><strong>Linux</strong>: </p>
-    <pre>$ sh build.sh</pre>
-
-    <h3>4.5. Запустите набор тестов для проверки правильности сборки.</h3>
-
-    <p>Для проверки правильности сборки, запустите набор тестов acceptance tests командой:  </p>
-    <p><strong>Windows</strong>: </p>
-    <pre>C:...\trunk\working_vm\build&gt;build.bat test</pre>
-    <p><strong>Linux</strong>: </p>
-    <pre>$ sh build.sh test</pre>
-    <p><strong>Примечание</strong>: в настоящее время, kernel тесты не проходят.
-    Для успешного прохождения тестов, используйте C Unit и Smoke тесты.  </p>
-
-<p>Сборка виртуальной машины успешно завершена. Полная функционирующая среда исполнения готова к использованию и находится в директории <code>deploy/jre</code> внутри директории <code>build</code>.  Чтобы это проверить, вы можете, например, узнать версию используемой среды исполнения:
-</p>
-<pre>$ cd deploy/jre/bin
-$ ./java -version
-Apache Harmony Launcher:
-(c) Copyright 1991, 2006 The Apache Software Foundation or its licensors, as applicable.
-java version "1.5.0"
-pre-alpha : not complete or compatible
-svn = r479551, (Nov 27 2006), Windows/ia32/msvc 1310, debug build
-http://harmony.apache.org
-</pre>
-</subsection>
 <subsection name="5. Конструирование среды исполнения из скомпилированных компонент">
+<a id="assemble-jdk"/>
     <p>Разработчики библиотек классов могут использовать виртуальную машину DRLVM
     или установить другую совместимую ВМ. Например, вы можете использовать IBM
     virtual machine которая была предоставлена компанией IBM для нужд разработчиков
@@ -314,19 +298,21 @@
     <p><strong>Linux</strong>: </p>
     <pre>$ tar xzf &lt;path_to_vm_tarball&gt; --directory ../..</pre>
     <p>Для работы с библиотекой классов Harmony, используйте подробную
-    документацию для этого компонента.  Разработчики виртуальной машины
-    DRLVM используют ВМ, построенную в результате сборки, то есть
-    среду исполнения, состоящую из DRLVM и библиотеки классов.  </p>
+    <a href="subcomponents/classlibrary/index.html">документацию</a> для этого компонента. 
+    </p>
+        <p> Разработчики виртуальной машины
+    DRLVM могут пользоваться результатами сборки DRLVM напрямую, они включают в себя полную 
+    среду исполнения Java, состоящую из DRLVM и библиотеки классов.  </p>
 </subsection>
 </section>
 <section name="Запуск Java-приложений">
-
+<a id="running-harmony"/>
 <p>Убедитесь, что переменная окружения <code>JAVA_HOME</code> не имеет
-значения или указывает на директорию <code>deploy/jre</code>.
-Используйте стандартный синтаксис для запуска Java-приложений
-с помощью программы запуска в директории <code>deploy/jre/bin</code>: </p>
+значения или указывает на директорию сборки Harmony 
+(<code>deploy/jdk/jre</code> если вы собирали по этой инструкции).</p>
+<p>Используйте стандартный синтаксис для запуска Java-приложений: </p>
 <pre>
-$ deploy/jre/bin/java -showversion -jar helloworld.jar
+$ deploy/jdk/jre/bin/java -showversion -jar helloworld.jar
 Apache Harmony Launcher:
 (c) Copyright 1991, 2006 The Apache Software Foundation or its licensors, as applicable.
 java version "1.5.0"



Mime
View raw message