| Index: third_party/apache_ant/README | 
| =================================================================== | 
| --- third_party/apache_ant/README	(revision 17153) | 
| +++ third_party/apache_ant/README	(working copy) | 
| @@ -1,17 +1,97 @@ | 
| -URL: http://apache.opensourceresources.org/ant/binaries/apache-ant-1.7.1-bin.tar.gz | 
| -Version: 1.7.1 | 
| -License: Apache License 2.0 | 
| -License File: LICENSE | 
|  | 
| -Description: | 
| -Ant is a Java based build tool. In theory it is kind of like "make" | 
| -without makes wrinkles and with the full portability of pure java code. | 
| +                                 A     N     T | 
| + | 
|  | 
| -Local Modifications: | 
| -* Modified bin/ant to look in the ant.runfiles directory | 
| -  generated by the google3 BUILD system for its data. | 
| +  What is it? | 
| +  ----------- | 
| + | 
| +  Ant is a Java based build tool. In theory it is kind of like "make" | 
| +  without makes wrinkles and with the full portability of pure java code. | 
|  | 
| -* Removed from ant.jar: | 
| -org/apache/tools/bzip2/... | 
| -Added dep: //third_party/java/bzip2 | 
| + | 
| +  Why? | 
| +  ---- | 
| + | 
| +  Why another build tool when there is already make, gnumake, nmake, jam, | 
| +  and others? Because all of those tools have limitations that its original | 
| +  author couldn't live with when developing software across multiple platforms. | 
| + | 
| +  Make-like tools are inherently shell based. They evaluate a set of | 
| +  dependencies and then execute commands not unlike what you would issue on a | 
| +  shell. This means that you can easily extend these tools by using or writing | 
| +  any program for the OS that you are working on. However, this also means that | 
| +  you limit yourself to the OS, or at least the OS type such as Unix, that you | 
| +  are working on. | 
| + | 
| +  Makefiles are inherently evil as well. Anybody who has worked on them for any | 
| +  time has run into the dreaded tab problem. "Is my command not executing | 
| +  because I have a space in front of my tab!!!" said the original author of Ant | 
| +  way too many times. Tools like Jam took care of this to a great degree, but | 
| +  still use yet another format to use and remember. | 
| + | 
| +  Ant is different. Instead a model where it is extended with shell based | 
| +  commands, it is extended using Java classes. Instead of writing shell | 
| +  commands, the configuration files are XML based calling out a target tree | 
| +  where various tasks get executed. Each task is run by an object which | 
| +  implements a particular Task interface. | 
| + | 
| +  Granted, this removes some of the expressive power that is inherent by being | 
| +  able to construct a shell command such as `find . -name foo -exec rm {}` but | 
| +  it gives you the ability to be cross platform. To work anywhere and | 
| +  everywhere. And hey, if you really need to execute a shell command, Ant has | 
| +  an exec rule that allows different commands to be executed based on the OS | 
| +  that it is executing on. | 
|  | 
| +  The Latest Version | 
| +  ------------------ | 
| + | 
| +  Details of the latest version can be found on the Apache Ant | 
| +  Project web site <http://ant.apache.org/>. | 
| + | 
| + | 
| +  Documentation | 
| +  ------------- | 
| + | 
| +  Documentation is available in HTML format, in the docs/ directory. | 
| +  For information about building and installing Ant, see | 
| +  docs/manual/index.html | 
| + | 
| + | 
| +  Licensing | 
| +  --------- | 
| + | 
| +  This software is licensed under the terms you may find in the file | 
| +  named "LICENSE" in this directory. | 
| + | 
| +  This distribution includes cryptographic software.  The country in | 
| +  which you currently reside may have restrictions on the import, | 
| +  possession, use, and/or re-export to another country, of | 
| +  encryption software.  BEFORE using any encryption software, please | 
| +  check your country's laws, regulations and policies concerning the | 
| +  import, possession, or use, and re-export of encryption software, to | 
| +  see if this is permitted.  See <http://www.wassenaar.org/> for more | 
| +  information. | 
| + | 
| +  The U.S. Government Department of Commerce, Bureau of Industry and | 
| +  Security (BIS), has classified this software as Export Commodity | 
| +  Control Number (ECCN) 5D002.C.1, which includes information security | 
| +  software using or performing cryptographic functions with asymmetric | 
| +  algorithms.  The form and manner of this Apache Software Foundation | 
| +  distribution makes it eligible for export under the License Exception | 
| +  ENC Technology Software Unrestricted (TSU) exception (see the BIS | 
| +  Export Administration Regulations, Section 740.13) for both object | 
| +  code and source code. | 
| + | 
| +  The following provides more details on the included cryptographic | 
| +  software: | 
| + | 
| +  For the SSH family of tasks (<sshexec> and <scp>) Ant requires the | 
| +  JSch <http://www.jcraft.com/jsch/index.html> library as well as the | 
| +  Java Cryptography extensions | 
| +  <http://java.sun.com/javase/technologies/security/>.  Ant does not | 
| +  include these libraries itself, but is designed to use them. | 
| + | 
| +  Thanks for using Ant. | 
| + | 
| +                                          The Apache Ant Project | 
| +                                         <http://ant.apache.org/> | 
|  |