From 5b89076d0c498306bc5a44ef6250c0aa1866f44b Mon Sep 17 00:00:00 2001 From: Stefan Bodewig Date: Mon, 26 Jul 2010 16:05:23 +0000 Subject: [PATCH] download page for manuals git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@979337 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manualdownload.cgi | 22 +++++ xdocs/manualdownload.xml | 172 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 194 insertions(+) create mode 100755 docs/manualdownload.cgi create mode 100644 xdocs/manualdownload.xml diff --git a/docs/manualdownload.cgi b/docs/manualdownload.cgi new file mode 100755 index 000000000..4324f769f --- /dev/null +++ b/docs/manualdownload.cgi @@ -0,0 +1,22 @@ +#!/bin/sh + +# 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. + +# Wrapper script around mirrors.cgi script +# (we must change to that directory in order for python to pick up the +# python includes correctly) +cd /www/www.apache.org/dyn/mirrors +/www/www.apache.org/dyn/mirrors/mirrors.cgi $* diff --git a/xdocs/manualdownload.xml b/xdocs/manualdownload.xml new file mode 100644 index 000000000..8474d83d8 --- /dev/null +++ b/xdocs/manualdownload.xml @@ -0,0 +1,172 @@ + + + + + + Ant Manual Distributions + + + + + +
+ +

Ant's manual is part of the binary distribution but is also + available as a stand-alone download.

+ +

Use the links below to download a distribution of Ant's manual from +one of our mirrors. It is good practice to +verify the integrity +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 main distribution +directory.

+ +

Ant is distributed as zip, tar.gz and +tar.bz2 archives - the contents are the same. Please +note that the tar.* 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 +tar.

+ +

If you do not see the file you need in the links below, please see +the master distribution +directory or, preferably, its mirror.

+ +
+ +
+ +

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

+ +
+Other mirrors: + +
+
+ +
+ +

Currently, Apache Ant 1.8.1 is the best available version, see the +release notes.

+ +
+
Note
+
Ant 1.8.1 was released on 7-May-2010 and +may not be available on all mirrors for a few days.
+
+

+
+
Tar files may require gnu tar to extract
+
Tar files in the distribution contain long file names, and may + require gnu tar to do the extraction.
+
+ + +
+ + +
+ +

Manuals for older releases of Ant can be +found here..

+ +
+ +
+ +

It is essential that you verify the integrity of the downloaded +files using the PGP signature or the SHA1 or MD5 checksums. The +checksums are not as strong indicators as the PGP signature.

+ +

The PGP signatures can be verified using PGP or GPG. First +download the KEYS +as well as the asc signature file for the particular +distribution. Make sure you get these files from the main distribution +directory, rather than from a mirror. Then verify the signatures +using

+ +

+% pgpk -a KEYS
+% pgpv apache-ant-1.8.1-manual.tar.gz.asc
+ +or
+ +% pgp -ka KEYS
+% pgp apache-ant-1.8.1-manual.tar.gz.asc
+ +or
+ +% gpg --import KEYS
+% gpg --verify apache-ant-1.8.1-manual.tar.gz.asc +

+ +

A command line version of GnuPG +is also available for Windows users. Follow the +instructions +to verify the package.

+ +

Alternatively, you can verify the checksums on the files. Unix +programs called md5/sha1 or +md5sum/sha1sum are included in many unix +distributions. *sum is also available as part of GNU +Textutils. Windows users can get binary md5 programs from here, here. fsum supports MD5 and +SHA1.

+ +

We highly recommend to verify the PGP signature, though.

+ +
+ + +