Added: dev/buildr/1.5.0/site/rdoc/Buildr/ActsAsArtifact.html
==============================================================================
--- dev/buildr/1.5.0/site/rdoc/Buildr/ActsAsArtifact.html (added)
+++ dev/buildr/1.5.0/site/rdoc/Buildr/ActsAsArtifact.html Sat Sep 17 06:18:39 
2016
@@ -0,0 +1,989 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta charset="UTF-8">
+
+<title>module Buildr::ActsAsArtifact - buildr</title>
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "../";
+</script>
+
+<script src="../js/jquery.js"></script>
+<script src="../js/darkfish.js"></script>
+
+<link href="../css/fonts.css" rel="stylesheet">
+<link href="../css/rdoc.css" rel="stylesheet">
+
+
+
+<body id="top" role="document" class="module">
+<nav role="navigation">
+  <div id="project-navigation">
+    <div id="home-section" role="region" title="Quick navigation" 
class="nav-section">
+  <h2>
+    <a href="../index.html" rel="home">Home</a>
+  </h2>
+
+  <div id="table-of-contents-navigation">
+    <a href="../table_of_contents.html#pages">Pages</a>
+    <a href="../table_of_contents.html#classes">Classes</a>
+    <a href="../table_of_contents.html#methods">Methods</a>
+  </div>
+</div>
+
+    <div id="search-section" role="search" class="project-section 
initially-hidden">
+  <form action="#" method="get" accept-charset="utf-8">
+    <div id="search-field-wrapper">
+      <input id="search-field" role="combobox" aria-label="Search"
+             aria-autocomplete="list" aria-controls="search-results"
+             type="text" name="search" placeholder="Search" spellcheck="false"
+             title="Type to search, Up and Down to navigate, Enter to load">
+    </div>
+
+    <ul id="search-results" aria-label="Search Results"
+        aria-busy="false" aria-expanded="false"
+        aria-atomic="false" class="initially-hidden"></ul>
+  </form>
+</div>
+
+  </div>
+
+  
+
+  <div id="class-metadata">
+    
+    
+    
+    
+    <!-- Method Quickref -->
+<div id="method-list-section" class="nav-section">
+  <h3>Methods</h3>
+
+  <ul class="link-list" role="directory">
+    
+    <li ><a href="#method-i-apply_spec">#apply_spec</a>
+    
+    <li ><a href="#method-i-extract_type">#extract_type</a>
+    
+    <li ><a href="#method-i-final_version">#final_version</a>
+    
+    <li ><a href="#method-i-group_path">#group_path</a>
+    
+    <li ><a href="#method-i-install">#install</a>
+    
+    <li ><a href="#method-i-javadoc_artifact">#javadoc_artifact</a>
+    
+    <li ><a href="#method-i-maven_metadata_xml">#maven_metadata_xml</a>
+    
+    <li ><a href="#method-i-pom">#pom</a>
+    
+    <li ><a href="#method-i-pom_xml">#pom_xml</a>
+    
+    <li ><a href="#method-i-snapshot-3F">#snapshot?</a>
+    
+    <li ><a href="#method-i-sources_artifact">#sources_artifact</a>
+    
+    <li ><a href="#method-i-to_hash">#to_hash</a>
+    
+    <li ><a href="#method-i-to_spec">#to_spec</a>
+    
+    <li ><a href="#method-i-to_spec_hash">#to_spec_hash</a>
+    
+    <li ><a href="#method-i-uninstall">#uninstall</a>
+    
+    <li ><a href="#method-i-upload">#upload</a>
+    
+    <li ><a href="#method-i-upload_name">#upload_name</a>
+    
+    <li ><a href="#method-i-upload_task">#upload_task</a>
+    
+  </ul>
+</div>
+
+  </div>
+</nav>
+
+<main role="main" aria-labelledby="module-Buildr::ActsAsArtifact">
+  <h1 id="module-Buildr::ActsAsArtifact" class="module">
+    module Buildr::ActsAsArtifact
+  </h1>
+
+  <section class="description">
+    
+<p>Mixin with a task to make it behave like an artifact. Implemented by the
+packaging tasks.</p>
+
+<p>An artifact has an identifier, group identifier, type, version number and
+optional classifier. All can be used to locate it in the local repository,
+download from or upload to a remote repository.</p>
+
+<p>The <a href="ActsAsArtifact.html#method-i-to_spec">to_spec</a> and <a
+href="ActsAsArtifact.html#method-i-to_hash">to_hash</a> methods allow it to
+be used everywhere an artifact is accepted.</p>
+
+  </section>
+
+  
+  
+  
+  <section id="5Buntitled-5D" class="documentation-section">
+    
+
+    
+
+    
+    <section class="constants-list">
+      <header>
+        <h3>Constants</h3>
+      </header>
+      <dl>
+      
+        <dt id="ARTIFACT_ATTRIBUTES">ARTIFACT_ATTRIBUTES
+        
+        <dd>
+        
+      
+        <dt id="MAVEN_METADATA">MAVEN_METADATA
+        
+        <dd>
+        
+      
+      </dl>
+    </section>
+    
+
+    
+    <section class="attribute-method-details" class="method-section">
+      <header>
+        <h3>Attributes</h3>
+      </header>
+
+      
+      <div id="attribute-i-classifier" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">classifier</span><span
+            class="attribute-access-type">[R]</span>
+        </div>
+
+        <div class="method-description">
+        
+        <p>Optional artifact classifier.</p>
+        
+        </div>
+      </div>
+      
+      <div id="attribute-i-group" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">group</span><span
+            class="attribute-access-type">[R]</span>
+        </div>
+
+        <div class="method-description">
+        
+        <p>The group identifier.</p>
+        
+        </div>
+      </div>
+      
+      <div id="attribute-i-id" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">id</span><span
+            class="attribute-access-type">[R]</span>
+        </div>
+
+        <div class="method-description">
+        
+        <p>The artifact identifier.</p>
+        
+        </div>
+      </div>
+      
+      <div id="attribute-i-type" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">type</span><span
+            class="attribute-access-type">[R]</span>
+        </div>
+
+        <div class="method-description">
+        
+        <p>The file type. (Symbol)</p>
+        
+        </div>
+      </div>
+      
+      <div id="attribute-i-version" class="method-detail">
+        <div class="method-heading attribute-method-heading">
+          <span class="method-name">version</span><span
+            class="attribute-access-type">[R]</span>
+        </div>
+
+        <div class="method-description">
+        
+        <p>The version number.</p>
+        
+        </div>
+      </div>
+      
+    </section>
+    
+
+    
+     <section id="public-instance-5Buntitled-5D-method-details" 
class="method-section">
+       <header>
+         <h3>Public Instance Methods</h3>
+       </header>
+
+    
+      <div id="method-i-final_version" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">final_version</span><span
+            class="method-args">()</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+          <div class="method-source-code" id="final_version-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 80</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">final_version</span>
+  <span class="ruby-keyword">return</span> <span 
class="ruby-identifier">version</span> <span class="ruby-keyword">unless</span> 
<span class="ruby-identifier">snapshot?</span>
+  <span class="ruby-constant">Time</span>.<span 
class="ruby-identifier">now</span>.<span 
class="ruby-identifier">strftime</span>(<span 
class="ruby-string">&quot;%Y%m%d.%H%M%S&quot;</span>)
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-install" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">install</span><span
+            class="method-args">()</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+          <div class="method-source-code" id="install-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 182</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">install</span>
+  <span class="ruby-identifier">invoke</span>
+  <span class="ruby-identifier">in_local_repository</span> = <span 
class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">repositories</span>.<span 
class="ruby-identifier">locate</span>(<span class="ruby-keyword">self</span>)
+  <span class="ruby-keyword">if</span> <span 
class="ruby-identifier">pom</span> <span 
class="ruby-operator">&amp;&amp;</span> <span 
class="ruby-identifier">pom</span> <span class="ruby-operator">!=</span> <span 
class="ruby-keyword">self</span> <span class="ruby-operator">&amp;&amp;</span> 
<span class="ruby-identifier">classifier</span>.<span 
class="ruby-identifier">nil?</span>
+    <span class="ruby-identifier">pom</span>.<span 
class="ruby-identifier">invoke</span>
+    <span class="ruby-identifier">pom</span>.<span 
class="ruby-identifier">install</span>
+  <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">if</span> <span 
class="ruby-identifier">name</span> <span class="ruby-operator">!=</span> <span 
class="ruby-identifier">in_local_repository</span>
+    <span class="ruby-identifier">mkpath</span> <span 
class="ruby-constant">File</span>.<span 
class="ruby-identifier">dirname</span>(<span 
class="ruby-identifier">in_local_repository</span>)
+    <span class="ruby-identifier">cp</span> <span 
class="ruby-identifier">name</span>, <span 
class="ruby-identifier">in_local_repository</span>, <span 
class="ruby-value">:preserve</span> =<span class="ruby-operator">&gt;</span> 
<span class="ruby-keyword">false</span>
+    <span class="ruby-identifier">info</span> <span 
class="ruby-node">&quot;Installed #{name} to #{in_local_repository}&quot;</span>
+  <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-javadoc_artifact" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            javadoc_artifact &rarr; Artifact
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Convenience method that returns the associated javadoc 
artifact</p>
+          
+          
+
+          
+          <div class="method-source-code" id="javadoc_artifact-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 136</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">javadoc_artifact</span>
+  <span class="ruby-identifier">javadoc_spec</span> = <span 
class="ruby-identifier">to_spec_hash</span>.<span 
class="ruby-identifier">merge</span>(<span 
class="ruby-value">:classifier=</span><span 
class="ruby-operator">&gt;</span><span 
class="ruby-string">&#39;javadoc&#39;</span>)
+  <span class="ruby-identifier">javadoc_task</span> = <span 
class="ruby-constant">OptionalArtifact</span>.<span 
class="ruby-identifier">define_task</span>(<span 
class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">repositories</span>.<span 
class="ruby-identifier">locate</span>(<span 
class="ruby-identifier">javadoc_spec</span>))
+  <span class="ruby-identifier">javadoc_task</span>.<span 
class="ruby-identifier">send</span> <span 
class="ruby-value">:apply_spec</span>, <span 
class="ruby-identifier">javadoc_spec</span>
+  <span class="ruby-identifier">javadoc_task</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-maven_metadata_xml" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            maven_metadata_xml &rarr; string
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Creates Maven Metadata XML content for this artifact.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="maven_metadata_xml-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 165</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">maven_metadata_xml</span>
+  <span class="ruby-identifier">xml</span> = <span 
class="ruby-constant">Builder</span><span class="ruby-operator">::</span><span 
class="ruby-constant">XmlMarkup</span>.<span 
class="ruby-identifier">new</span>(<span 
class="ruby-value">:indent=</span><span class="ruby-operator">&gt;</span><span 
class="ruby-value">2</span>)
+  <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">instruct!</span>
+  <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">metadata</span> <span class="ruby-keyword">do</span>
+    <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">groupId</span>       <span 
class="ruby-identifier">group</span>
+    <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">artifactId</span>    <span 
class="ruby-identifier">id</span>
+    <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">version</span>       <span 
class="ruby-identifier">version</span>
+    <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">versioning</span> <span class="ruby-keyword">do</span>
+      <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">snapshot</span> <span class="ruby-keyword">do</span>
+        <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">timestamp</span> <span 
class="ruby-identifier">final_version</span>
+        <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">buildNumber</span> <span class="ruby-value">1</span>
+      <span class="ruby-keyword">end</span>
+      <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">lastupdated</span> <span 
class="ruby-constant">Time</span>.<span 
class="ruby-identifier">now</span>.<span 
class="ruby-identifier">strftime</span>(<span 
class="ruby-string">&quot;%Y%m%d%H%M%S&quot;</span>)
+    <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-pom" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            pom &rarr; Artifact
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Convenience method that returns a <a href="POM.html">POM</a> 
artifact.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="pom-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 116</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">pom</span>
+  <span class="ruby-keyword">return</span> <span 
class="ruby-keyword">self</span> <span class="ruby-keyword">if</span> <span 
class="ruby-identifier">type</span> <span class="ruby-operator">==</span> <span 
class="ruby-value">:pom</span>
+  <span class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">artifact</span>(<span 
class="ruby-value">:group=</span><span class="ruby-operator">&gt;</span><span 
class="ruby-identifier">group</span>, <span class="ruby-value">:id=</span><span 
class="ruby-operator">&gt;</span><span class="ruby-identifier">id</span>, <span 
class="ruby-value">:version=</span><span class="ruby-operator">&gt;</span><span 
class="ruby-identifier">version</span>, <span 
class="ruby-value">:type=</span><span class="ruby-operator">&gt;</span><span 
class="ruby-value">:pom</span>)
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-pom_xml" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            pom_xml &rarr; string
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Creates <a href="POM.html">POM</a> XML for this artifact.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="pom_xml-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 147</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">pom_xml</span>
+  <span class="ruby-constant">Proc</span>.<span 
class="ruby-identifier">new</span> <span class="ruby-keyword">do</span>
+    <span class="ruby-identifier">xml</span> = <span 
class="ruby-constant">Builder</span><span class="ruby-operator">::</span><span 
class="ruby-constant">XmlMarkup</span>.<span 
class="ruby-identifier">new</span>(<span 
class="ruby-value">:indent=</span><span class="ruby-operator">&gt;</span><span 
class="ruby-value">2</span>)
+    <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">instruct!</span>
+    <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">project</span> <span class="ruby-keyword">do</span>
+      <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">modelVersion</span>  <span 
class="ruby-string">&#39;4.0.0&#39;</span>
+      <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">groupId</span>       <span 
class="ruby-identifier">group</span>
+      <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">artifactId</span>    <span 
class="ruby-identifier">id</span>
+      <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">version</span>       <span 
class="ruby-identifier">version</span>
+      <span class="ruby-identifier">xml</span>.<span 
class="ruby-identifier">classifier</span>    <span 
class="ruby-identifier">classifier</span> <span class="ruby-keyword">if</span> 
<span class="ruby-identifier">classifier</span>
+    <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-snapshot-3F" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">snapshot?</span><span
+            class="method-args">()</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+          <div class="method-source-code" id="snapshot-3F-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 76</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">snapshot?</span>
+  <span class="ruby-identifier">version</span> <span 
class="ruby-operator">=~</span> <span class="ruby-regexp">/-SNAPSHOT$/</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-sources_artifact" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            sources_artifact &rarr; Artifact
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Convenience method that returns a sources artifact.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="sources_artifact-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 125</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">sources_artifact</span>
+  <span class="ruby-identifier">sources_spec</span> = <span 
class="ruby-identifier">to_spec_hash</span>.<span 
class="ruby-identifier">merge</span>(<span 
class="ruby-value">:classifier=</span><span 
class="ruby-operator">&gt;</span><span 
class="ruby-string">&#39;sources&#39;</span>)
+  <span class="ruby-identifier">sources_task</span> = <span 
class="ruby-constant">OptionalArtifact</span>.<span 
class="ruby-identifier">define_task</span>(<span 
class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">repositories</span>.<span 
class="ruby-identifier">locate</span>(<span 
class="ruby-identifier">sources_spec</span>))
+  <span class="ruby-identifier">sources_task</span>.<span 
class="ruby-identifier">send</span> <span 
class="ruby-value">:apply_spec</span>, <span 
class="ruby-identifier">sources_spec</span>
+  <span class="ruby-identifier">sources_task</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-to_hash" class="method-detail method-alias">
+        
+        <div class="method-heading">
+          <span class="method-name">to_hash</span><span
+            class="method-args">()</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+        </div>
+
+        
+
+        
+        <div class="aliases">
+          Alias for: <a 
href="ActsAsArtifact.html#method-i-to_spec_hash">to_spec_hash</a>
+        </div>
+        
+      </div>
+
+    
+      <div id="method-i-to_spec" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            to_spec &rarr; String
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Returns the artifact specification, in the structure:</p>
+
+<pre>&lt;group&gt;:&lt;artifact&gt;:&lt;type&gt;:&lt;version&gt;</pre>
+
+<p>or</p>
+
+<pre>&lt;group&gt;:&lt;artifact&gt;:&lt;type&gt;:&lt;classifier&gt;:&lt;version&gt;</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="to_spec-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 108</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">to_spec</span>
+  <span class="ruby-identifier">classifier</span> <span 
class="ruby-operator">?</span> <span 
class="ruby-node">&quot;#{group}:#{id}:#{type}:#{classifier}:#{version}&quot;</span>
 <span class="ruby-operator">:</span> <span 
class="ruby-node">&quot;#{group}:#{id}:#{type}:#{version}&quot;</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-to_spec_hash" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            to_spec_hash &rarr; Hash
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Returns the artifact specification as a hash. For example:</p>
+
+<pre>com.example:app:jar:1.2</pre>
+
+<p>becomes:</p>
+
+<pre class="ruby">{ :<span class="ruby-identifier">group=</span><span 
class="ruby-operator">&gt;</span><span 
class="ruby-string">&#39;com.example&#39;</span>,
+  :<span class="ruby-identifier">id=</span><span 
class="ruby-operator">&gt;</span><span class="ruby-string">&#39;app&#39;</span>,
+  :<span class="ruby-identifier">type=</span><span 
class="ruby-operator">&gt;</span>:<span class="ruby-identifier">jar</span>,
+  :<span class="ruby-identifier">version=</span><span 
class="ruby-operator">&gt;</span><span class="ruby-string">&#39;1.2&#39;</span> 
}
+</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="to_spec_hash-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 95</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">to_spec_hash</span>
+  <span class="ruby-identifier">base</span> = { <span 
class="ruby-value">:group=</span><span class="ruby-operator">&gt;</span><span 
class="ruby-identifier">group</span>, <span class="ruby-value">:id=</span><span 
class="ruby-operator">&gt;</span><span class="ruby-identifier">id</span>, <span 
class="ruby-value">:type=</span><span class="ruby-operator">&gt;</span><span 
class="ruby-identifier">type</span>, <span 
class="ruby-value">:version=</span><span class="ruby-operator">&gt;</span><span 
class="ruby-identifier">version</span> }
+  <span class="ruby-identifier">classifier</span> <span 
class="ruby-operator">?</span> <span class="ruby-identifier">base</span>.<span 
class="ruby-identifier">merge</span>(<span 
class="ruby-value">:classifier=</span><span 
class="ruby-operator">&gt;</span><span 
class="ruby-identifier">classifier</span>) <span class="ruby-operator">:</span> 
<span class="ruby-identifier">base</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+        <div class="aliases">
+          Also aliased as: <a 
href="ActsAsArtifact.html#method-i-to_hash">to_hash</a>
+        </div>
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-uninstall" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">uninstall</span><span
+            class="method-args">()</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+          <div class="method-source-code" id="uninstall-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 196</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">uninstall</span>
+  <span class="ruby-identifier">installed</span> = <span 
class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">repositories</span>.<span 
class="ruby-identifier">locate</span>(<span class="ruby-keyword">self</span>)
+  <span class="ruby-identifier">rm</span> <span 
class="ruby-identifier">installed</span> <span class="ruby-keyword">if</span> 
<span class="ruby-constant">File</span>.<span 
class="ruby-identifier">exist?</span>(<span 
class="ruby-identifier">installed</span>)
+  <span class="ruby-identifier">pom</span>.<span 
class="ruby-identifier">uninstall</span> <span class="ruby-keyword">if</span> 
<span class="ruby-identifier">pom</span> <span 
class="ruby-operator">&amp;&amp;</span> <span 
class="ruby-identifier">pom</span> <span class="ruby-operator">!=</span> <span 
class="ruby-keyword">self</span> <span class="ruby-operator">&amp;&amp;</span> 
<span class="ruby-identifier">classifier</span>.<span 
class="ruby-identifier">nil?</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-upload" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            upload
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            upload(url)
+          </span>
+          
+        </div>
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            upload(options)
+          </span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Uploads the artifact, its <a href="POM.html">POM</a> and digital 
signatures
+to remote server.</p>
+
+<p>In the first form, uses the upload options specified by
+repositories.release_to or repositories.snapshot_to if the subject is a
+snapshot artifact. In the second form, uses a URL that includes all the
+relevant information. In the third form, uses a hash with the options :url,
+:username, :password, and :permissions. All but :url are optional.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="upload-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 214</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">upload</span>(<span 
class="ruby-identifier">upload_to</span> = <span 
class="ruby-keyword">nil</span>)
+  <span class="ruby-identifier">upload_task</span>(<span 
class="ruby-identifier">upload_to</span>).<span 
class="ruby-identifier">invoke</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-upload_task" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">upload_task</span><span
+            class="method-args">(upload_to = nil)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+          <div class="method-source-code" id="upload_task-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 218</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">upload_task</span>(<span 
class="ruby-identifier">upload_to</span> = <span 
class="ruby-keyword">nil</span>)
+  <span class="ruby-identifier">upload_to</span> <span 
class="ruby-operator">||=</span> <span 
class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">repositories</span>.<span 
class="ruby-identifier">snapshot_to</span> <span class="ruby-keyword">if</span> 
<span class="ruby-identifier">snapshot?</span> <span 
class="ruby-operator">&amp;&amp;</span> <span 
class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">repositories</span>.<span 
class="ruby-identifier">snapshot_to</span> <span 
class="ruby-operator">!=</span> <span class="ruby-keyword">nil</span> <span 
class="ruby-operator">&amp;&amp;</span> <span 
class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">repositories</span>.<span 
class="ruby-identifier">snapshot_to</span>[<span 
class="ruby-value">:url</span>] <span class="ruby-operator">!=</span> <span 
class="ruby-keyword">nil</span>
+  <span class="ruby-identifier">upload_to</span> <span 
class="ruby-operator">||=</span> <span 
class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">repositories</span>.<span 
class="ruby-identifier">release_to</span>
+  <span class="ruby-identifier">upload_to</span> = { <span 
class="ruby-value">:url=</span><span class="ruby-operator">&gt;</span><span 
class="ruby-identifier">upload_to</span> } <span 
class="ruby-keyword">unless</span> <span class="ruby-constant">Hash</span> 
<span class="ruby-operator">===</span> <span 
class="ruby-identifier">upload_to</span>
+  <span class="ruby-identifier">raise</span> <span 
class="ruby-constant">ArgumentError</span>, <span 
class="ruby-string">&#39;Don\t know where to upload, perhaps you forgot to set 
repositories.release_to&#39;</span> <span class="ruby-keyword">unless</span> 
<span class="ruby-identifier">upload_to</span>[<span 
class="ruby-value">:url</span>]
+
+  <span class="ruby-comment"># Set the upload URI, including mandatory slash 
(we expect it to be the base directory).</span>
+  <span class="ruby-comment"># Username/password may be part of URI, or 
separate entities.</span>
+  <span class="ruby-identifier">uri</span> = <span 
class="ruby-constant">URI</span>.<span 
class="ruby-identifier">parse</span>(<span 
class="ruby-identifier">upload_to</span>[<span 
class="ruby-value">:url</span>].<span class="ruby-identifier">clone</span>)
+  <span class="ruby-identifier">uri</span>.<span 
class="ruby-identifier">path</span> = <span 
class="ruby-identifier">uri</span>.<span class="ruby-identifier">path</span> 
<span class="ruby-operator">+</span> <span 
class="ruby-string">&#39;/&#39;</span> <span class="ruby-keyword">unless</span> 
<span class="ruby-identifier">uri</span>.<span 
class="ruby-identifier">path</span>[<span class="ruby-value">-1</span>] <span 
class="ruby-operator">==</span> <span class="ruby-string">&#39;/&#39;</span>
+  <span class="ruby-identifier">uri</span>.<span 
class="ruby-identifier">user</span> = <span 
class="ruby-identifier">upload_to</span>[<span 
class="ruby-value">:username</span>] <span class="ruby-keyword">if</span> <span 
class="ruby-identifier">upload_to</span>[<span 
class="ruby-value">:username</span>]
+  <span class="ruby-identifier">uri</span>.<span 
class="ruby-identifier">password</span> = <span 
class="ruby-identifier">upload_to</span>[<span 
class="ruby-value">:password</span>] <span class="ruby-keyword">if</span> <span 
class="ruby-identifier">upload_to</span>[<span 
class="ruby-value">:password</span>]
+
+  <span class="ruby-identifier">path</span> = <span 
class="ruby-identifier">group</span>.<span 
class="ruby-identifier">gsub</span>(<span 
class="ruby-string">&#39;.&#39;</span>, <span 
class="ruby-string">&#39;/&#39;</span>) <span class="ruby-operator">+</span> 
<span class="ruby-node">&quot;/#{id}/#{version}/#{upload_name}&quot;</span>
+
+  <span class="ruby-keyword">unless</span> <span 
class="ruby-identifier">task</span> = <span 
class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">application</span>.<span 
class="ruby-identifier">lookup</span>(<span 
class="ruby-identifier">uri</span><span class="ruby-operator">+</span><span 
class="ruby-identifier">path</span>)
+    <span class="ruby-identifier">deps</span> = [<span 
class="ruby-keyword">self</span>]
+    <span class="ruby-identifier">deps</span> <span 
class="ruby-operator">&lt;&lt;</span> <span 
class="ruby-identifier">pom</span>.<span 
class="ruby-identifier">upload_task</span>( <span 
class="ruby-identifier">upload_to</span> ) <span class="ruby-keyword">if</span> 
<span class="ruby-identifier">pom</span> <span 
class="ruby-operator">&amp;&amp;</span> <span 
class="ruby-identifier">pom</span> <span class="ruby-operator">!=</span> <span 
class="ruby-keyword">self</span> <span class="ruby-operator">&amp;&amp;</span> 
<span class="ruby-identifier">classifier</span>.<span 
class="ruby-identifier">nil?</span>
+
+    <span class="ruby-identifier">task</span> = <span 
class="ruby-constant">Rake</span><span class="ruby-operator">::</span><span 
class="ruby-constant">Task</span>.<span 
class="ruby-identifier">define_task</span> <span 
class="ruby-identifier">uri</span> <span class="ruby-operator">+</span> <span 
class="ruby-identifier">path</span> =<span class="ruby-operator">&gt;</span> 
<span class="ruby-identifier">deps</span> <span class="ruby-keyword">do</span>
+      <span class="ruby-comment"># Upload artifact relative to base URL, need 
to create path before uploading.</span>
+      <span class="ruby-identifier">options</span> = <span 
class="ruby-identifier">upload_to</span>[<span 
class="ruby-value">:options</span>] <span class="ruby-operator">||</span> 
{<span class="ruby-value">:permissions</span> =<span 
class="ruby-operator">&gt;</span> <span 
class="ruby-identifier">upload_to</span>[<span 
class="ruby-value">:permissions</span>]}
+      <span class="ruby-identifier">info</span> <span 
class="ruby-node">&quot;Deploying #{to_spec}&quot;</span>
+      <span class="ruby-constant">URI</span>.<span 
class="ruby-identifier">upload</span> <span class="ruby-identifier">uri</span> 
<span class="ruby-operator">+</span> <span class="ruby-identifier">path</span>, 
<span class="ruby-identifier">name</span>, <span 
class="ruby-identifier">options</span>
+      <span class="ruby-keyword">if</span> <span 
class="ruby-identifier">snapshot?</span> <span 
class="ruby-operator">&amp;&amp;</span> <span 
class="ruby-identifier">pom</span> <span class="ruby-operator">!=</span> <span 
class="ruby-keyword">self</span>
+         <span class="ruby-identifier">maven_metadata</span> = <span 
class="ruby-identifier">group</span>.<span 
class="ruby-identifier">gsub</span>(<span 
class="ruby-string">&#39;.&#39;</span>, <span 
class="ruby-string">&#39;/&#39;</span>) <span class="ruby-operator">+</span> 
<span class="ruby-node">&quot;/#{id}/#{version}/#{MAVEN_METADATA}&quot;</span>
+         <span class="ruby-constant">URI</span>.<span 
class="ruby-identifier">write</span> <span class="ruby-identifier">uri</span> 
<span class="ruby-operator">+</span> <span 
class="ruby-identifier">maven_metadata</span>, <span 
class="ruby-identifier">maven_metadata_xml</span>, <span 
class="ruby-value">:permissions</span> =<span class="ruby-operator">&gt;</span> 
<span class="ruby-identifier">upload_to</span>[<span 
class="ruby-value">:permissions</span>]
+      <span class="ruby-keyword">end</span>
+    <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">end</span>
+  <span class="ruby-identifier">task</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+    </section>
+  
+     <section id="protected-instance-5Buntitled-5D-method-details" 
class="method-section">
+       <header>
+         <h3>Protected Instance Methods</h3>
+       </header>
+
+    
+      <div id="method-i-apply_spec" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">apply_spec</span><span
+            class="method-args">(spec)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Apply specification to this artifact.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="apply_spec-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 254</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">apply_spec</span>(<span 
class="ruby-identifier">spec</span>)
+  <span class="ruby-identifier">spec</span> = <span 
class="ruby-constant">Artifact</span>.<span 
class="ruby-identifier">to_hash</span>(<span 
class="ruby-identifier">spec</span>)
+  <span class="ruby-constant">ARTIFACT_ATTRIBUTES</span>.<span 
class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span 
class="ruby-identifier">key</span><span class="ruby-operator">|</span> <span 
class="ruby-identifier">instance_variable_set</span>(<span 
class="ruby-node">&quot;@#{key}&quot;</span>, <span 
class="ruby-identifier">spec</span>[<span class="ruby-identifier">key</span>]) }
+  <span class="ruby-keyword">self</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-extract_type" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">extract_type</span><span
+            class="method-args">(type)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+          <div class="method-source-code" id="extract_type-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 269</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">extract_type</span>(<span 
class="ruby-identifier">type</span>)
+  <span class="ruby-keyword">return</span> <span 
class="ruby-value">:jar</span> <span class="ruby-keyword">if</span> <span 
class="ruby-identifier">type</span> <span class="ruby-operator">==</span> <span 
class="ruby-value">:bundle</span>
+  <span class="ruby-identifier">type</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-group_path" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">group_path</span><span
+            class="method-args">()</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+          <div class="method-source-code" id="group_path-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 260</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">group_path</span>
+  <span class="ruby-identifier">group</span>.<span 
class="ruby-identifier">gsub</span>(<span 
class="ruby-string">&#39;.&#39;</span>, <span 
class="ruby-string">&#39;/&#39;</span>)
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-upload_name" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">upload_name</span><span
+            class="method-args">()</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+          <div class="method-source-code" id="upload_name-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/artifact.rb, line 264</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">upload_name</span>
+  <span class="ruby-keyword">return</span> <span 
class="ruby-constant">File</span>.<span 
class="ruby-identifier">basename</span>(<span 
class="ruby-identifier">name</span>) <span class="ruby-keyword">unless</span> 
<span class="ruby-identifier">snapshot?</span>
+  <span class="ruby-keyword">return</span> <span 
class="ruby-constant">File</span>.<span 
class="ruby-identifier">basename</span>(<span 
class="ruby-identifier">name</span>).<span 
class="ruby-identifier">gsub</span>(<span 
class="ruby-regexp">/SNAPSHOT/</span>, <span 
class="ruby-node">&quot;#{final_version}-1&quot;</span>)
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+    </section>
+  
+  </section>
+</main>
+
+
+<footer id="validator-badges" role="contentinfo">
+  <p><a href="http://validator.w3.org/check/referer";>Validate</a>
+  <p>Generated by <a href="http://docs.seattlerb.org/rdoc/";>RDoc</a> 4.2.2.
+  <p>Based on <a 
href="http://deveiate.org/projects/Darkfish-RDoc/";>Darkfish</a> by <a 
href="http://deveiate.org";>Michael Granger</a>.
+</footer>
+

Added: dev/buildr/1.5.0/site/rdoc/Buildr/Ant.html
==============================================================================
--- dev/buildr/1.5.0/site/rdoc/Buildr/Ant.html (added)
+++ dev/buildr/1.5.0/site/rdoc/Buildr/Ant.html Sat Sep 17 06:18:39 2016
@@ -0,0 +1,264 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta charset="UTF-8">
+
+<title>module Buildr::Ant - buildr</title>
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "../";
+</script>
+
+<script src="../js/jquery.js"></script>
+<script src="../js/darkfish.js"></script>
+
+<link href="../css/fonts.css" rel="stylesheet">
+<link href="../css/rdoc.css" rel="stylesheet">
+
+
+
+<body id="top" role="document" class="module">
+<nav role="navigation">
+  <div id="project-navigation">
+    <div id="home-section" role="region" title="Quick navigation" 
class="nav-section">
+  <h2>
+    <a href="../index.html" rel="home">Home</a>
+  </h2>
+
+  <div id="table-of-contents-navigation">
+    <a href="../table_of_contents.html#pages">Pages</a>
+    <a href="../table_of_contents.html#classes">Classes</a>
+    <a href="../table_of_contents.html#methods">Methods</a>
+  </div>
+</div>
+
+    <div id="search-section" role="search" class="project-section 
initially-hidden">
+  <form action="#" method="get" accept-charset="utf-8">
+    <div id="search-field-wrapper">
+      <input id="search-field" role="combobox" aria-label="Search"
+             aria-autocomplete="list" aria-controls="search-results"
+             type="text" name="search" placeholder="Search" spellcheck="false"
+             title="Type to search, Up and Down to navigate, Enter to load">
+    </div>
+
+    <ul id="search-results" aria-label="Search Results"
+        aria-busy="false" aria-expanded="false"
+        aria-atomic="false" class="initially-hidden"></ul>
+  </form>
+</div>
+
+  </div>
+
+  
+
+  <div id="class-metadata">
+    
+    
+    
+    
+    <!-- Method Quickref -->
+<div id="method-list-section" class="nav-section">
+  <h3>Methods</h3>
+
+  <ul class="link-list" role="directory">
+    
+    <li ><a href="#method-c-dependencies">::dependencies</a>
+    
+    <li ><a href="#method-c-version">::version</a>
+    
+    <li ><a href="#method-i-ant">#ant</a>
+    
+  </ul>
+</div>
+
+  </div>
+</nav>
+
+<main role="main" aria-labelledby="module-Buildr::Ant">
+  <h1 id="module-Buildr::Ant" class="module">
+    module Buildr::Ant
+  </h1>
+
+  <section class="description">
+    
+  </section>
+
+  
+  
+  
+  <section id="5Buntitled-5D" class="documentation-section">
+    
+
+    
+
+    
+    <section class="constants-list">
+      <header>
+        <h3>Constants</h3>
+      </header>
+      <dl>
+      
+        <dt id="VERSION">VERSION
+        
+        <dd><p>Which version of <a href="Ant.html">Ant</a> we&#39;re using by 
default.</p>
+        
+      
+      </dl>
+    </section>
+    
+
+    
+
+    
+     <section id="public-class-5Buntitled-5D-method-details" 
class="method-section">
+       <header>
+         <h3>Public Class Methods</h3>
+       </header>
+
+    
+      <div id="method-c-dependencies" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">dependencies</span><span
+            class="method-args">()</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p><a href="Ant.html">Ant</a> classpath dependencies.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="dependencies-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/ant.rb, 
line 34</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">dependencies</span>
+  <span class="ruby-comment"># Ant-Trax required for running the JUnitReport 
task, and there&#39;s no other place</span>
+  <span class="ruby-comment"># to put it but the root classpath.</span>
+  <span class="ruby-ivar">@dependencies</span> <span 
class="ruby-operator">||=</span> [<span 
class="ruby-node">&quot;org.apache.ant:ant:jar:#{version}&quot;</span>, <span 
class="ruby-node">&quot;org.apache.ant:ant-launcher:jar:#{version}&quot;</span>]
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-c-version" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">version</span><span
+            class="method-args">()</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Current version of <a href="Ant.html">Ant</a> being used.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="version-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/ant.rb, 
line 29</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">version</span>
+  <span class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">settings</span>.<span 
class="ruby-identifier">build</span>[<span 
class="ruby-string">&#39;ant&#39;</span>] <span class="ruby-operator">||</span> 
<span class="ruby-constant">VERSION</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+    </section>
+  
+     <section id="public-instance-5Buntitled-5D-method-details" 
class="method-section">
+       <header>
+         <h3>Public Instance Methods</h3>
+       </header>
+
+    
+      <div id="method-i-ant" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            ant(name) { |AntProject| ... } &rarr; AntProject
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Creates a new AntProject with the specified name, yield to the 
block for
+defining various <a href="Ant.html">Ant</a> tasks, and executes each task
+as it&#39;s defined.</p>
+
+<p>For example:</p>
+
+<pre>ant(&quot;hibernatedoclet&#39;) do |doclet|
+  doclet.taskdef :name=&gt;&#39;hibernatedoclet&#39;,
+    :classname=&gt;&#39;xdoclet.modules.hibernate.HibernateDocletTask&#39;, 
:classpath=&gt;DOCLET
+  doclet.hibernatedoclet :destdir=&gt;dest_dir, :force=&gt;&#39;true&#39; do
+    hibernate :version=&gt;&#39;3.0&#39;
+    fileset :dir=&gt;source, :includes=&gt;&#39;**/*.java&#39;
+  end
+end</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="ant-source">
+            <pre><span class="ruby-comment"># File lib/buildr/java/ant.rb, 
line 60</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">ant</span>(<span class="ruby-identifier">name</span>, 
<span class="ruby-operator">&amp;</span><span 
class="ruby-identifier">block</span>)
+  <span class="ruby-identifier">options</span> = { <span 
class="ruby-value">:name=</span><span class="ruby-operator">&gt;</span><span 
class="ruby-identifier">name</span>, <span 
class="ruby-value">:basedir=</span><span class="ruby-operator">&gt;</span><span 
class="ruby-constant">Dir</span>.<span class="ruby-identifier">pwd</span>, 
<span class="ruby-value">:declarative=</span><span 
class="ruby-operator">&gt;</span><span class="ruby-keyword">true</span> }
+  <span class="ruby-identifier">options</span>.<span 
class="ruby-identifier">merge!</span>(<span 
class="ruby-value">:logger=</span><span class="ruby-operator">&gt;</span> <span 
class="ruby-constant">Logger</span>.<span 
class="ruby-identifier">new</span>(<span class="ruby-constant">STDOUT</span>), 
<span class="ruby-value">:loglevel=</span><span 
class="ruby-operator">&gt;</span> <span 
class="ruby-constant">Logger</span><span class="ruby-operator">::</span><span 
class="ruby-constant">DEBUG</span>) <span class="ruby-keyword">if</span> <span 
class="ruby-identifier">trace?</span>(<span class="ruby-value">:ant</span>)
+  <span class="ruby-constant">Java</span>.<span 
class="ruby-identifier">load</span>
+  <span class="ruby-constant">Antwrap</span><span 
class="ruby-operator">::</span><span 
class="ruby-constant">AntProject</span>.<span 
class="ruby-identifier">new</span>(<span 
class="ruby-identifier">options</span>).<span 
class="ruby-identifier">tap</span> <span class="ruby-keyword">do</span> <span 
class="ruby-operator">|</span><span class="ruby-identifier">project</span><span 
class="ruby-operator">|</span>
+    <span class="ruby-comment"># Set Ant logging level to debug (--trace), 
info (default) or error only (--quiet).</span>
+    <span class="ruby-identifier">project</span>.<span 
class="ruby-identifier">project</span>.<span 
class="ruby-identifier">getBuildListeners</span>().<span 
class="ruby-identifier">get</span>(<span class="ruby-value">0</span>).
+      <span class="ruby-identifier">setMessageOutputLevel</span>((<span 
class="ruby-identifier">trace?</span>(<span class="ruby-value">:ant</span>) 
<span class="ruby-operator">&amp;&amp;</span> <span 
class="ruby-value">4</span>) <span class="ruby-operator">||</span> (<span 
class="ruby-identifier">verbose</span> <span 
class="ruby-operator">&amp;&amp;</span> <span class="ruby-value">2</span>) 
<span class="ruby-operator">||</span> <span class="ruby-value">0</span>)
+    <span class="ruby-keyword">yield</span> <span 
class="ruby-identifier">project</span> <span class="ruby-keyword">if</span> 
<span class="ruby-identifier">block_given?</span>
+  <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+    </section>
+  
+  </section>
+</main>
+
+
+<footer id="validator-badges" role="contentinfo">
+  <p><a href="http://validator.w3.org/check/referer";>Validate</a>
+  <p>Generated by <a href="http://docs.seattlerb.org/rdoc/";>RDoc</a> 4.2.2.
+  <p>Based on <a 
href="http://deveiate.org/projects/Darkfish-RDoc/";>Darkfish</a> by <a 
href="http://deveiate.org";>Michael Granger</a>.
+</footer>
+

Added: dev/buildr/1.5.0/site/rdoc/Buildr/Apt.html
==============================================================================
--- dev/buildr/1.5.0/site/rdoc/Buildr/Apt.html (added)
+++ dev/buildr/1.5.0/site/rdoc/Buildr/Apt.html Sat Sep 17 06:18:39 2016
@@ -0,0 +1,171 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta charset="UTF-8">
+
+<title>module Buildr::Apt - buildr</title>
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "../";
+</script>
+
+<script src="../js/jquery.js"></script>
+<script src="../js/darkfish.js"></script>
+
+<link href="../css/fonts.css" rel="stylesheet">
+<link href="../css/rdoc.css" rel="stylesheet">
+
+
+
+<body id="top" role="document" class="module">
+<nav role="navigation">
+  <div id="project-navigation">
+    <div id="home-section" role="region" title="Quick navigation" 
class="nav-section">
+  <h2>
+    <a href="../index.html" rel="home">Home</a>
+  </h2>
+
+  <div id="table-of-contents-navigation">
+    <a href="../table_of_contents.html#pages">Pages</a>
+    <a href="../table_of_contents.html#classes">Classes</a>
+    <a href="../table_of_contents.html#methods">Methods</a>
+  </div>
+</div>
+
+    <div id="search-section" role="search" class="project-section 
initially-hidden">
+  <form action="#" method="get" accept-charset="utf-8">
+    <div id="search-field-wrapper">
+      <input id="search-field" role="combobox" aria-label="Search"
+             aria-autocomplete="list" aria-controls="search-results"
+             type="text" name="search" placeholder="Search" spellcheck="false"
+             title="Type to search, Up and Down to navigate, Enter to load">
+    </div>
+
+    <ul id="search-results" aria-label="Search Results"
+        aria-busy="false" aria-expanded="false"
+        aria-atomic="false" class="initially-hidden"></ul>
+  </form>
+</div>
+
+  </div>
+
+  
+
+  <div id="class-metadata">
+    
+    
+    
+    
+    <!-- Method Quickref -->
+<div id="method-list-section" class="nav-section">
+  <h3>Methods</h3>
+
+  <ul class="link-list" role="directory">
+    
+    <li ><a href="#method-i-apt">#apt</a>
+    
+  </ul>
+</div>
+
+  </div>
+</nav>
+
+<main role="main" aria-labelledby="module-Buildr::Apt">
+  <h1 id="module-Buildr::Apt" class="module">
+    module Buildr::Apt
+  </h1>
+
+  <section class="description">
+    
+<p>Methods added to <a href="Project.html">Project</a> to support the <a
+href="../Java.html">Java</a> Annotation Processor.</p>
+
+  </section>
+
+  
+  
+  
+  <section id="5Buntitled-5D" class="documentation-section">
+    
+
+    
+
+    
+
+    
+
+    
+     <section id="public-instance-5Buntitled-5D-method-details" 
class="method-section">
+       <header>
+         <h3>Public Instance Methods</h3>
+       </header>
+
+    
+      <div id="method-i-apt" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            apt(*sources) &rarr; task
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Returns a task that will use Java#apt to generate source files in
+target/generated/apt, from all the source directories passed as arguments.
+Uses the compile.sources list if on arguments supplied.</p>
+
+<p>For example:</p>
+          
+          
+
+          
+          <div class="method-source-code" id="apt-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/java/compiler.rb, line 109</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">apt</span>(<span class="ruby-operator">*</span><span 
class="ruby-identifier">sources</span>)
+  <span class="ruby-identifier">sources</span> = <span 
class="ruby-identifier">compile</span>.<span 
class="ruby-identifier">sources</span> <span class="ruby-keyword">if</span> 
<span class="ruby-identifier">sources</span>.<span 
class="ruby-identifier">empty?</span>
+  <span class="ruby-identifier">file</span>(<span 
class="ruby-identifier">path_to</span>(<span class="ruby-value">:target</span>, 
<span class="ruby-string">&#39;generated/apt&#39;</span>)=<span 
class="ruby-operator">&gt;</span><span class="ruby-identifier">sources</span>) 
<span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span 
class="ruby-identifier">task</span><span class="ruby-operator">|</span>
+    <span class="ruby-identifier">cmd_args</span> = [ <span 
class="ruby-identifier">trace?</span>(<span class="ruby-value">:apt</span>) 
<span class="ruby-operator">?</span> <span 
class="ruby-string">&#39;-verbose&#39;</span> <span 
class="ruby-operator">:</span> <span 
class="ruby-string">&#39;-nowarn&#39;</span> ]
+    <span class="ruby-identifier">cmd_args</span> <span 
class="ruby-operator">&lt;&lt;</span> <span 
class="ruby-string">&#39;-nocompile&#39;</span> <span 
class="ruby-operator">&lt;&lt;</span> <span 
class="ruby-string">&#39;-s&#39;</span> <span 
class="ruby-operator">&lt;&lt;</span> <span 
class="ruby-identifier">task</span>.<span class="ruby-identifier">name</span>
+    <span class="ruby-identifier">cmd_args</span> <span 
class="ruby-operator">&lt;&lt;</span> <span 
class="ruby-string">&#39;-source&#39;</span> <span 
class="ruby-operator">&lt;&lt;</span> <span 
class="ruby-identifier">compile</span>.<span 
class="ruby-identifier">options</span>.<span 
class="ruby-identifier">source</span> <span class="ruby-keyword">if</span> 
<span class="ruby-identifier">compile</span>.<span 
class="ruby-identifier">options</span>.<span 
class="ruby-identifier">source</span>
+    <span class="ruby-identifier">classpath</span> = <span 
class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">artifacts</span>(<span 
class="ruby-identifier">compile</span>.<span 
class="ruby-identifier">dependencies</span>).<span 
class="ruby-identifier">map</span>(<span 
class="ruby-operator">&amp;</span><span class="ruby-value">:to_s</span>).<span 
class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span 
class="ruby-identifier">t</span><span class="ruby-operator">|</span> <span 
class="ruby-identifier">task</span>(<span 
class="ruby-identifier">t</span>).<span class="ruby-identifier">invoke</span> }
+    <span class="ruby-identifier">cmd_args</span> <span 
class="ruby-operator">&lt;&lt;</span> <span 
class="ruby-string">&#39;-classpath&#39;</span> <span 
class="ruby-operator">&lt;&lt;</span> <span 
class="ruby-identifier">classpath</span>.<span 
class="ruby-identifier">join</span>(<span 
class="ruby-constant">File</span><span class="ruby-operator">::</span><span 
class="ruby-constant">PATH_SEPARATOR</span>) <span 
class="ruby-keyword">unless</span> <span 
class="ruby-identifier">classpath</span>.<span 
class="ruby-identifier">empty?</span>
+    <span class="ruby-identifier">cmd_args</span> <span 
class="ruby-operator">+=</span> (<span 
class="ruby-identifier">sources</span>.<span 
class="ruby-identifier">map</span>(<span 
class="ruby-operator">&amp;</span><span class="ruby-value">:to_s</span>) <span 
class="ruby-operator">-</span> [<span class="ruby-identifier">task</span>.<span 
class="ruby-identifier">name</span>]).
+      <span class="ruby-identifier">map</span> { <span 
class="ruby-operator">|</span><span class="ruby-identifier">file</span><span 
class="ruby-operator">|</span> <span class="ruby-constant">File</span>.<span 
class="ruby-identifier">directory?</span>(<span 
class="ruby-identifier">file</span>) <span class="ruby-operator">?</span> <span 
class="ruby-constant">FileList</span>[<span 
class="ruby-node">&quot;#{file}/**/*.java&quot;</span>] <span 
class="ruby-operator">:</span> <span class="ruby-identifier">file</span> 
}.<span class="ruby-identifier">flatten</span>
+    <span class="ruby-keyword">unless</span> <span 
class="ruby-constant">Buildr</span>.<span 
class="ruby-identifier">application</span>.<span 
class="ruby-identifier">options</span>.<span 
class="ruby-identifier">dryrun</span>
+      <span class="ruby-identifier">info</span> <span 
class="ruby-string">&#39;Running apt&#39;</span>
+      <span class="ruby-identifier">trace</span> ([<span 
class="ruby-string">&#39;apt&#39;</span>] <span class="ruby-operator">+</span> 
<span class="ruby-identifier">cmd_args</span>).<span 
class="ruby-identifier">join</span>(<span class="ruby-string">&#39; 
&#39;</span>)
+      <span class="ruby-constant">Java</span>.<span 
class="ruby-identifier">com</span>.<span 
class="ruby-identifier">sun</span>.<span 
class="ruby-identifier">tools</span>.<span 
class="ruby-identifier">apt</span>.<span 
class="ruby-constant">Main</span>.<span 
class="ruby-identifier">process</span>(<span 
class="ruby-identifier">cmd_args</span>.<span 
class="ruby-identifier">to_java</span>(<span 
class="ruby-constant">Java</span>.<span 
class="ruby-identifier">java</span>.<span 
class="ruby-identifier">lang</span>.<span class="ruby-constant">String</span>)) 
<span class="ruby-operator">==</span> <span class="ruby-value">0</span> <span 
class="ruby-keyword">or</span>
+        <span class="ruby-identifier">fail</span> <span 
class="ruby-string">&#39;Failed to process annotations, see errors 
above&#39;</span>
+    <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+    </section>
+  
+  </section>
+</main>
+
+
+<footer id="validator-badges" role="contentinfo">
+  <p><a href="http://validator.w3.org/check/referer";>Validate</a>
+  <p>Generated by <a href="http://docs.seattlerb.org/rdoc/";>RDoc</a> 4.2.2.
+  <p>Based on <a 
href="http://deveiate.org/projects/Darkfish-RDoc/";>Darkfish</a> by <a 
href="http://deveiate.org";>Michael Granger</a>.
+</footer>
+

Added: dev/buildr/1.5.0/site/rdoc/Buildr/ArchiveTask.html
==============================================================================
--- dev/buildr/1.5.0/site/rdoc/Buildr/ArchiveTask.html (added)
+++ dev/buildr/1.5.0/site/rdoc/Buildr/ArchiveTask.html Sat Sep 17 06:18:39 2016
@@ -0,0 +1,708 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta charset="UTF-8">
+
+<title>class Buildr::ArchiveTask - buildr</title>
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "../";
+</script>
+
+<script src="../js/jquery.js"></script>
+<script src="../js/darkfish.js"></script>
+
+<link href="../css/fonts.css" rel="stylesheet">
+<link href="../css/rdoc.css" rel="stylesheet">
+
+
+
+<body id="top" role="document" class="class">
+<nav role="navigation">
+  <div id="project-navigation">
+    <div id="home-section" role="region" title="Quick navigation" 
class="nav-section">
+  <h2>
+    <a href="../index.html" rel="home">Home</a>
+  </h2>
+
+  <div id="table-of-contents-navigation">
+    <a href="../table_of_contents.html#pages">Pages</a>
+    <a href="../table_of_contents.html#classes">Classes</a>
+    <a href="../table_of_contents.html#methods">Methods</a>
+  </div>
+</div>
+
+    <div id="search-section" role="search" class="project-section 
initially-hidden">
+  <form action="#" method="get" accept-charset="utf-8">
+    <div id="search-field-wrapper">
+      <input id="search-field" role="combobox" aria-label="Search"
+             aria-autocomplete="list" aria-controls="search-results"
+             type="text" name="search" placeholder="Search" spellcheck="false"
+             title="Type to search, Up and Down to navigate, Enter to load">
+    </div>
+
+    <ul id="search-results" aria-label="Search Results"
+        aria-busy="false" aria-expanded="false"
+        aria-atomic="false" class="initially-hidden"></ul>
+  </form>
+</div>
+
+  </div>
+
+  
+
+  <div id="class-metadata">
+    
+    <div id="parent-class-section" class="nav-section">
+  <h3>Parent</h3>
+
+  
+  <p class="link"><a href="../Rake/FileTask.html">Rake::FileTask</a>
+  
+</div>
+
+    
+    
+    <!-- Method Quickref -->
+<div id="method-list-section" class="nav-section">
+  <h3>Methods</h3>
+
+  <ul class="link-list" role="directory">
+    
+    <li ><a href="#method-i-3C-3C">#&lt;&lt;</a>
+    
+    <li ><a href="#method-i-add">#add</a>
+    
+    <li ><a href="#method-i-clean">#clean</a>
+    
+    <li ><a href="#method-i-contain-3F">#contain?</a>
+    
+    <li ><a href="#method-i-empty-3F">#empty?</a>
+    
+    <li ><a href="#method-i-exclude">#exclude</a>
+    
+    <li ><a href="#method-i-include">#include</a>
+    
+    <li ><a href="#method-i-merge">#merge</a>
+    
+    <li ><a href="#method-i-path">#path</a>
+    
+    <li ><a href="#method-i-prepare">#prepare</a>
+    
+    <li ><a href="#method-i-root">#root</a>
+    
+    <li ><a href="#method-i-with">#with</a>
+    
+  </ul>
+</div>
+
+  </div>
+</nav>
+
+<main role="main" aria-labelledby="class-Buildr::ArchiveTask">
+  <h1 id="class-Buildr::ArchiveTask" class="class">
+    class Buildr::ArchiveTask
+  </h1>
+
+  <section class="description">
+    
+<p>Base class for <a href="ZipTask.html">ZipTask</a>, <a
+href="TarTask.html">TarTask</a> and other archives.</p>
+
+  </section>
+
+  
+  
+  
+  <section id="5Buntitled-5D" class="documentation-section">
+    
+
+    
+
+    
+
+    
+
+    
+     <section id="public-instance-5Buntitled-5D-method-details" 
class="method-section">
+       <header>
+         <h3>Public Instance Methods</h3>
+       </header>
+
+    
+      <div id="method-i-3C-3C" class="method-detail method-alias">
+        
+        <div class="method-heading">
+          <span class="method-name">&lt;&lt;</span><span
+            class="method-args">(*files)</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+        </div>
+
+        
+
+        
+        <div class="aliases">
+          Alias for: <a href="ArchiveTask.html#method-i-include">include</a>
+        </div>
+        
+      </div>
+
+    
+      <div id="method-i-add" class="method-detail method-alias">
+        
+        <div class="method-heading">
+          <span class="method-name">add</span><span
+            class="method-args">(*files)</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          
+          
+          
+
+          
+        </div>
+
+        
+
+        
+        <div class="aliases">
+          Alias for: <a href="ArchiveTask.html#method-i-include">include</a>
+        </div>
+        
+      </div>
+
+    
+      <div id="method-i-clean" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            clean &rarr; self
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Removes all previously added content from this archive. Use this 
method if
+you want to remove default content from a package. For example,
+package(:jar) by default includes compiled classes and resources, using
+this method, you can create an empty jar and afterwards add the desired
+content to it.</p>
+
+<pre class="ruby"><span class="ruby-identifier">package</span>(:<span 
class="ruby-identifier">jar</span>).<span 
class="ruby-identifier">clean</span>.<span 
class="ruby-identifier">include</span> <span 
class="ruby-identifier">path_to</span>(<span 
class="ruby-string">&#39;desired/content&#39;</span>)
+</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="clean-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/archive.rb, line 362</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">clean</span>
+  <span class="ruby-ivar">@paths</span> = <span 
class="ruby-constant">OrderedHash</span>.<span 
class="ruby-identifier">new</span>
+  <span class="ruby-ivar">@paths</span>[<span 
class="ruby-string">&#39;&#39;</span>] = <span 
class="ruby-constant">Path</span>.<span 
class="ruby-identifier">new</span>(<span class="ruby-keyword">self</span>, 
<span class="ruby-string">&#39;&#39;</span>)
+  <span class="ruby-ivar">@prepares</span> = []
+  <span class="ruby-keyword">self</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-contain-3F" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            contain(file*) &rarr; boolean
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Returns true if this ZIP file contains all the specified files. 
You can use
+absolute file names and glob patterns (using *, **, etc).</p>
+          
+          
+
+          
+          <div class="method-source-code" id="contain-3F-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/archive.rb, line 529</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">contain?</span>(<span 
class="ruby-operator">*</span><span class="ruby-identifier">files</span>)
+  <span class="ruby-identifier">path</span>(<span 
class="ruby-string">&quot;&quot;</span>).<span 
class="ruby-identifier">contain?</span>(<span 
class="ruby-operator">*</span><span class="ruby-identifier">files</span>)
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-empty-3F" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            empty? &rarr; boolean
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Returns true if this ZIP file is empty (has no other entries 
inside).</p>
+          
+          
+
+          
+          <div class="method-source-code" id="empty-3F-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/archive.rb, line 520</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">empty?</span>
+  <span class="ruby-identifier">path</span>(<span 
class="ruby-string">&quot;&quot;</span>).<span 
class="ruby-identifier">empty</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-exclude" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            exclude(*files) &rarr; self
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Excludes files and returns self. Can be used in combination with 
include to
+prevent some files from being included.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="exclude-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/archive.rb, line 413</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">exclude</span>(<span 
class="ruby-operator">*</span><span class="ruby-identifier">files</span>)
+  <span class="ruby-ivar">@paths</span>[<span 
class="ruby-string">&#39;&#39;</span>].<span 
class="ruby-identifier">exclude</span> <span 
class="ruby-operator">*</span><span class="ruby-identifier">files</span>
+  <span class="ruby-keyword">self</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-include" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            include(*files) &rarr; self
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            include(*files, :path=&gt;path) &rarr; self
+          </span>
+          
+        </div>
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            include(file, :as=&gt;name) &rarr; self
+          </span>
+          
+        </div>
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            include(:from=&gt;path) &rarr; self
+          </span>
+          
+        </div>
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            include(*files, :merge=&gt;true) &rarr; self
+          </span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Include files in this archive, or when called on a path, within 
that path.
+Returns self.</p>
+
+<p>The first form accepts a list of files, directories and glob patterns and
+adds them to the archive. For example, to include the file foo, directory
+bar (including all files in there) and all files under baz:</p>
+
+<pre>zip(..).include(&#39;foo&#39;, &#39;bar&#39;, &#39;baz/*&#39;)</pre>
+
+<p>The second form is similar but adds files/directories under the specified
+path. For example, to add foo as bar/foo:</p>
+
+<pre>zip(..).include(&#39;foo&#39;, :path=&gt;&#39;bar&#39;)</pre>
+
+<p>The :path option is the same as using the path method:</p>
+
+<pre>zip(..).path(&#39;bar&#39;).include(&#39;foo&#39;)</pre>
+
+<p>All other options can be used in combination with the :path option.</p>
+
+<p>The third form adds a file or directory under a different name. For
+example, to add the file foo under the name bar:</p>
+
+<pre>zip(..).include(&#39;foo&#39;, :as=&gt;&#39;bar&#39;)</pre>
+
+<p>The fourth form adds the contents of a directory using the directory as a
+prerequisite:</p>
+
+<pre>zip(..).include(:from=&gt;&#39;foo&#39;)</pre>
+
+<p>Unlike <code>include(&#39;foo&#39;)</code> it includes the contents of the
+directory, not the directory itself. Unlike
+<code>include(&#39;foo/*&#39;)</code>, it uses the directory timestamp for
+dependency management.</p>
+
+<p>The fifth form includes the contents of another archive by expanding it
+into this archive. For example:</p>
+
+<pre>zip(..).include(&#39;foo.zip&#39;, 
:merge=&gt;true).include(&#39;bar.zip&#39;)</pre>
+
+<p>You can also use the method <a
+href="ArchiveTask.html#method-i-merge">merge</a>.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="include-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/archive.rb, line 401</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">include</span>(<span 
class="ruby-operator">*</span><span class="ruby-identifier">files</span>)
+  <span class="ruby-identifier">fail</span> <span 
class="ruby-string">&quot;AchiveTask.include() called with nil 
values&quot;</span> <span class="ruby-keyword">if</span> <span 
class="ruby-identifier">files</span>.<span 
class="ruby-identifier">include?</span> <span class="ruby-keyword">nil</span>
+  <span class="ruby-ivar">@paths</span>[<span 
class="ruby-string">&#39;&#39;</span>].<span 
class="ruby-identifier">include</span> <span 
class="ruby-operator">*</span><span class="ruby-identifier">files</span> <span 
class="ruby-keyword">if</span> <span class="ruby-identifier">files</span>.<span 
class="ruby-identifier">compact</span>.<span 
class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> 
<span class="ruby-value">0</span>
+  <span class="ruby-keyword">self</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+        <div class="aliases">
+          Also aliased as: <a href="ArchiveTask.html#method-i-add">add</a>, <a 
href="ArchiveTask.html#method-i-3C-3C">&lt;&lt;</a>
+        </div>
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-merge" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            merge(*files) &rarr; Merge
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            merge(*files, :path=&gt;name) &rarr; Merge
+          </span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Merges another archive into this one by including the individual 
files from
+the merged archive.</p>
+
+<p>Returns an object that supports two methods: include and exclude. You can
+use these methods to merge only specific files. For example:</p>
+
+<pre>zip(..).merge(&#39;src.zip&#39;).include(&#39;module1/*&#39;)</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="merge-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/archive.rb, line 427</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">merge</span>(<span class="ruby-operator">*</span><span 
class="ruby-identifier">files</span>)
+  <span class="ruby-ivar">@paths</span>[<span 
class="ruby-string">&#39;&#39;</span>].<span 
class="ruby-identifier">merge</span> <span class="ruby-operator">*</span><span 
class="ruby-identifier">files</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-path" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            path(name) &rarr; Path
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Returns a path object. Use the path object to include files under 
a path,
+for example, to include the file &#39;foo&#39; as &#39;bar/foo&#39;:</p>
+
+<pre>zip(..).path(&#39;bar&#39;).include(&#39;foo&#39;)</pre>
+
+<p>Returns a Path object. The Path object implements all the same methods,
+like include, exclude, merge and so forth. It also implements path and
+root, so that:</p>
+
+<pre class="ruby"><span class="ruby-identifier">path</span>(<span 
class="ruby-string">&#39;foo&#39;</span>).<span 
class="ruby-identifier">path</span>(<span 
class="ruby-string">&#39;bar&#39;</span>) <span class="ruby-operator">==</span> 
<span class="ruby-identifier">path</span>(<span 
class="ruby-string">&#39;foo/bar&#39;</span>)
+<span class="ruby-identifier">path</span>(<span 
class="ruby-string">&#39;foo&#39;</span>).<span 
class="ruby-identifier">root</span> <span class="ruby-operator">==</span> <span 
class="ruby-identifier">root</span>
+</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="path-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/archive.rb, line 442</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">path</span>(<span class="ruby-identifier">name</span>)
+  <span class="ruby-keyword">return</span> <span 
class="ruby-ivar">@paths</span>[<span class="ruby-string">&#39;&#39;</span>] 
<span class="ruby-keyword">if</span> <span 
class="ruby-identifier">name</span>.<span class="ruby-identifier">nil?</span>
+  <span class="ruby-identifier">normalized</span> = <span 
class="ruby-identifier">name</span>.<span 
class="ruby-identifier">split</span>(<span 
class="ruby-string">&#39;/&#39;</span>).<span 
class="ruby-identifier">inject</span>([]) <span class="ruby-keyword">do</span> 
<span class="ruby-operator">|</span><span class="ruby-identifier">path</span>, 
<span class="ruby-identifier">part</span><span class="ruby-operator">|</span>
+    <span class="ruby-keyword">case</span> <span 
class="ruby-identifier">part</span>
+    <span class="ruby-keyword">when</span> <span 
class="ruby-string">&#39;.&#39;</span>, <span class="ruby-keyword">nil</span>, 
<span class="ruby-string">&#39;&#39;</span>
+      <span class="ruby-identifier">path</span>
+    <span class="ruby-keyword">when</span> <span 
class="ruby-string">&#39;..&#39;</span>
+      <span class="ruby-identifier">path</span>[<span 
class="ruby-value">0</span><span class="ruby-operator">...</span><span 
class="ruby-value">-1</span>]
+    <span class="ruby-keyword">else</span>
+      <span class="ruby-identifier">path</span> <span 
class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">part</span>
+    <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">end</span>.<span 
class="ruby-identifier">join</span>(<span 
class="ruby-string">&#39;/&#39;</span>)
+  <span class="ruby-ivar">@paths</span>[<span 
class="ruby-identifier">normalized</span>] <span 
class="ruby-operator">||=</span> <span class="ruby-constant">Path</span>.<span 
class="ruby-identifier">new</span>(<span class="ruby-keyword">self</span>, 
<span class="ruby-identifier">normalized</span>)
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-root" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            root &rarr; ArchiveTask
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Call this on an archive to return itself, and on a path to return 
the
+archive.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="root-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/archive.rb, line 461</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">root</span>
+  <span class="ruby-keyword">self</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+      <div id="method-i-with" class="method-detail ">
+        
+        
+        <div class="method-heading">
+          <span class="method-callseq">
+            with(options) &rarr; self
+          </span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+        
+
+        <div class="method-description">
+          
+          <p>Passes options to the task and returns self. Some tasks support 
additional
+options, for example, the WarTask supports options like :manifest, :libs
+and :classes.</p>
+
+<p>For example:</p>
+
+<pre class="ruby"><span class="ruby-identifier">package</span>(:<span 
class="ruby-identifier">jar</span>).<span 
class="ruby-identifier">with</span>(:<span 
class="ruby-identifier">manifest=</span><span 
class="ruby-operator">&gt;</span><span 
class="ruby-string">&#39;MANIFEST_MF&#39;</span>)
+</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="with-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/archive.rb, line 473</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">with</span>(<span 
class="ruby-identifier">options</span>)
+  <span class="ruby-identifier">options</span>.<span 
class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span 
class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span 
class="ruby-identifier">value</span><span class="ruby-operator">|</span>
+    <span class="ruby-keyword">begin</span>
+      <span class="ruby-identifier">send</span> <span 
class="ruby-node">&quot;#{key}=&quot;</span>, <span 
class="ruby-identifier">value</span>
+    <span class="ruby-keyword">rescue</span> <span 
class="ruby-constant">NoMethodError</span>
+      <span class="ruby-identifier">raise</span> <span 
class="ruby-constant">ArgumentError</span>, <span 
class="ruby-node">&quot;#{self.class.name} does not support the option 
#{key}&quot;</span>
+    <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">end</span>
+  <span class="ruby-keyword">self</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+    </section>
+  
+     <section id="protected-instance-5Buntitled-5D-method-details" 
class="method-section">
+       <header>
+         <h3>Protected Instance Methods</h3>
+       </header>
+
+    
+      <div id="method-i-prepare" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">prepare</span><span
+            class="method-args">(&block)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Adds a prepare block. These blocks are called early on for adding 
more
+content to the archive, before invoking prerequsities. Anything you add
+here will be invoked as a prerequisite and used to determine whether or not
+to generate this archive. In contrast, enhance blocks are evaluated after
+it was decided to create this archive.</p>
+          
+          
+
+          
+          <div class="method-source-code" id="prepare-source">
+            <pre><span class="ruby-comment"># File 
lib/buildr/packaging/archive.rb, line 539</span>
+<span class="ruby-keyword">def</span> <span 
class="ruby-identifier">prepare</span>(<span 
class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
+  <span class="ruby-ivar">@prepares</span> <span 
class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">block</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
+      </div>
+
+    
+    </section>
+  
+  </section>
+</main>
+
+
+<footer id="validator-badges" role="contentinfo">
+  <p><a href="http://validator.w3.org/check/referer";>Validate</a>
+  <p>Generated by <a href="http://docs.seattlerb.org/rdoc/";>RDoc</a> 4.2.2.
+  <p>Based on <a 
href="http://deveiate.org/projects/Darkfish-RDoc/";>Darkfish</a> by <a 
href="http://deveiate.org";>Michael Granger</a>.
+</footer>
+



Reply via email to