blob: 82b65b97671409683cc092c4746180275d2204c8 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2016-09-04 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Apache Rat™ &#x2013; A Release Audit Tool</title>
<style type="text/css" media="all">
@import url("./css/maven-base.css");
@import url("./css/maven-theme.css");
@import url("./css/site.css");
</style>
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
<meta name="Date-Revision-yyyymmdd" content="20160904" />
<meta http-equiv="Content-Language" content="en" />
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Mate+SC" type="text/css"/>
</head>
<body class="composite">
<div id="banner">
<a href="https://www.apache.org/" id="bannerLeft">
<img src="https://www.apache.org/img/asf_logo.png" alt="The Apache Software Foundation" title="The Apache Software Foundation" />
</a>
<div class="clear">
<hr/>
</div>
</div>
<div id="breadcrumbs">
<div class="xleft">
<span id="publishDate">Last Published: 2016-09-04</span>
&nbsp;| <span id="projectVersion">Version: 0.13-SNAPSHOT</span>
| <a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a>
&gt;
<a href="https://creadur.apache.org/" class="externalLink" title="Creadur">Creadur</a>
&gt;
<a href="https://creadur.apache.org/rat/" class="externalLink" title="Rat">Rat</a>
&gt;
A Release Audit Tool
</div>
<div class="xright">
</div>
<div class="clear">
<hr/>
</div>
</div>
<div id="leftColumn">
<div id="navcolumn">
<h5>Apache Rat™</h5>
<ul>
<li class="none">
<strong>Introducing Rat</strong>
</li>
<li class="none">
<a href="apidocs/index.html" title="Javadocs">Javadocs</a>
</li>
<li class="none">
<a href="download_rat.cgi" title="Downloads">Downloads</a>
</li>
<li class="none">
<a href="RELEASE_NOTES.txt" title="Changes">Changes</a>
</li>
</ul>
<h5>Running Rat</h5>
<ul>
<li class="none">
<a href="apache-rat/index.html" title="From The Command Line">From The Command Line</a>
</li>
<li class="none">
<a href="apache-rat-tasks/index.html" title="With Ant">With Ant</a>
</li>
<li class="none">
<a href="apache-rat-plugin/index.html" title="With Maven">With Maven</a>
</li>
</ul>
<h5>Apache Creadur™</h5>
<ul>
<li class="none">
<a href="https://creadur.apache.org" class="externalLink" title="Creadur Project Home">Creadur Project Home</a>
</li>
<li class="none">
<a href="https://creadur.apache.org/tentacles" class="externalLink" title="Apache Tentacles">Apache Tentacles</a>
</li>
<li class="none">
<a href="https://creadur.apache.org/whisker" class="externalLink" title="Apache Whisker">Apache Whisker</a>
</li>
<li class="none">
<a href="https://www.apache.org/security/" class="externalLink" title="Security">Security</a>
</li>
<li class="none">
<a href="https://www.apache.org/licenses/" class="externalLink" title="License">License</a>
</li>
<li class="none">
<a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">Sponsorship</a>
</li>
<li class="none">
<a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
</li>
</ul>
<h5>The Apache Software Foundation</h5>
<ul>
<li class="none">
<a href="https://www.apache.org/foundation" class="externalLink" title="About the Foundation">About the Foundation</a>
</li>
<li class="none">
<a href="https://projects.apache.org" class="externalLink" title="The projects">The projects</a>
</li>
<li class="none">
<a href="https://people.apache.org" class="externalLink" title="The people">The people</a>
</li>
<li class="none">
<a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How we work">How we work</a>
</li>
<li class="none">
<a href="https://www.apache.org/foundation/how-it-works.html#history" class="externalLink" title="Our history">Our history</a>
</li>
<li class="none">
<a href="https://blogs.apache.org/foundation/" class="externalLink" title="News">News</a>
</li>
</ul>
<h5>Contribute</h5>
<ul>
<li class="none">
<a href="https://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved">Get Involved</a>
</li>
</ul>
<h5>Committer Info</h5>
<ul>
<li class="none">
<a href="https://www.apache.org/dev/committers.html" class="externalLink" title="ASF Committers' FAQ">ASF Committers' FAQ</a>
</li>
<li class="none">
<a href="https://www.apache.org/dev/new-committers-guide.html" class="externalLink" title="New Committers Guide">New Committers Guide</a>
</li>
<li class="none">
<a href="site-publish.html" title="Howto publish this site">Howto publish this site</a>
</li>
<li class="none">
<a href="https://planet.apache.org/committers/" class="externalLink" title="Plant Apache">Plant Apache</a>
</li>
<li class="none">
<a href="https://community.apache.org/" class="externalLink" title="Community">Community</a>
</li>
<li class="none">
<a href="https://www.apache.org/legal/" class="externalLink" title="Legal">Legal</a>
</li>
<li class="none">
<a href="https://www.apache.org/foundation/marks/" class="externalLink" title="Branding">Branding</a>
</li>
<li class="none">
<a href="https://www.apache.org/press/" class="externalLink" title="Media Relations">Media Relations</a>
</li>
</ul>
<h5>Modules</h5>
<ul>
<li class="none">
<a href="apache-rat-api/index.html" title="Apache Creadur Rat::API">Apache Creadur Rat::API</a>
</li>
<li class="none">
<a href="apache-rat-core/index.html" title="Apache Creadur Rat::Core">Apache Creadur Rat::Core</a>
</li>
<li class="none">
<a href="apache-rat-plugin/index.html" title="Apache Creadur Rat::Plugin4Maven">Apache Creadur Rat::Plugin4Maven</a>
</li>
<li class="none">
<a href="apache-rat-tasks/index.html" title="Apache Creadur Rat::Tasks4Ant">Apache Creadur Rat::Tasks4Ant</a>
</li>
<li class="none">
<a href="apache-rat/index.html" title="Apache Creadur Rat::Command Line">Apache Creadur Rat::Command Line</a>
</li>
</ul>
<h5>Project Documentation</h5>
<ul>
<li class="collapsed">
<a href="project-info.html" title="Project Information">Project Information</a>
</li>
<li class="collapsed">
<a href="project-reports.html" title="Project Reports">Project Reports</a>
</li>
</ul>
<a href="https://maven.apache.org/" title="Maven" class="poweredBy">
<img class="poweredBy" alt="Maven" src="https://maven.apache.org/images/logos/maven-feather.png" />
</a>
</div>
</div>
<div id="bodyColumn">
<div id="contentBox">
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --><!-- 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. --><!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --><div class="section">
<h2><a name="Apache_Rat"></a>Apache Rat</h2>
<p>In a hurry? Jump to <a href="#Quick_Start:_Running_Rat">quick start</a></p>
<ul>
<li><a href="#About_Rat">About Rat</a>
<ul>
<li><a href="#What_Is_Rat">What Is Rat?</a></li>
<li><a href="#Rat_Is_Used_To...">Rat Is Used To...?</a></li>
<li><a href="#Why_Develop_Rat">Why Develop Rat?</a></li>
<li><a href="#How_Do_I_Use_Rat">How Do I Use Rat?</a></li>
<li><a href="#Who_Develops_Rat">Who Develops Rat?</a></li></ul></li>
<li><a href="#Quick_Start:_Running_Rat">Quick Start: Running Rat</a>
<ul>
<li><a href="#Command_Line">Command Line</a></li>
<li><a href="#Apache_Ant">Apache Ant</a></li>
<li><a href="#Apache_Maven">Apache Maven</a></li></ul></li>
<li><a href="#Checking_Out_Rat">Checking Out Rat</a></li>
<li><a href="#Building_Rat">Building Rat</a></li></ul>
<div class="section">
<h3><a name="About_Rat"></a>About Rat</h3>
<div class="section">
<h4><a name="What_Is_Rat"></a>What Is Rat?</h4>
<p>Apache Rat is a release audit tool, focused on licenses.</p></div>
<div class="section">
<h4><a name="Rat_Is_Used_To..."></a>Rat Is Used To...?</h4>
<p>Use Rat to improve accuracy and efficiency when checking releases for licenses.</p></div>
<div class="section">
<h4><a name="Why_Develop_Rat"></a>Why Develop Rat?</h4>
<p>Reviewing releases in the <a class="externalLink" href="http://incubator.apache.org/">Apache Incubator</a> by hand was error-prone and time-consuming.</p>
<p>Rat arises from the Apache style, but is used more widely. If your release style isn't supported, <a href="./mail-lists.html">talk to us</a>.</p></div>
<div class="section">
<h4><a name="How_Do_I_Use_Rat"></a>How Do I Use Rat?</h4>
<p>Apache Rat 0.13-SNAPSHOT ships with tooling for</p>
<ul>
<li><a class="externalLink" href="https://ant.apache.org/"> Apache Ant</a>,</li>
<li><a class="externalLink" href="https://maven.apache.org">Apache Maven</a> and</li>
<li>the command line.</li></ul>
<p>Rat is extensible. If your build tool isn't supported, please contribute a <a href="./issue-tracking.html">patch</a> or <a href="./mail-lists.html">talk to us</a>.</p>
<p>Rat aspires to be self documenting. Please contribute a <a href="./issue-tracking.html">patch</a> or <a href="./mail-lists.html">talk to us</a> whenever Rat falls short.</p></div>
<div class="section">
<h4><a name="Who_Develops_Rat"></a>Who Develops Rat?</h4>
<p>Apache Rat is part of the <a class="externalLink" href="https://creadur.apache.org">Apache Creadur</a> language- and build-agnostic suite of tools for auditing and comprehending software distributions. Our community develops <a class="externalLink" href="http://www.opensource.org/"> open source software</a> the <a class="externalLink" href="https://www.apache.org/foundation/how-it-works.html"> Apache way</a>.</p>
<p>Please feel free to contribute a <a href="./issue-tracking.html">patch</a>, <a class="externalLink" href="http://c2.com/cgi/wiki?TestDrivenDevelopment">demonstrate</a> a <a href="./issue-tracking.html">bug</a>, or just <a href="./mail-lists.html">talk to us</a>. All welcome :-)</p></div></div>
<div class="section">
<h3><a name="Quick_Start:_Running_Rat"></a>Quick Start: Running Rat</h3>
<div class="section">
<h4><a name="Command_Line"></a>Command Line</h4>
<p>Quick start by</p>
<div class="source">
<pre>java -jar apache-rat-0.13-SNAPSHOT.jar --help</pre></div>
<p>Read more <a href="./apache-rat/index.html">here</a>.</p></div>
<div class="section">
<h4><a name="Apache_Ant"></a>Apache Ant</h4>
<p>Use the task library for <a class="externalLink" href="https://ant.apache.org/"> Apache Ant 1.7</a> or later</p>
<p>Read more <a href="./apache-rat-tasks/index.html"> here</a>.</p></div>
<div class="section">
<h4><a name="Apache_Maven"></a>Apache Maven</h4>
<p>Use the plugin for <a class="externalLink" href="https://maven.apache.org">Apache Maven 2.2.1</a> or later.</p>
<div class="source">
<pre> &lt;plugin&gt;
&lt;groupId&gt;org.apache.rat&lt;/groupId&gt;
&lt;artifactId&gt;apache-rat-plugin&lt;/artifactId&gt;
&lt;version&gt;0.13-SNAPSHOT&lt;/version&gt;
&lt;/plugin&gt;</pre></div>
<p>Read more <a href="./apache-rat-plugin/index.html"> here</a>.</p></div></div>
<div class="section">
<h3><a name="Checking_Out_Rat"></a>Checking Out Rat</h3>
<p>Quick start</p>
<div class="source">
<pre>svn co http://svn.apache.org/repos/asf/creadur/rat/trunk/</pre></div>
<p>Read more <a href="./source-repository.html">here</a>.</p></div>
<div class="section">
<h3><a name="Building_Rat"></a>Building Rat</h3>
<p>Build Rat with <a class="externalLink" href="https://maven.apache.org/"> Apache Maven</a></p>
<p>Quick start</p>
<p>If you want to build RAT just launch 'mvn' inside the root folder. It will automatically perform a </p>
<div class="source">
<pre>mvn clean install</pre></div></div></div>
</div>
</div>
<div class="clear">
<hr/>
</div>
<div id="footer">
<div class="xright">
<?xml version="1.0" encoding="UTF-8"?>
<footer>Copyright © 2016 The Apache Software Foundation, Licensed under the Apache License, Version 2.0.
Apache Creadur, Creadur, Apache Rat, Apache Tentacles, Apache Whisker, Apache and the Apache feather logo are trademarks
of The Apache Software Foundation.
Oracle and Java are registered trademarks of Oracle and/or its affiliates.
All other marks mentioned may be trademarks or registered trademarks of their respective owners.</footer>
</div>
<div class="clear">
<hr/>
</div>
</div>
</body>
</html>