RAT (Release Audit Tool) results

The following document contains the results of RAT (Release Audit Tool) .

*****************************************************
Summary
-------
Notes: 4
Binaries: 9
Archives: 0
Standards: 142

Apache Licensed: 129
Generated Documents: 1

JavaDocs are generated and so license header is optional
Generated files do not required license headers

12 Unknown Licenses

*******************************

Archives (+ indicates readable, $ unreadable): 

 
*****************************************************
  Files with AL headers will be marked L
  Binary files (which do not require AL headers) will be marked B
  Compressed archives will be marked A
  Notices, licenses etc will be marked N
 !????? build-gump.xml
  GEN   build.xml
 !????? doap_cli.rdf
  N     LICENSE.txt
  AL    maven.xml
  N     NOTICE.txt
  AL    pom.xml
 !????? project.properties
  AL    project.xml
  N     README.txt
  N     RELEASE-NOTES.txt
  AL    src/assembly/bin.xml
  AL    src/assembly/src.xml
 !????? src/conf/MANIFEST.MF
  AL    src/java/org/apache/commons/cli2/Argument.java
  AL    src/java/org/apache/commons/cli2/builder/ArgumentBuilder.java
  AL    src/java/org/apache/commons/cli2/builder/CommandBuilder.java
  AL    src/java/org/apache/commons/cli2/builder/DefaultOptionBuilder.java
  AL    src/java/org/apache/commons/cli2/builder/GroupBuilder.java
  AL    src/java/org/apache/commons/cli2/builder/PatternBuilder.java
  AL    src/java/org/apache/commons/cli2/builder/SwitchBuilder.java
  AL    src/java/org/apache/commons/cli2/commandline/CommandLineImpl.java
  AL    src/java/org/apache/commons/cli2/commandline/DefaultingCommandLine.java
  AL    src/java/org/apache/commons/cli2/commandline/Parser.java
  AL    src/java/org/apache/commons/cli2/commandline/PreferencesCommandLine.java
  AL    src/java/org/apache/commons/cli2/commandline/PropertiesCommandLine.java
  AL    src/java/org/apache/commons/cli2/commandline/WriteableCommandLineImpl.java
  AL    src/java/org/apache/commons/cli2/CommandLine.java
  AL    src/java/org/apache/commons/cli2/DisplaySetting.java
  AL    src/java/org/apache/commons/cli2/Group.java
  AL    src/java/org/apache/commons/cli2/HelpLine.java
  AL    src/java/org/apache/commons/cli2/option/ArgumentImpl.java
  AL    src/java/org/apache/commons/cli2/option/Command.java
  AL    src/java/org/apache/commons/cli2/option/DefaultOption.java
  AL    src/java/org/apache/commons/cli2/option/GroupImpl.java
  AL    src/java/org/apache/commons/cli2/option/HelpLineImpl.java
  AL    src/java/org/apache/commons/cli2/option/OptionImpl.java
  AL    src/java/org/apache/commons/cli2/option/ParentImpl.java
  AL    src/java/org/apache/commons/cli2/option/PropertyOption.java
  AL    src/java/org/apache/commons/cli2/option/SourceDestArgument.java
  AL    src/java/org/apache/commons/cli2/option/Switch.java
  AL    src/java/org/apache/commons/cli2/Option.java
  AL    src/java/org/apache/commons/cli2/OptionException.java
  AL    src/java/org/apache/commons/cli2/Parent.java
 !????? src/java/org/apache/commons/cli2/resource/CLIMessageBundle_en_US.properties
  AL    src/java/org/apache/commons/cli2/resource/ResourceConstants.java
  AL    src/java/org/apache/commons/cli2/resource/ResourceHelper.java
  AL    src/java/org/apache/commons/cli2/util/Comparators.java
  AL    src/java/org/apache/commons/cli2/util/HelpFormatter.java
  AL    src/java/org/apache/commons/cli2/validation/ClassValidator.java
  AL    src/java/org/apache/commons/cli2/validation/DateValidator.java
  AL    src/java/org/apache/commons/cli2/validation/EnumValidator.java
  AL    src/java/org/apache/commons/cli2/validation/FileValidator.java
  AL    src/java/org/apache/commons/cli2/validation/InvalidArgumentException.java
  AL    src/java/org/apache/commons/cli2/validation/NumberValidator.java
 !????? src/java/org/apache/commons/cli2/validation/package.html
  AL    src/java/org/apache/commons/cli2/validation/UrlValidator.java
  AL    src/java/org/apache/commons/cli2/validation/Validator.java
  AL    src/java/org/apache/commons/cli2/WriteableCommandLine.java
  B     src/media/logo.xcf
  B     src/site/resources/images/1x1.gif
  B     src/site/resources/images/logo.jpg
  B     src/site/resources/images/logo.png
  B     src/site/resources/images/options.png
  AL    src/site/resources/images/svg/commandlines.svg
  AL    src/site/resources/images/svg/diagrams-cli2.js
  AL    src/site/resources/images/svg/diagrams.css
  AL    src/site/resources/images/svg/diagrams.js
  AL    src/site/resources/images/svg/options.svg
  AL    src/site/resources/images/svg/util.svg
  AL    src/site/site.xml
 !????? src/test/data/.hidden.txt
 !????? src/test/data/readable.txt
 !????? src/test/data/writable.txt
  AL    src/test/org/apache/commons/cli2/application/AntTest.java
  AL    src/test/org/apache/commons/cli2/application/CpTest.java
  AL    src/test/org/apache/commons/cli2/application/CvsTest.java
  AL    src/test/org/apache/commons/cli2/application/LsTest.java
  AL    src/test/org/apache/commons/cli2/bug/Bug13886Test.java
  AL    src/test/org/apache/commons/cli2/bug/Bug13935Test.java
  AL    src/test/org/apache/commons/cli2/bug/Bug15046Test.java
  AL    src/test/org/apache/commons/cli2/bug/Bug15648Test.java
  AL    src/test/org/apache/commons/cli2/bug/Bug27575Test.java
  AL    src/test/org/apache/commons/cli2/bug/Bug28005Test.java
  AL    src/test/org/apache/commons/cli2/bug/Bug32533Test.java
 !????? src/test/org/apache/commons/cli2/bug/BugCLI122Test.java
  AL    src/test/org/apache/commons/cli2/bug/BugCLI12Test.java
  AL    src/test/org/apache/commons/cli2/bug/BugCLI18Test.java
  AL    src/test/org/apache/commons/cli2/bug/BugCLI80Test.java
  AL    src/test/org/apache/commons/cli2/bug/BugLoopingOptionLookAlikeTest.java
  AL    src/test/org/apache/commons/cli2/builder/ArgumentBuilderTest.java
  AL    src/test/org/apache/commons/cli2/builder/DefaultOptionBuilderTest.java
  AL    src/test/org/apache/commons/cli2/CLITestCase.java
  AL    src/test/org/apache/commons/cli2/commandline/DefaultingCommandLineTest.java
  AL    src/test/org/apache/commons/cli2/commandline/ParserTest.java
  AL    src/test/org/apache/commons/cli2/commandline/PreferencesCommandLineTest.java
  AL    src/test/org/apache/commons/cli2/commandline/PropertiesCommandLineTest.java
  AL    src/test/org/apache/commons/cli2/commandline/WriteableCommandLineImplTest.java
  AL    src/test/org/apache/commons/cli2/CommandLineDefaultsTest.java
  AL    src/test/org/apache/commons/cli2/CommandLineTestCase.java
  AL    src/test/org/apache/commons/cli2/DocumentationTest.java
  AL    src/test/org/apache/commons/cli2/jdepend/JDependTest.java
  AL    src/test/org/apache/commons/cli2/option/ArgumentTest.java
  AL    src/test/org/apache/commons/cli2/option/ArgumentTestCase.java
  AL    src/test/org/apache/commons/cli2/option/CommandTest.java
  AL    src/test/org/apache/commons/cli2/option/DefaultOptionTest.java
  AL    src/test/org/apache/commons/cli2/option/GroupTest.java
  AL    src/test/org/apache/commons/cli2/option/GroupTestCase.java
  AL    src/test/org/apache/commons/cli2/option/NestedGroupTest.java
  AL    src/test/org/apache/commons/cli2/option/OptionTestCase.java
  AL    src/test/org/apache/commons/cli2/option/ParentTest.java
  AL    src/test/org/apache/commons/cli2/option/ParentTestCase.java
  AL    src/test/org/apache/commons/cli2/option/PropertyOptionTest.java
  AL    src/test/org/apache/commons/cli2/option/SwitchTest.java
  AL    src/test/org/apache/commons/cli2/PrecedenceTest.java
  AL    src/test/org/apache/commons/cli2/resource/ResourceHelperTest.java
 !????? src/test/org/apache/commons/cli2/resource/TestBundle.properties
  AL    src/test/org/apache/commons/cli2/util/ComparatorsTest.java
  AL    src/test/org/apache/commons/cli2/util/HelpFormatterTest.java
  AL    src/test/org/apache/commons/cli2/validation/ClassValidatorTest.java
  AL    src/test/org/apache/commons/cli2/validation/DateValidatorTest.java
  AL    src/test/org/apache/commons/cli2/validation/EnumValidatorTest.java
  AL    src/test/org/apache/commons/cli2/validation/FileValidatorTest.java
  AL    src/test/org/apache/commons/cli2/validation/NumberValidatorTest.java
  AL    src/test/org/apache/commons/cli2/validation/protect/ProtectedClass.java
  AL    src/test/org/apache/commons/cli2/validation/TimeZoneTestSuite.java
  AL    src/test/org/apache/commons/cli2/validation/UrlValidatorTest.java
  AL    src/test/org/apache/commons/cli2/WriteableCommandLineTestCase.java
  AL    xdocs/changes.xml
  AL    xdocs/cvs-usage.xml
  AL    xdocs/download_cli.xml
  AL    xdocs/examples/ant.xml
  AL    xdocs/examples/index.xml
  B     xdocs/images/1x1.gif
  B     xdocs/images/logo.jpg
  B     xdocs/images/logo.png
  B     xdocs/images/options.png
  AL    xdocs/images/svg/commandlines.svg
  AL    xdocs/images/svg/diagrams-cli2.js
  AL    xdocs/images/svg/diagrams.css
  AL    xdocs/images/svg/diagrams.js
  AL    xdocs/images/svg/options.svg
  AL    xdocs/images/svg/util.svg
  AL    xdocs/index.xml
  AL    xdocs/introduction.xml
  AL    xdocs/issue-tracking.xml
  AL    xdocs/manual/index.xml
  AL    xdocs/manual/options.xml
  AL    xdocs/manual/validators.xml
  AL    xdocs/navigation.xml
  AL    xdocs/properties.xml
  AL    xdocs/release_1_0.xml
 !????? xdocs/style/project.css
  AL    xdocs/upgrading-1.0-to-1.1.xml
  AL    xdocs/usage.xml
 
 *****************************************************
 Printing headers for files without AL header...
 
 
 =======================================================================
 ==build-gump.xml
 =======================================================================
 <!--

  WARNING: This file is generated! Do not edit by hand!
  
-->

<project name="maven" default="jar" basedir=".">

  <target
    name="jar">
    
    <property name="maven.build.dir" value="target"/>
    <property name="maven.build.dest" value="${maven.build.dir}/classes"/>
    
    <mkdir dir="${maven.build.dest}"/>
    
    <javac
      destdir="${maven.build.dest}"
      excludes="**/package.html"
      debug="false"
      deprecation="false"
      optimize="false">
      <src>
         <pathelement location="src/java"/>
      </src>
    </javac>

    <jar
      jarfile="${maven.build.dir}/${maven.final.name}.jar"
      basedir="${maven.build.dest}"
      excludes="**/package.html"
    />
    
  </target>

</project>

 =======================================================================
 ==doap_cli.rdf
 =======================================================================
 <?xml version="1.0"?>
<rdf:RDF xmlns="http://usefulinc.com/ns/doap#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:asfext="http://projects.apache.org/ns/asfext#" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#" xmlns:doap="http://usefulinc.com/ns/doap#" xml:lang="en">
  <Project rdf:about="http://commons.apache.org/cli/">
    <name>Apache Commons CLI</name>
    <homepage rdf:resource="http://commons.apache.org/cli/"/>
    <programming-language>Java</programming-language>
    <category rdf:resource="http://projects.apache.org/category/library"/>
    <license rdf:resource="http://usefulinc.com/doap/licenses/asl20"/>
    <bug-database rdf:resource="http://issues.apache.org/jira/browse/CLI"/>
    <download-page rdf:resource="http://jakarta.apache.org/site/downloads/downloads_commons-cli.cgi"/>
    <asfext:pmc rdf:resource="http://commons.apache.org/"/>
    <shortdesc xml:lang="en">Commons CLI</shortdesc>
    <description xml:lang="en">
    Commons CLI provides a simple API for presenting, proecessing and
    validating a command line interface.
  </description>
    <repository>
      <SVNRepository>
        <browse rdf:resource="http://svn.apache.org/repos/asf/commons/proper/cli/trunk"/>
        <location rdf:resource="http://svn.apache.org/repos/asf/commons/proper/cli"/>
      </SVNRepository>
    </repository>
    <release>
      <revision>
        <name>commons-cli</name>
        <created>2002-12-27</created>
        <version>1.0</version>
      </revision>
    </release>
    <mailing-list rdf:resource="http://commons.apache.org/mail-lists.html"/>
  </Project>
</rdf:RDF>

 =======================================================================
 ==project.properties
 =======================================================================
 # -------------------------------------------------------------------
# P R O J E C T  P R O P E R T I E S
# -------------------------------------------------------------------
maven.repo.remote=http://repo1.maven.org/maven

maven.changelog.factory=org.apache.maven.svnlib.SvnChangeLogFactory

maven.changes.issue.template=http://issues.apache.org/jira/browse/%ISSUE%

compile.debug = on
compile.optimize = off
compile.deprecation = off

maven.compile.source=1.3
maven.compile.target=1.3

maven.jarResources.basedir=${basedir}/src/java

# Reset the checkstyle properties to use the default sun settings
maven.checkstyle.properties=
maven.checkstyle.format=sun

maven.xdoc.date=left
maven.xdoc.version=${pom.currentVersion}
maven.xdoc.developmentProcessUrl=http://commons.apache.org/charter.html
maven.xdoc.poweredby.image=maven-feather.png

maven.javadoc.links=http://java.sun.com/j2se/1.4/docs/api/

# Jar Manifest and Additional Attributes
maven.jar.manifest=${basedir}/src/conf/MANIFEST.MF
maven.jar.manifest.attributes.list=Implementation-Vendor-Id,X-Compile-Source-JDK,X-Compile-Target-JDK
maven.jar.manifest.attribute.Implementation-Vendor-Id=org.apache
maven.jar.manifest.attribute.X-Compile-Source-JDK=${maven.compile.source}
maven.jar.manifest.attribute.X-Compile-Target-JDK=${maven.compile.target}

 =======================================================================
 ==src/conf/MANIFEST.MF
 =======================================================================
 Implementation-Title: Apache Commons CLI2

Name: org/apache/commons/cli2/
Specification-Title: Apache Commons CLI2
Specification-Vendor: Apache Software Foundation
Specification-Version: 2.0

 =======================================================================
 ==src/java/org/apache/commons/cli2/resource/CLIMessageBundle_en_US.properties
 =======================================================================
 ClassValidator.bad.classname = The class name "{0}" is invalid.
ClassValidator.class.notfound = The class "{0}" could not be found.
ClassValidator.class.access = The class "{0}" could not be accessed.  Reason: {1}.
ClassValidator.class.create = The class "{0}" could not be created.

DateValidator.date.OutOfRange = Date ''{0}'' is out of range.

NumberValidator.number.OutOfRange = Number ''{0}'' is out of range.

URLValidator.malformed.URL = Cannot understand URL: ''{0}''.

Argument.unexpected.value = Unexpected value "{0}" found while processing 
Argument.minimum.exceeds.maximum = Minimum number of values must not exceed maximum number
Argument.too.few.defaults = Not enough default values.
Argument.too.many.defaults = Too many default values.
Argument.missing.values = Missing value(s)
Argument.too.many.values = More than one value was supplied.

Option.trigger.needs.prefix = Trigger {0} must be prefixed with a value from {1}
Option.missing.required = Missing required option
Option.no.name = An option must have at least one name.
Option.illegal.short.prefix = The shortPrefix MUST be at least 1 character long.
Option.illegal.long.prefix = The longPrefix MUST be at least 1 character long.

Command.preferredName.too.short = The preferredName MUST be at least 1 character long.

SourceDest.must.enforce.values = The dest argument must enforce a fixed number of values.

Switch.illegal.enabled.prefix = The enabledPrefix MUST be at least 1 character long.
Switch.illegal.disabled.prefix = The disabledPrefix MUST be at least 1 character long.
Switch.identical.prefixes = The disabledPrefix and enabledPrefix MUST be different.
Switch.already.set = Switch already set.
Switch.no.enabledPrefix = An enabledPrefix must be supplied.
Switch.no.disabledPrefix = A disabledPrefix must be supplied.
Switch.enabled.startsWith.disabled = The enabledPrefix cannot start the same as disabledPrefix.
Switch.disabled.startsWith.enabled = The disabledPrefix cannot start the same as enabledPrefix.
Switch.preferredName.too.short = The preferredName MUST be at least 1 character long.

HelpFormatter.gutter.too.long = The gutter strings leave no space for output! \
    Supply shorter gutters or more width.
HelpFormatter.width.too.narrow = The HelpFormatter width is too narrow: "{0}".                
          
Enum.illegal.value =  ''{0}'' is not allowed.  Permitted values are: {1}
                    
Unexpected.token = Unexpected {0} while processing
Missing.option = Missing option
Cannot.burst = Could not burst "{0}" while processing 

ArgumentBuilder.null.consume.remaining = Cannot use 'null' as the consume remaining token.
ArgumentBuilder.empty.consume.remaining = Cannot use an empty string as the consume remaining token.

 =======================================================================
 ==src/java/org/apache/commons/cli2/validation/package.html
 =======================================================================
 <html>
<body>
Provides classes and interfaces for validating argument values.

These classes are capable of validating argument values of the following type:

<ul>
    <li>file/directory</li>
    <li>number</li>
    <li>date/time</li>
    <li>URL</li>
    <li>enumeration</li>
    <li>class</li>
</ul>
</body>
</html>

 =======================================================================
 ==src/test/data/.hidden.txt
 =======================================================================
 Hidden text file.

 =======================================================================
 ==src/test/data/readable.txt
 =======================================================================
 Readable text file.

 =======================================================================
 ==src/test/data/writable.txt
 =======================================================================
 Writable text file.

 =======================================================================
 ==src/test/org/apache/commons/cli2/bug/BugCLI122Test.java
 =======================================================================
 package org.apache.commons.cli2.bug;

import junit.framework.TestCase;
import org.apache.commons.cli2.*;
import org.apache.commons.cli2.builder.ArgumentBuilder;
import org.apache.commons.cli2.builder.DefaultOptionBuilder;
import org.apache.commons.cli2.builder.GroupBuilder;
import org.apache.commons.cli2.commandline.Parser;
import org.apache.commons.cli2.validation.FileValidator;

/**
 * @author brianegge
 */
public class BugCLI122Test extends TestCase {
    public void testArgumentWhichStartsWithDash() throws OptionException {
        Argument wdArg = new ArgumentBuilder()
                .withName("anything")
                .withMaximum(1)
                .withMinimum(1)
                .withInitialSeparator('=')
                .create();

        Option wdOpt = new DefaultOptionBuilder().withArgument(wdArg)
                .withDescription("anything, foo or -foo")
                .withLongName("argument")
                .withShortName("a")
                .create();

        Group group = new GroupBuilder().withOption(wdOpt).create();

        Parser p = new Parser();
        p.setGroup(group);
        CommandLine normal = p.parse (new String[]{"-a", "foo"});
        assertNotNull(normal);
        assertEquals(normal.getValue(wdOpt), "foo");

        CommandLine withDash = p.parse (new String[]{"--argument", "\"-foo\""});
        assertNotNull(withDash);
        assertEquals("-foo", withDash.getValue(wdOpt));

        CommandLine withDashAndEquals = p.parse (new String[]{"--argument=-foo"});
        assertNotNull(withDashAndEquals);
        assertEquals("-foo", withDashAndEquals.getValue(wdOpt));
    }
}

 =======================================================================
 ==src/test/org/apache/commons/cli2/resource/TestBundle.properties
 =======================================================================
 ClassValidator.bad.classname = The class name "{0}" is invalid.

test.message = Some might say we will find a brighter day.

test.message1 = {0} might say we will find a brighter day.

test.message2 = {0} {1} say we will find a brighter day.

test.message3 = {0} {1} {2} we will find a brighter day.


 =======================================================================
 ==xdocs/style/project.css
 =======================================================================
 @import url("http://commons.apache.org/style/commons-maven.css");