wangwei
/
antliscence
forked from youys/ant

<?xml version="1.0"?>
<!--
   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You 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

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
-->
<document>

  <properties>
    <title>Ant Manual Distributions</title>
    <base/>
  </properties>

<body>

<section name="Downloading Apache Ant&amp;#x2122;'s Manual">

<p>Apache Ant's manual is part of the binary distribution but is also
  available as a stand-alone download.</p>

<p>Use the links below to download a distribution of Ant's manual from
one of our mirrors.  It is good practice to
<a href="[location]#Verify Releases">verify the integrity</a>
of the distribution files, especially if you are using one of our
mirror sites.  In order to do this you must use the signatures from
our <a href="http://www.apache.org/dist/ant/">main distribution
directory</a>.</p>

<p>Ant is distributed as <code>zip</code>, <code>tar.gz</code> and
<code>tar.bz2</code> archives - the contents are the same.  Please
note that the <code>tar.*</code> archives contain file names longer
than 100 characters and have been created using GNU tar extensions.
Thus they must be untarred with a GNU compatible version of
<code>tar</code>.</p>

<p>If you do not see the file you need in the links below, please see
the <a href="http://www.apache.org/dist/ant/">master distribution
directory</a> or, preferably, its <a href="[preferred]/ant/">mirror</a>.</p>

</section>

<section name="Mirror">

<p>You are currently using <b>[preferred]</b>.  If you encounter a
problem with this mirror, please select another mirror.  If all
mirrors are failing, there are <i>backup</i> mirrors (at the end of
the mirrors list) that should be available.</p>

<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]
</select>
<input type="submit" value="Change" />
</form>
</section>

<section name="Current Release of Ant">

<p>Currently, Apache Ant 1.8.2 is the best available version, see the
<a href="[preferred]/ant/README.html">release notes</a>.</p>

<div class="warning">
<div class="label">Note</div>
<div class="content">Ant 1.8.2 was released on 27-December-2010 and
may not be available on all mirrors for a few days.</div>
</div>
<br></br>
<div class="warning">
<div class="label">Tar files may require gnu tar to extract</div>
<div class="content">Tar files in the distribution contain long file names, and may
 require gnu tar to do the extraction.</div>
</div>

<ul>
<li><code>.zip</code> archive:
<a href="[preferred]/ant/manual/apache-ant-1.8.2-manual.zip">apache-ant-1.8.2-manual.zip</a>
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.zip.asc">PGP</a>]
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.zip.sha1">SHA1</a>]
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.zip.sha512">SHA512</a>]
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.zip.md5">MD5</a>]</li>

<li><code>.tar.gz</code> archive:
<a href="[preferred]/ant/manual/apache-ant-1.8.2-manual.tar.gz">apache-ant-1.8.2-manual.tar.gz</a>
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.tar.gz.asc">PGP</a>]
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.tar.gz.sha1">SHA1</a>]
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.tar.gz.sha512">SHA512</a>]
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.tar.gz.md5">MD5</a>]</li>

<li><code>.tar.bz2</code> archive:
<a href="[preferred]/ant/manual/apache-ant-1.8.2-manual.tar.bz2">apache-ant-1.8.2-manual.tar.bz2</a>
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.tar.bz2.asc">PGP</a>]
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.tar.bz2.sha1">SHA1</a>]
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.tar.bz2.sha512">SHA512</a>]
[<a href="http://www.apache.org/dist/ant/manual/apache-ant-1.8.2-manual.tar.bz2.md5">MD5</a>]</li>
</ul>
</section>


<section name="Old Ant Releases">

<p>Manuals for older releases of Ant can be
found <a href="http://archive.apache.org/dist/ant/manual/">here</a>.</p>

</section>

<section name="Verify Releases">

<p>It is essential that you verify the integrity of the downloaded
files using the PGP signature or the SHA1, SHA512 or MD5 checksums.  The
checksums are not as strong indicators as the PGP signature.</p>

<p>The PGP signatures can be verified using PGP or GPG.  First
download the <a href="http://www.apache.org/dist/ant/KEYS">KEYS</a>
as well as the <code>asc</code> signature file for the particular
distribution.  Make sure you get these files from the <a
href="http://www.apache.org/dist/ant/">main distribution
directory</a>, rather than from a mirror. Then verify the signatures
using</p>

<p><code>
% pgpk -a KEYS<br />
% pgpv apache-ant-1.8.2-manual.tar.gz.asc<br />
</code>
<em>or</em><br />
<code>
% pgp -ka KEYS<br />
% pgp apache-ant-1.8.2-manual.tar.gz.asc<br />
</code>
<em>or</em><br />
<code>
% gpg --import KEYS<br />
% gpg --verify apache-ant-1.8.2-manual.tar.gz.asc
</code></p>

<p>A command line version of <a href="http://www.gnupg.org/download/">GnuPG</a> 
is also available for Windows users.  Follow the 
<a href="http://www.gnupg.org/(en)/documentation/faqs.html#q4.19">instructions</a> 
to verify the package.</p>

<p>Alternatively, you can verify the checksums on the files.  Unix
programs called <code>md5</code>/<code>sha1</code>/<code>sha512</code> or
<code>md5sum</code>/<code>sha1sum</code>/<code>sha512sum</code> are included in many unix
distributions.  <code>*sum</code> is also available as part of <a
href="http://www.gnu.org/software/textutils/textutils.html">GNU
Textutils</a>.  Windows users can get binary md5 programs from <a
href="http://www.fourmilab.ch/md5/">here</a>, <a
href="http://www.pc-tools.net/win32/freeware/console/">here</a>.  <a
href="http://www.slavasoft.com/fsum/">fsum</a> supports MD5 and
SHA1.</p>

<p>We highly recommend to verify the PGP signature, though.</p>

</section>

</body>
</document>