Nadya, Due to resource location changes my hand-made scripts stopped to work: all security tests failed with "*** implementation not found". I decided to get used to Geir's federated build.
I tried to find quickly quickhelp_contributors.html serfing our web site. I stopped reading the first page right after the words: "Big News: Apache Harmony is a top-level project of the Apache Software Foundation! See below for more information." After visiting "Documentation", "Get Involved", "Source Code", "DRLVM", "Contribution Policy" sections I used search in my mailbox and found that you added this reference to "Downloads" section. This is a good location, but it didn't yet appeared at the actual web site. I decided to download the web site and use search. $ grep -rl quickhelp_contributors harmony.apache.org/harmony.apache.org/index.html harmony.apache.org/quickhelp_users.html harmony.apache.org/subcomponents/buildtest/index.html harmony.apache.org/subcomponents/classlibrary/index.html There are plenty of places, though I missed them. I believe we need do the following: * It's ok to keep references at the first page. * Let's add build instruction to the documentation map. * Let's add build instruction to "Get involved". * Let's remove "Source code" section at all or replace it with a reference to ViewSvn. What do u think? With best regards, Alexei On 11/30/06, [EMAIL PROTECTED] <[EMAIL PROTECTED]> wrote:
Author: nadinem Date: Thu Nov 30 02:11:14 2006 New Revision: 480884 URL: http://svn.apache.org/viewvc?view=rev&rev=480884 Log: Resolve HARMONY-1730: applied patches downloads.patch; quickhelp_users.patch Modified: harmony/standard/site/docs/downloads.html harmony/standard/site/docs/quickhelp_users.html harmony/standard/site/xdocs/downloads.xml harmony/standard/site/xdocs/quickhelp_users.xml Modified: harmony/standard/site/docs/downloads.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/downloads.html?view=diff&rev=480884&r1=480883&r2=480884 ============================================================================== --- harmony/standard/site/docs/downloads.html (original) +++ harmony/standard/site/docs/downloads.html Thu Nov 30 02:11:14 2006 @@ -214,13 +214,17 @@ <p> Access to <a href="svn.html">the code repository</a> is available to all, and we have <a href="documentation/documentation.html">instructions</a> for building the - virtual machine code and <a href="documentation/build_classlib.html"> - building the class library code</a>. - </p> + virtual machine code. For information on how to get configured to build and + work with the Apache Harmony source code, refer to + <a href="http://incubator.apache.org/harmony/quickhelp_contributors.html";> + Getting Started For Contributors</a>. For instructions on how to point to local + versions instead of making the build download new ones from the net, refer to the + <a href="http://svn.apache.org/viewvc/incubator/harmony/enhanced/drlvm/trunk/README.txt?view=co";> + README file</a>. + </p> <p> - However, if you don't want to build it, we now offer snapshots of our JRE and - <a href="subcomponents/classlibrary/hdk.html">HDK</a> - for Linux and Windows x86-based platforms. + However, if you don not want to build it, we now offer snapshots of our JRE and HDK + for the Linux and Windows platforms. </p> <h2> Modified: harmony/standard/site/docs/quickhelp_users.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/quickhelp_users.html?view=diff&rev=480884&r1=480883&r2=480884 ============================================================================== --- harmony/standard/site/docs/quickhelp_users.html (original) +++ harmony/standard/site/docs/quickhelp_users.html Thu Nov 30 02:11:14 2006 @@ -229,7 +229,7 @@ </h2> <p> - First of all, download the binary distribution appropriate to + First, download the binary distribution appropriate to your platform. We currently distribute binaries for Linux and Microsoft Windows. Please follow the instructions on the <a href="downloads.html">download page</a> @@ -248,10 +248,10 @@ </h2> <p> - Once you have obtained the appropriate binary distribution, - you need to unpack it on your machine. In all cases, the + Once you have obtained the appropriate binary distribution, + you need to unpack it on your machine. In all cases, the distribution will unpack into a <code>jre</code> - directory. Further in the document we refer to this directory + directory. Further in the document we refer to this directory as the <i>root directory</i> of the distribution. </p> <strong>Linux Users</strong> @@ -266,19 +266,19 @@ </p> <strong>Windows Users</strong> <p> - Use one of <code>zip</code> utilities available for Windows to - unpack the distribution. The three popular ones are listed - below, but anything that can handle a <code>zip</code> file + Use one of <code>zip</code> utilities available for Windows to + unpack the distribution. The three popular ones are listed + below, but anything that can handle a <code>zip</code> file will work: </p> <ul> - <li><a href="http://www.info-zip.org/";>Info-ZIP</a> + <li><a href="http://www.info-zip.org/";>Info-ZIP</a> (open source software)</li> <li><a href="http://www.7-zip.org/";>7-Zip</a> (free software)</li> <li><a href="http://www.winzip.com/";>Winzip</a> (commercial)</li> </ul> <p> - To create the JRE directory tree, extract the + To create the JRE directory tree, extract the distribution <code>zip</code> file using the utility. </p> @@ -288,13 +288,13 @@ </h2> <p> - Apache Harmony requires no further environmental setup, but - sometimes other programs do. Also, it is convenient to have + Apache Harmony requires no further environmental setup, but + sometimes other programs do. Also, it is convenient to have the Apache Harmony executables on your path. </p> <p> - To set your <code>JAVA_HOME</code> and <code>PATH</code> - environment variables, use the commands appropriate to your + To set your <code>JAVA_HOME</code> and <code>PATH</code> + environment variables, use the commands appropriate to your operating system and/or shell you are using. </p> <strong> @@ -309,11 +309,11 @@ $ export PATH=`pwd`:$PATH </pre> <p> - The given command assumes your current directory is the parent - directory of the Harmony JRE. + The given command assumes your current directory is the parent + directory of the Harmony JRE. </p> <p class="note">Note</p> - <p class="notetext">The <code>`</code> character is a backtick character, + <p class="notetext">The <code>`</code> character is a backtick character, not an apostrophe.</p> <strong>Windows Users</strong> <p> @@ -334,9 +334,9 @@ </h2> <p> - After performing aforementioned steps, you should be ready to use + After performing aforementioned steps, you should be ready to use Apache Harmony. Note that we have not yet included - <code>javac</code>, so continue to use the compiler from some + <code>javac</code>, so continue to use the compiler from some other JRE. You should have no problems running programs. </p> <pre> Modified: harmony/standard/site/xdocs/downloads.xml URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/downloads.xml?view=diff&rev=480884&r1=480883&r2=480884 ============================================================================== --- harmony/standard/site/xdocs/downloads.xml (original) +++ harmony/standard/site/xdocs/downloads.xml Thu Nov 30 02:11:14 2006 @@ -34,14 +34,18 @@ <p> Access to <a href="svn.html">the code repository</a> is available to all, and we have <a href="documentation/documentation.html">instructions</a> for building the - virtual machine code and <a href="documentation/build_classlib.html"> - building the class library code</a>. - </p> + virtual machine code. For information on how to get configured to build and + work with the Apache Harmony source code, refer to + <a href="http://incubator.apache.org/harmony/quickhelp_contributors.html";> + Getting Started For Contributors</a>. For instructions on how to point to local + versions instead of making the build download new ones from the net, refer to the + <a href="http://svn.apache.org/viewvc/incubator/harmony/enhanced/drlvm/trunk/README.txt?view=co";> + README file</a>. + </p> <p> - However, if you don't want to build it, we now offer snapshots of our JRE and - <a href="subcomponents/classlibrary/hdk.html">HDK</a> - for Linux and Windows x86-based platforms. + However, if you don not want to build it, we now offer snapshots of our JRE and HDK + for the Linux and Windows platforms. </p> <subsection name="Snapshot Builds"> Modified: harmony/standard/site/xdocs/quickhelp_users.xml URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/quickhelp_users.xml?view=diff&rev=480884&r1=480883&r2=480884 ============================================================================== --- harmony/standard/site/xdocs/quickhelp_users.xml (original) +++ harmony/standard/site/xdocs/quickhelp_users.xml Thu Nov 30 02:11:14 2006 @@ -48,7 +48,7 @@ <subsection name="Download the Apache Harmony Snapshot"> <p> - First of all, download the binary distribution appropriate to + First, download the binary distribution appropriate to your platform. We currently distribute binaries for Linux and Microsoft Windows. Please follow the instructions on the <a href="downloads.html">download page</a> @@ -66,10 +66,10 @@ <subsection name="Unpack the Binary Distribution"> <p> - Once you have obtained the appropriate binary distribution, - you need to unpack it on your machine. In all cases, the + Once you have obtained the appropriate binary distribution, + you need to unpack it on your machine. In all cases, the distribution will unpack into a <code>jre</code> - directory. Further in the document we refer to this directory + directory. Further in the document we refer to this directory as the <i>root directory</i> of the distribution. </p> @@ -90,34 +90,34 @@ <strong>Windows Users</strong> <p> - Use one of <code>zip</code> utilities available for Windows to - unpack the distribution. The three popular ones are listed - below, but anything that can handle a <code>zip</code> file + Use one of <code>zip</code> utilities available for Windows to + unpack the distribution. The three popular ones are listed + below, but anything that can handle a <code>zip</code> file will work: </p> <ul> - <li><a href="http://www.info-zip.org/";>Info-ZIP</a> + <li><a href="http://www.info-zip.org/";>Info-ZIP</a> (open source software)</li> <li><a href="http://www.7-zip.org/";>7-Zip</a> (free software)</li> <li><a href="http://www.winzip.com/";>Winzip</a> (commercial)</li> </ul> <p> - To create the JRE directory tree, extract the + To create the JRE directory tree, extract the distribution <code>zip</code> file using the utility. </p> </subsection> <subsection name="Configuring Your Environment"> <p> - Apache Harmony requires no further environmental setup, but - sometimes other programs do. Also, it is convenient to have + Apache Harmony requires no further environmental setup, but + sometimes other programs do. Also, it is convenient to have the Apache Harmony executables on your path. </p> <p> - To set your <code>JAVA_HOME</code> and <code>PATH</code> - environment variables, use the commands appropriate to your + To set your <code>JAVA_HOME</code> and <code>PATH</code> + environment variables, use the commands appropriate to your operating system and/or shell you are using. </p> @@ -136,11 +136,11 @@ </source> <p> - The given command assumes your current directory is the parent - directory of the Harmony JRE. + The given command assumes your current directory is the parent + directory of the Harmony JRE. </p> <p class="note">Note</p> - <p class="notetext">The <code>`</code> character is a backtick character, + <p class="notetext">The <code>`</code> character is a backtick character, not an apostrophe.</p> <strong>Windows Users</strong> @@ -164,9 +164,9 @@ <subsection name="Using Apache Harmony"> <p> - After performing aforementioned steps, you should be ready to use + After performing aforementioned steps, you should be ready to use Apache Harmony. Note that we have not yet included - <code>javac</code>, so continue to use the compiler from some + <code>javac</code>, so continue to use the compiler from some other JRE. You should have no problems running programs. </p>
-- Thank you, Alexei
