forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: rev 23021 - forrest/trunk/src/documentation/content/xdocs
Date Sun, 18 Jul 2004 09:46:59 GMT
Author: crossley
Date: Sun Jul 18 02:46:58 2004
New Revision: 23021

Add the new system for download mirrors.
When we build the Forrest website, a document called "mirrors.html"
is generated from the xdocs/mirrors.ihtml file.
This page contains instructions to be processed by the mirrors.cgi script
to generate an html form for selecting the closest mirror.

Modified: forrest/trunk/src/documentation/content/xdocs/index.xml
--- forrest/trunk/src/documentation/content/xdocs/index.xml	(original)
+++ forrest/trunk/src/documentation/content/xdocs/index.xml	Sun Jul 18 02:46:58 2004
@@ -214,6 +214,7 @@
         put in, the more you get to define the project's future.  See the
         <link href="site:contrib">"contributing"</link> page for more
+<link href="site:mirrors"/>

Added: forrest/trunk/src/documentation/content/xdocs/mirrors.ihtml
--- (empty file)
+++ forrest/trunk/src/documentation/content/xdocs/mirrors.ihtml	Sun Jul 18 02:46:58 2004
@@ -0,0 +1,141 @@
+<?xml version="1.0"?>
+  Copyright 2001-2004 The Apache Software Foundation
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  See the License for the specific language governing permissions and
+  limitations under the License.
+  <head>
+    <title>Obtain the Forrest distribution</title>
+  </head>
+  <body>
+<h1><a name="how" />How to download</h1>
+<p>Use the links below to download a distribution of Forrest from
+one of our mirrors. It is good practice to 
+<a href="[location]#verify">verify the integrity</a>
+of the distribution files.</p>
+<p>Forrest is distributed as <code>zip</code> and <code>tar.gz</code>
+archives - the contents are the same.
+<h1><a name="closest" />Closest mirror site selected automatically</h1>
+<p>You are currently using <b>[preferred]</b>. If you encounter a
+problem with this mirror, then please select another.  If all
+mirrors are failing, there are backup mirrors at the end of the list.
+See <a href="">status</a> of mirrors.
+<form action="[location]" method="get" id="SelectMirror">
+Other mirrors: <select name="Preferred">
+<!--[if-any http] [for http]-->
+<option value="[http]">[http]</option>
+<!--[end] [end]-->
+<!--[if-any ftp] [for ftp]-->
+<option value="[ftp]">[ftp]</option>
+<!--[end] [end]-->
+<!--[if-any backup] [for backup]-->
+<option value="[backup]">[backup] (backup)</option>
+<!--[end] [end]-->
+<input type="submit" value="Change" />     
+<p>The current release is Apache Forrest 0.5.1 (see the
+<a href="[preferred]/forrest/README.html">release notes</a>).</p>
+<li>source distribution: 
+<a href="[preferred]/forrest/apache-forrest-0.5.1-src.tar.gz">apache-forrest-0.5.1-src.tar.gz</a>
+[<a href="">PGP</a>]
+[<a href="">MD5</a>]</li>
+<li>source distribution: 
+<a href="[preferred]/forrest/"></a>
+[<a href="">PGP</a>]
+[<a href="">MD5</a>]</li>
+<li>binary distribution: 
+<a href="[preferred]/forrest/apache-forrest-0.5.1-bin.tar.gz">apache-forrest-0.5.1-bin.tar.gz</a>
+[<a href="">PGP</a>]
+[<a href="">MD5</a>]</li>
+<li>binary distribution: 
+<a href="[preferred]/forrest/"></a>
+[<a href="">PGP</a>]
+[<a href="">MD5</a>]</li>
+<h1><a name="svn" />Head SVN repository and snapshots</h1>
+<p>If you want to use the latest Forrest features, the source code is under
+version control with Subversion (read how to
+<a href="site:getting-involved/build">obtain</a> your working copy). There are
+also compressed source 
+<a href="">snapshots</a> that are
+built every 6 hours.
+<h1><a name="archive" />Archive of old releases</h1>
+<p>Older releases are available in the <a
+href="">archive</a>.  Those
+releases are only provided as historical artefacts. We strongly
+recommend to not use those releases, but upgrade to the most recent release.
+<h1><a name="verify" />Verify releases</h1>
+<p>It is essential that you verify the integrity of the downloaded
+files using the PGP or MD5 signatures.</p>
+<p>The PGP signatures can be verified using
+<a href="">PGP</a> or
+<a href="">GPG</a>.
+First download the Forrest
+<a href="">KEYS</a>
+as well as the <code>asc</code> signature file for the particular
+distribution. It is important that you get these files from the ultimate
+trusted source - the main ASF distribution site, rather than from a mirror.
+Then verify the signatures using ...</p>
+% pgpk -a KEYS<br />
+% pgpv apache-forrest-0.5.1-src.tar.gz.asc<br />
+<em>or</em><br />
+% pgp -ka KEYS<br />
+% pgp apache-forrest-0.5.1-src.tar.gz.asc<br />
+<em>or</em><br />
+% gpg --import KEYS<br />
+% gpg --verify apache-forrest-0.5.1-src.tar.gz.asc
+<p>Alternatively, you can verify the MD5 signature on the files.  A
+unix program called <code>md5</code> or <code>md5sum</code> is
+included in many unix distributions.  It is also available as part of
+<a href="">GNU
+Textutils</a>.  Windows users can get binary md5 programs from <a
+href="">here</a>, <a
+href="">here</a>, or
+<a href="">here</a>.</p>
+<p>We strongly recommend to verify the signature.</p>

Modified: forrest/trunk/src/documentation/content/xdocs/site.xml
--- forrest/trunk/src/documentation/content/xdocs/site.xml	(original)
+++ forrest/trunk/src/documentation/content/xdocs/site.xml	Sun Jul 18 02:46:58 2004
@@ -19,7 +19,8 @@
   <about label="About">
     <index label="Index" href="index.html"/>
     <license label="License" href="license.html"/>
-    <download label="Download" href=""/>
+    <download label="Download" href=""/>
+    <mirrors href="mirrors.html"/>
     <who label="Who we are" href="who.html"/>
     <faq label="FAQs" href="faq.html">
       <docbook href="#docbook"/>

View raw message