Added: dev/buildr/1.5.0/site/rdoc/Java/Commands.html ============================================================================== --- dev/buildr/1.5.0/site/rdoc/Java/Commands.html (added) +++ dev/buildr/1.5.0/site/rdoc/Java/Commands.html Sat Sep 17 06:18:39 2016 @@ -0,0 +1,593 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>module Java::Commands - 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-apt">::apt</a> + + <li ><a href="#method-c-classpath_from">::classpath_from</a> + + <li ><a href="#method-c-java">::java</a> + + <li ><a href="#method-c-javac">::javac</a> + + <li ><a href="#method-c-javadoc">::javadoc</a> + + <li ><a href="#method-c-path_to_bin">::path_to_bin</a> + + </ul> +</div> + + </div> +</nav> + +<main role="main" aria-labelledby="module-Java::Commands"> + <h1 id="module-Java::Commands" class="module"> + module Java::Commands + </h1> + + <section class="description"> + +<p>JDK commands: java, javac, javadoc, etc.</p> + + </section> + + + + + <section id="5Buntitled-5D" class="documentation-section"> + + + + + + + + + + <section id="public-class-5Buntitled-5D-method-details" class="method-section"> + <header> + <h3>Public Class Methods</h3> + </header> + + + <div id="method-c-apt" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + apt(*files, options) + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Runs Apt with the specified arguments.</p> + +<p>The last argument may be a <a href="../Hash.html">Hash</a> with additional +options:</p> +<ul><li> +<p>:compile â If true, compile source files to class files.</p> +</li><li> +<p>:source â Specifies source compatibility with a given JVM release.</p> +</li><li> +<p>:output â Directory where to place the generated source files, or the +generated class files when compiling.</p> +</li><li> +<p>:classpath â One or more file names, tasks or artifact specifications. +These are all expanded into artifacts, and all tasks are invoked.</p> +</li></ul> + + + + + <div class="method-source-code" id="apt-source"> + <pre><span class="ruby-comment"># File lib/buildr/java/commands.rb, line 142</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">apt</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) + <span class="ruby-identifier">options</span> = <span class="ruby-constant">Hash</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">last</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span> <span class="ruby-operator">:</span> {} + <span class="ruby-identifier">rake_check_options</span> <span class="ruby-identifier">options</span>, <span class="ruby-value">:compile</span>, <span class="ruby-value">:source</span>, <span class="ruby-value">:output</span>, <span class="ruby-value">:classpath</span> + + <span class="ruby-identifier">files</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">flatten</span>.<span class="ruby-identifier">map</span>(<span class="ruby-operator">&</span><span class="ruby-value">:to_s</span>). + <span class="ruby-identifier">collect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">arg</span><span class="ruby-operator">|</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">arg</span>) <span class="ruby-operator">?</span> <span class="ruby-constant">FileList</span>[<span class="ruby-node">"#{arg}/**/*.java"</span>] <span class="ruby-operator">:</span> <span class="ruby-identifier">arg</span> }.<span class="ruby-identifier">flatten</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">'-verbose'</span> <span class="ruby-operator">:</span> <span class="ruby-string">'-nowarn'</span> ] + <span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:compile</span>] + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-string">'-d'</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:output</span>].<span class="ruby-identifier">to_s</span> + <span class="ruby-keyword">else</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-string">'-nocompile'</span> <span class="ruby-operator"><<</span> <span class="ruby-string">'-s'</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:output</span>].<span class="ruby-identifier">to_s</span> + <span class="ruby-keyword">end</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-string">'-source'</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:source</span>] <span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:source</span>] + <span class="ruby-identifier">cp</span> = <span class="ruby-identifier">classpath_from</span>(<span class="ruby-identifier">options</span>) + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-string">'-classpath'</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">cp</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">cp</span>.<span class="ruby-identifier">empty?</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">files</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">'Running apt'</span> + <span class="ruby-identifier">trace</span> ([<span class="ruby-string">'apt'</span>] <span class="ruby-operator">+</span> <span class="ruby-identifier">cmd_args</span>).<span class="ruby-identifier">join</span>(<span class="ruby-string">' '</span>) + <span class="ruby-constant">Java</span>.<span class="ruby-identifier">load</span> + <span class="ruby-operator">::</span><span class="ruby-constant">Java</span><span class="ruby-operator">::</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-operator">::</span><span class="ruby-constant">Java</span><span class="ruby-operator">::</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">'Failed to process annotations, see errors above'</span> + <span class="ruby-keyword">end</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-c-java" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + java(class, *args, options?) + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Runs <a href="../Java.html">Java</a> with the specified arguments.</p> + +<p>Each argument should be provided as separate array value, e.g.</p> + +<pre class="ruby"><span class="ruby-identifier">java</span>(<span class="ruby-string">"-jar"</span>, <span class="ruby-string">"yuicompressor-2.4.2.jar"</span>, <span class="ruby-string">"--type"</span>,<span class="ruby-string">"css"</span>, + <span class="ruby-string">"src/main/webapp/styles/styles-all.css"</span>, + <span class="ruby-string">"-o"</span>, <span class="ruby-string">"src/main/webapp/styles/styles-all-min.css"</span>) +</pre> + +<p>The last argument may be a <a href="../Hash.html">Hash</a> with additional +options:</p> +<ul><li> +<p>:dir â The working directory from which to execute task..</p> +</li><li> +<p>:classpath â One or more file names, tasks or artifact specifications. +These are all expanded into artifacts, and all tasks are invoked.</p> +</li><li> +<p>:java_args â Any additional arguments to pass (e.g. -hotspot, -xms)</p> +</li><li> +<p>:properties â <a href="../Hash.html">Hash</a> of system properties (e.g. +'path'=>base_dir).</p> +</li><li> +<p>:name â Shows this name, otherwise shows the first argument (the class +name).</p> +</li><li> +<p>:verbose â If true, prints the command and all its argument.</p> +</li><li> +<p>:pathing_jar â If true, forces the use of a âpathingâ jar, false disables. +Nil</p> + +<pre>will default to using a "pathing" jar under windows with long classpaths. +See http://stackoverflow.com/questions/201816/how-to-set-a-long-java-classpath-in-msdos-windows</pre> +</li></ul> + + + + + <div class="method-source-code" id="java-source"> + <pre><span class="ruby-comment"># File lib/buildr/java/commands.rb, line 46</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">java</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>) + <span class="ruby-identifier">options</span> = <span class="ruby-constant">Hash</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">last</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span> <span class="ruby-operator">:</span> {} + <span class="ruby-identifier">options</span>[<span class="ruby-value">:verbose</span>] <span class="ruby-operator">||=</span> <span class="ruby-identifier">trace?</span>(<span class="ruby-value">:java</span>) + <span class="ruby-identifier">rake_check_options</span> <span class="ruby-identifier">options</span>, <span class="ruby-value">:classpath</span>, <span class="ruby-value">:java_args</span>, <span class="ruby-value">:properties</span>, <span class="ruby-value">:name</span>, <span class="ruby-value">:verbose</span>, <span class="ruby-value">:dir</span>, <span class="ruby-value">:pathing_jar</span> + + <span class="ruby-identifier">name</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value">:name</span>] + <span class="ruby-keyword">if</span> <span class="ruby-identifier">name</span>.<span class="ruby-identifier">nil?</span> + <span class="ruby-identifier">name</span> = <span class="ruby-node">"java #{args.first}"</span> + <span class="ruby-keyword">end</span> + + <span class="ruby-identifier">cmd_args</span> = [] + <span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:dir</span>] + <span class="ruby-identifier">pwd</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value">:dir</span>] + <span class="ruby-keyword">if</span> <span class="ruby-constant">Buildr</span><span class="ruby-operator">::</span><span class="ruby-constant">Util</span>.<span class="ruby-identifier">win_os?</span> + <span class="ruby-comment"># Ruby uses forward slashes regardless of platform,</span> + <span class="ruby-comment"># unfortunately cd c:/some/path fails on Windows</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"cd /d \"#{pwd.gsub(%r{/}, '\\')}\" && "</span> + <span class="ruby-keyword">else</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"cd '#{pwd}' && "</span> + <span class="ruby-keyword">end</span> + <span class="ruby-keyword">end</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">path_to_bin</span>(<span class="ruby-string">'java'</span>) + <span class="ruby-identifier">cp</span> = <span class="ruby-identifier">classpath_from</span>(<span class="ruby-identifier">options</span>) + + <span class="ruby-keyword">unless</span> <span class="ruby-identifier">cp</span>.<span class="ruby-identifier">empty?</span> + <span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:pathing_jar</span>] <span class="ruby-operator">==</span> <span class="ruby-keyword">true</span> <span class="ruby-operator">||</span> (<span class="ruby-identifier">options</span>[<span class="ruby-value">:pathing_jar</span>].<span class="ruby-identifier">nil?</span> <span class="ruby-operator">&&</span> <span class="ruby-constant">Util</span>.<span class="ruby-identifier">win_os?</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">cp</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">':'</span>).<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">2048</span>) + <span class="ruby-identifier">paths</span> = <span class="ruby-identifier">cp</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">c</span><span class="ruby-operator">|</span> + <span class="ruby-identifier">path</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">c</span>) <span class="ruby-operator">&&</span> <span class="ruby-operator">!</span><span class="ruby-identifier">c</span>.<span class="ruby-identifier">end_with?</span>(<span class="ruby-string">'/'</span>) <span class="ruby-operator">?</span> <span class="ruby-node">"#{c}/"</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span> + <span class="ruby-constant">Buildr</span><span class="ruby-operator">::</span><span class="ruby-constant">Util</span>.<span class="ruby-identifier">win_os?</span> <span class="ruby-operator">?</span> <span class="ruby-node">"/#{path}"</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">path</span> + <span class="ruby-keyword">end</span> + <span class="ruby-identifier">manifest</span> = <span class="ruby-constant">Buildr</span><span class="ruby-operator">::</span><span class="ruby-constant">Packaging</span><span class="ruby-operator">::</span><span class="ruby-constant">Java</span><span class="ruby-operator">::</span><span class="ruby-constant">Manifest</span>.<span class="ruby-identifier">new</span>([{<span class="ruby-string">'Class-Path'</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">paths</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">" "</span>)}]) + <span class="ruby-identifier">tjar</span> = <span class="ruby-constant">Tempfile</span>.<span class="ruby-identifier">new</span>([<span class="ruby-string">'javacmd'</span>, <span class="ruby-string">'.jar'</span>]) + <span class="ruby-constant">Zip</span><span class="ruby-operator">::</span><span class="ruby-constant">OutputStream</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">tjar</span>.<span class="ruby-identifier">path</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">zos</span><span class="ruby-operator">|</span> + <span class="ruby-identifier">zos</span>.<span class="ruby-identifier">put_next_entry</span>(<span class="ruby-string">'META-INF/MANIFEST.MF'</span>) + <span class="ruby-identifier">zos</span>.<span class="ruby-identifier">write</span> <span class="ruby-identifier">manifest</span>.<span class="ruby-identifier">to_s</span> + <span class="ruby-identifier">zos</span>.<span class="ruby-identifier">write</span> <span class="ruby-string">"\n"</span> + <span class="ruby-keyword">end</span> + <span class="ruby-identifier">tjar</span>.<span class="ruby-identifier">close</span> + + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-string">'-classpath'</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">tjar</span>.<span class="ruby-identifier">path</span> + <span class="ruby-keyword">else</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-string">'-classpath'</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">cp</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">end</span> + <span class="ruby-keyword">end</span> + <span class="ruby-identifier">options</span>[<span class="ruby-value">:properties</span>].<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"-D#{k}=#{v}"</span> } <span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:properties</span>] + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator">+=</span> (<span class="ruby-identifier">options</span>[<span class="ruby-value">:java_args</span>] <span class="ruby-operator">||</span> (<span class="ruby-constant">ENV</span>[<span class="ruby-string">'JAVA_OPTS'</span>] <span class="ruby-operator">||</span> <span class="ruby-constant">ENV</span>[<span class="ruby-string">'JAVA_OPTIONS'</span>]).<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">split</span>).<span class="ruby-identifier">flatten</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">flatten</span>.<span class="ruby-identifier">compact</span> + + <span class="ruby-identifier">tmp</span> = <span class="ruby-keyword">nil</span> + <span class="ruby-keyword">begin</span> + <span class="ruby-comment"># Windows can't handle cmd lines greater than 2048/8192 chars.</span> + <span class="ruby-comment"># If our cmd line is longer, we create a batch file and execute it instead.</span> + <span class="ruby-keyword">if</span> <span class="ruby-constant">Util</span>.<span class="ruby-identifier">win_os?</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">cmd_args</span>.<span class="ruby-identifier">map</span>(<span class="ruby-operator">&</span><span class="ruby-value">:inspect</span>).<span class="ruby-identifier">join</span>(<span class="ruby-string">' '</span>).<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">2048</span> + <span class="ruby-comment"># remove '-classpath' and the classpath itself from the cmd line.</span> + <span class="ruby-identifier">cp_i</span> = <span class="ruby-identifier">cmd_args</span>.<span class="ruby-identifier">index</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span> <span class="ruby-identifier">x</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">/^-classpath/</span>} + <span class="ruby-value">2</span>.<span class="ruby-identifier">times</span> <span class="ruby-keyword">do</span> + <span class="ruby-identifier">cmd_args</span>.<span class="ruby-identifier">delete_at</span> <span class="ruby-identifier">cp_i</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">cp_i</span>.<span class="ruby-identifier">nil?</span> + <span class="ruby-keyword">end</span> + <span class="ruby-comment"># create tmp batch file.</span> + <span class="ruby-identifier">tmp</span> = <span class="ruby-constant">Tempfile</span>.<span class="ruby-identifier">new</span>([<span class="ruby-string">'starter'</span>, <span class="ruby-string">'.bat'</span>]) + <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">write</span> <span class="ruby-string">"@echo off\n"</span> + <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">write</span> <span class="ruby-node">"SET CLASSPATH=#{cp.join(File::PATH_SEPARATOR).gsub(%r{/}, '\\')}\n"</span> + <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">write</span> <span class="ruby-identifier">cmd_args</span>.<span class="ruby-identifier">map</span>(<span class="ruby-operator">&</span><span class="ruby-value">:inspect</span>).<span class="ruby-identifier">join</span>(<span class="ruby-string">' '</span>) + <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">close</span> + <span class="ruby-comment"># set new cmd line.</span> + <span class="ruby-identifier">cmd_args</span> = [<span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">path</span>] + <span class="ruby-keyword">end</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-node">"Running #{name}"</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">name</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:verbose</span>] + <span class="ruby-identifier">block</span> = <span class="ruby-identifier">lambda</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">ok</span>, <span class="ruby-identifier">res</span><span class="ruby-operator">|</span> <span class="ruby-identifier">fail</span> <span class="ruby-node">"Failed to execute #{name}, see errors above"</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">ok</span> } <span class="ruby-keyword">unless</span> <span class="ruby-identifier">block</span> + <span class="ruby-identifier">cmd_args</span> = <span class="ruby-identifier">cmd_args</span>.<span class="ruby-identifier">map</span>(<span class="ruby-operator">&</span><span class="ruby-value">:inspect</span>).<span class="ruby-identifier">join</span>(<span class="ruby-string">' '</span>) <span class="ruby-keyword">if</span> <span class="ruby-constant">Util</span>.<span class="ruby-identifier">win_os?</span> + <span class="ruby-identifier">sh</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">cmd_args</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ok</span>, <span class="ruby-identifier">ps</span><span class="ruby-operator">|</span> + <span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span> <span class="ruby-identifier">ok</span>, <span class="ruby-identifier">ps</span> + <span class="ruby-keyword">end</span> + <span class="ruby-keyword">end</span> + <span class="ruby-keyword">ensure</span> + <span class="ruby-keyword">unless</span> <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">nil?</span> + <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">close</span> + <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">unlink</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-c-javac" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + javac(*files, options) + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Runs Javac with the specified arguments.</p> + +<p>The last argument may be a <a href="../Hash.html">Hash</a> with additional +options:</p> +<ul><li> +<p>:output â Target directory for all compiled class files.</p> +</li><li> +<p>:classpath â One or more file names, tasks or artifact specifications. +These are all expanded into artifacts, and all tasks are invoked.</p> +</li><li> +<p>:sourcepath â Additional source paths to use.</p> +</li><li> +<p>:javac_args â Any additional arguments to pass (e.g. -extdirs, -encoding)</p> +</li><li> +<p>:name â Shows this name, otherwise shows the working directory.</p> +</li></ul> + + + + + <div class="method-source-code" id="javac-source"> + <pre><span class="ruby-comment"># File lib/buildr/java/commands.rb, line 179</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">javac</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) + <span class="ruby-identifier">options</span> = <span class="ruby-constant">Hash</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">last</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span> <span class="ruby-operator">:</span> {} + <span class="ruby-identifier">rake_check_options</span> <span class="ruby-identifier">options</span>, <span class="ruby-value">:classpath</span>, <span class="ruby-value">:sourcepath</span>, <span class="ruby-value">:output</span>, <span class="ruby-value">:javac_args</span>, <span class="ruby-value">:name</span> + + <span class="ruby-identifier">files</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">flatten</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">invoke</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:invoke</span>) }.<span class="ruby-identifier">map</span>(<span class="ruby-operator">&</span><span class="ruby-value">:to_s</span>). + <span class="ruby-identifier">collect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">arg</span><span class="ruby-operator">|</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">arg</span>) <span class="ruby-operator">?</span> <span class="ruby-constant">FileList</span>[<span class="ruby-node">"#{File.expand_path(arg)}/**/*.java"</span>] <span class="ruby-operator">:</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">arg</span>) }.<span class="ruby-identifier">flatten</span> + <span class="ruby-identifier">name</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value">:name</span>] <span class="ruby-operator">||</span> <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">pwd</span> + + <span class="ruby-identifier">cmd_args</span> = [] + <span class="ruby-identifier">cp</span> = <span class="ruby-identifier">classpath_from</span>(<span class="ruby-identifier">options</span>) + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-string">'-classpath'</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">cp</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">cp</span>.<span class="ruby-identifier">empty?</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-string">'-sourcepath'</span> <span class="ruby-operator"><<</span> [<span class="ruby-identifier">options</span>[<span class="ruby-value">:sourcepath</span>]].<span class="ruby-identifier">flatten</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">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:sourcepath</span>] + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-string">'-d'</span> <span class="ruby-operator"><<</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">options</span>[<span class="ruby-value">:output</span>].<span class="ruby-identifier">to_s</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:output</span>] + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:javac_args</span>].<span class="ruby-identifier">flatten</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:javac_args</span>] + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">files</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">mkdir_p</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:output</span>] <span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:output</span>] + <span class="ruby-identifier">info</span> <span class="ruby-node">"Compiling #{files.size} source files in #{name}"</span> + <span class="ruby-identifier">trace</span> ([<span class="ruby-string">'javac'</span>] <span class="ruby-operator">+</span> <span class="ruby-identifier">cmd_args</span>).<span class="ruby-identifier">join</span>(<span class="ruby-string">' '</span>) + <span class="ruby-constant">Java</span>.<span class="ruby-identifier">load</span> + <span class="ruby-operator">::</span><span class="ruby-constant">Java</span><span class="ruby-operator">::</span><span class="ruby-identifier">com</span>.<span class="ruby-identifier">sun</span>.<span class="ruby-identifier">tools</span>.<span class="ruby-identifier">javac</span>.<span class="ruby-constant">Main</span>.<span class="ruby-identifier">compile</span>(<span class="ruby-identifier">cmd_args</span>.<span class="ruby-identifier">to_java</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Java</span><span class="ruby-operator">::</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">'Failed to compile, see errors above'</span> + <span class="ruby-keyword">end</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-c-javadoc" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + javadoc(*files, options) + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Runs Javadocs with the specified files and options.</p> + +<p>This method accepts the following special options:</p> +<ul><li> +<p>:output â The output directory</p> +</li><li> +<p>:classpath â Array of classpath dependencies.</p> +</li><li> +<p>:sourcepath â Array of sourcepaths (paths or tasks).</p> +</li><li> +<p>:name â Shows this name, otherwise shows the working directory.</p> +</li></ul> + +<p>All other options are passed to Javadoc as following:</p> +<ul><li> +<p>true â As is, for example, :author=>true becomes -author</p> +</li><li> +<p>false â Prefixed, for example, :index=>false becomes -noindex</p> +</li><li> +<p>string â Option with value, for example, :windowtitle=>'My +project' becomes -windowtitle âMy projectâ</p> +</li><li> +<p>array â Option with set of values separated by spaces.</p> +</li></ul> + + + + + <div class="method-source-code" id="javadoc-source"> + <pre><span class="ruby-comment"># File lib/buildr/java/commands.rb, line 220</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">javadoc</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) + <span class="ruby-identifier">options</span> = <span class="ruby-constant">Hash</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">last</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span> <span class="ruby-operator">:</span> {} + <span class="ruby-identifier">fail</span> <span class="ruby-string">"No output defined for javadoc"</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:output</span>].<span class="ruby-identifier">nil?</span> + <span class="ruby-identifier">options</span>[<span class="ruby-value">:output</span>] = <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">options</span>[<span class="ruby-value">:output</span>].<span class="ruby-identifier">to_s</span>) + <span class="ruby-identifier">cmd_args</span> = [ <span class="ruby-string">'-d'</span>, <span class="ruby-identifier">options</span>[<span class="ruby-value">:output</span>], <span class="ruby-identifier">trace?</span>(<span class="ruby-value">:javadoc</span>) <span class="ruby-operator">?</span> <span class="ruby-string">'-verbose'</span> <span class="ruby-operator">:</span> <span class="ruby-string">'-quiet'</span> ] + <span class="ruby-identifier">options</span>.<span class="ruby-identifier">reject</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-value">:output</span>, <span class="ruby-value">:name</span>, <span class="ruby-value">:sourcepath</span>, <span class="ruby-value">:classpath</span>].<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">key</span>) }. + <span class="ruby-identifier">each</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-identifier">value</span>.<span class="ruby-identifier">invoke</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:invoke</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">case</span> <span class="ruby-identifier">value</span> + <span class="ruby-keyword">when</span> <span class="ruby-keyword">true</span>, <span class="ruby-keyword">nil</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"-#{key}"</span> + <span class="ruby-keyword">when</span> <span class="ruby-keyword">false</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"-no#{key}"</span> + <span class="ruby-keyword">when</span> <span class="ruby-constant">Hash</span> + <span class="ruby-identifier">value</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"-#{key}"</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">v</span>.<span class="ruby-identifier">to_s</span> } + <span class="ruby-keyword">else</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator">+=</span> <span class="ruby-constant">Array</span>(<span class="ruby-identifier">value</span>).<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">item</span><span class="ruby-operator">|</span> [<span class="ruby-node">"-#{key}"</span>, <span class="ruby-identifier">item</span>.<span class="ruby-identifier">to_s</span>] }.<span class="ruby-identifier">flatten</span> + <span class="ruby-keyword">end</span> + <span class="ruby-keyword">end</span> + [<span class="ruby-value">:sourcepath</span>, <span class="ruby-value">:classpath</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">option</span><span class="ruby-operator">|</span> + <span class="ruby-identifier">options</span>[<span class="ruby-identifier">option</span>].<span class="ruby-identifier">to_a</span>.<span class="ruby-identifier">flatten</span>.<span class="ruby-identifier">tap</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">paths</span><span class="ruby-operator">|</span> + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"-#{option}"</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">paths</span>.<span class="ruby-identifier">flatten</span>.<span class="ruby-identifier">map</span>(<span class="ruby-operator">&</span><span class="ruby-value">:to_s</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">paths</span>.<span class="ruby-identifier">empty?</span> + <span class="ruby-keyword">end</span> + <span class="ruby-keyword">end</span> + <span class="ruby-identifier">files</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">each</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">arg</span><span class="ruby-operator">|</span> <span class="ruby-identifier">arg</span>.<span class="ruby-identifier">invoke</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">arg</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:invoke</span>)}.<span class="ruby-identifier">collect</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">arg</span><span class="ruby-operator">|</span> <span class="ruby-identifier">arg</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Project</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">arg</span>.<span class="ruby-identifier">compile</span>.<span class="ruby-identifier">sources</span>.<span class="ruby-identifier">collect</span >{<span class="ruby-operator">|</span><span >class="ruby-identifier">dir</span><span class="ruby-operator">|</span> <span >class="ruby-constant">Dir</span>[<span >class="ruby-node">"#{File.expand_path(dir.to_s)}/**/*.java"</span>]} > <span class="ruby-operator">:</span> <span >class="ruby-constant">File</span>.<span >class="ruby-identifier">expand_path</span>(<span >class="ruby-identifier">arg</span>.<span class="ruby-identifier">to_s</span>) >} + <span class="ruby-identifier">cmd_args</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">files</span>.<span class="ruby-identifier">flatten</span>.<span class="ruby-identifier">uniq</span>.<span class="ruby-identifier">map</span>(<span class="ruby-operator">&</span><span class="ruby-value">:to_s</span>) + <span class="ruby-identifier">name</span> = <span class="ruby-identifier">options</span>[<span class="ruby-value">:name</span>] <span class="ruby-operator">||</span> <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">pwd</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-node">"Generating Javadoc for #{name}"</span> + <span class="ruby-identifier">trace</span> ([<span class="ruby-string">'javadoc'</span>] <span class="ruby-operator">+</span> <span class="ruby-identifier">cmd_args</span>).<span class="ruby-identifier">join</span>(<span class="ruby-string">' '</span>) + <span class="ruby-constant">Java</span>.<span class="ruby-identifier">load</span> + <span class="ruby-operator">::</span><span class="ruby-constant">Java</span><span class="ruby-operator">::</span><span class="ruby-identifier">com</span>.<span class="ruby-identifier">sun</span>.<span class="ruby-identifier">tools</span>.<span class="ruby-identifier">javadoc</span>.<span class="ruby-constant">Main</span>.<span class="ruby-identifier">execute</span>(<span class="ruby-identifier">cmd_args</span>.<span class="ruby-identifier">to_java</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Java</span><span class="ruby-operator">::</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">'Failed to generate Javadocs, see errors above'</span> + <span class="ruby-keyword">end</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + </section> + + <section id="protected-class-5Buntitled-5D-method-details" class="method-section"> + <header> + <h3>Protected Class Methods</h3> + </header> + + + <div id="method-c-classpath_from" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + classpath_from(options) → files + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Extracts the classpath from the options, expands it by calling artifacts, +invokes each of the artifacts and returns an array of paths.</p> + + + + + <div class="method-source-code" id="classpath_from-source"> + <pre><span class="ruby-comment"># File lib/buildr/java/commands.rb, line 274</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">classpath_from</span>(<span class="ruby-identifier">options</span>) + <span class="ruby-constant">Buildr</span>.<span class="ruby-identifier">artifacts</span>(<span class="ruby-identifier">options</span>[<span class="ruby-value">:classpath</span>] <span class="ruby-operator">||</span> []).<span class="ruby-identifier">map</span>(<span class="ruby-operator">&</span><span class="ruby-value">:to_s</span>). + <span class="ruby-identifier">map</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-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">t</span>) } +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-c-path_to_bin" class="method-detail "> + + + <div class="method-heading"> + <span class="method-callseq"> + path_to_bin(cmd?) → path + </span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + + <div class="method-description"> + + <p>Returns the path to the specified <a href="../Java.html">Java</a> command +(with no argument to java itself).</p> + + + + + <div class="method-source-code" id="path_to_bin-source"> + <pre><span class="ruby-comment"># File lib/buildr/java/commands.rb, line 262</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">path_to_bin</span>(<span class="ruby-identifier">name</span> = <span class="ruby-keyword">nil</span>) + <span class="ruby-identifier">home</span> = <span class="ruby-constant">ENV</span>[<span class="ruby-string">'JAVA_HOME'</span>] <span class="ruby-keyword">or</span> <span class="ruby-identifier">fail</span> <span class="ruby-string">'Are we forgetting something? JAVA_HOME not set.'</span> + <span class="ruby-identifier">bin</span> = <span class="ruby-constant">Util</span>.<span class="ruby-identifier">normalize_path</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">home</span>, <span class="ruby-string">'bin'</span>)) + <span class="ruby-identifier">fail</span> <span class="ruby-string">'JAVA_HOME environment variable does not point to a valid JRE/JDK installation.'</span> <span class="ruby-keyword">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span> <span class="ruby-identifier">bin</span> + <span class="ruby-constant">Util</span>.<span class="ruby-identifier">normalize_path</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">bin</span>, <span class="ruby-identifier">name</span>.<span class="ruby-identifier">to_s</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/Java/Options.html ============================================================================== --- dev/buildr/1.5.0/site/rdoc/Java/Options.html (added) +++ dev/buildr/1.5.0/site/rdoc/Java/Options.html Sat Sep 17 06:18:39 2016 @@ -0,0 +1,190 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>class Java::Options - 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="../Object.html">Object</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-java_args">#java_args</a> + + <li ><a href="#method-i-java_args-3D">#java_args=</a> + + </ul> +</div> + + </div> +</nav> + +<main role="main" aria-labelledby="class-Java::Options"> + <h1 id="class-Java::Options" class="class"> + class Java::Options + </h1> + + <section class="description"> + + </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-java_args" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">java_args</span><span + class="method-args">()</span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + <div class="method-description"> + + <p><strong>Deprecated:</strong> Use <a href="'JAVA_OPTS'">ENV</a> instead.</p> + + + + + <div class="method-source-code" id="java_args-source"> + <pre><span class="ruby-comment"># File lib/buildr/java/deprecated.rb, line 64</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">java_args</span> + <span class="ruby-constant">Buildr</span>.<span class="ruby-identifier">application</span>.<span class="ruby-identifier">deprecated</span> <span class="ruby-string">"Use ENV['JAVA_OPTS'] instead"</span> + (<span class="ruby-constant">ENV</span>[<span class="ruby-string">"JAVA_OPTS"</span>] <span class="ruby-operator">||</span> <span class="ruby-constant">ENV</span>[<span class="ruby-string">"JAVA_OPTIONS"</span>]).<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">split</span> +<span class="ruby-keyword">end</span></pre> + </div> + + </div> + + + + + </div> + + + <div id="method-i-java_args-3D" class="method-detail "> + + <div class="method-heading"> + <span class="method-name">java_args=</span><span + class="method-args">(args)</span> + + <span class="method-click-advice">click to toggle source</span> + + </div> + + + <div class="method-description"> + + <p><strong>Deprecated:</strong> Use <a href="'JAVA_OPTS'">ENV</a> instead.</p> + + + + + <div class="method-source-code" id="java_args-3D-source"> + <pre><span class="ruby-comment"># File lib/buildr/java/deprecated.rb, line 70</span> +<span class="ruby-keyword">def</span> <span class="ruby-identifier">java_args=</span>(<span class="ruby-identifier">args</span>) + <span class="ruby-constant">Buildr</span>.<span class="ruby-identifier">application</span>.<span class="ruby-identifier">deprecated</span> <span class="ruby-string">"Use ENV['JAVA_OPTS'] instead"</span> + <span class="ruby-constant">ENV</span>[<span class="ruby-string">'JAVA_OPTS'</span>] = <span class="ruby-constant">Array</span>(<span class="ruby-identifier">args</span>).<span class="ruby-identifier">join</span>(<span class="ruby-string">' '</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/LICENSE.html ============================================================================== --- dev/buildr/1.5.0/site/rdoc/LICENSE.html (added) +++ dev/buildr/1.5.0/site/rdoc/LICENSE.html Sat Sep 17 06:18:39 2016 @@ -0,0 +1,263 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>LICENSE - 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="file"> +<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="project-metadata"> + <div id="fileindex-section" class="nav-section"> + <h3>Pages</h3> + + <ul class="link-list"> + + <li><a href="./CHANGELOG.html">CHANGELOG</a> + + <li><a href="./LICENSE.html">LICENSE</a> + + <li><a href="./NOTICE.html">NOTICE</a> + + <li><a href="./README_rdoc.html">README</a> + + </ul> +</div> + + </div> +</nav> + +<main role="main" aria-label="Page LICENSE"> + +<pre> Apache License + Version 2.0, January 2004 +http://www.apache.org/licenses/</pre> + +<p>TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION</p> +<ol><li> +<p>Definitions.</p> + +<p>âLicenseâ shall mean the terms and conditions for use, reproduction, and +distribution as defined by Sections 1 through 9 of this document.</p> + +<p>âLicensorâ shall mean the copyright owner or entity authorized by the +copyright owner that is granting the License.</p> + +<p>âLegal Entityâ shall mean the union of the acting entity and all other +entities that control, are controlled by, or are under common control with +that entity. For the purposes of this definition, âcontrolâ means (i) the +power, direct or indirect, to cause the direction or management of such +entity, whether by contract or otherwise, or (ii) ownership of fifty +percent (50%) or more of the outstanding shares, or (iii) beneficial +ownership of such entity.</p> + +<p>âYouâ (or âYourâ) shall mean an individual or Legal Entity exercising +permissions granted by this License.</p> + +<p>âSourceâ form shall mean the preferred form for making modifications, +including but not limited to software source code, documentation source, +and configuration files.</p> + +<p>âObjectâ form shall mean any form resulting from mechanical transformation +or translation of a Source form, including but not limited to compiled +object code, generated documentation, and conversions to other media types.</p> + +<p>âWorkâ shall mean the work of authorship, whether in Source or <a +href="Object.html">Object</a> form, made available under the License, as +indicated by a copyright notice that is included in or attached to the work +(an example is provided in the Appendix below).</p> + +<p>âDerivative Worksâ shall mean any work, whether in Source or <a +href="Object.html">Object</a> form, that is based on (or derived from) the +Work and for which the editorial revisions, annotations, elaborations, or +other modifications represent, as a whole, an original work of authorship. +For the purposes of this License, Derivative Works shall not include works +that remain separable from, or merely link (or bind by name) to the +interfaces of, the Work and Derivative Works thereof.</p> + +<p>âContributionâ shall mean any work of authorship, including the original +version of the Work and any modifications or additions to that Work or +Derivative Works thereof, that is intentionally submitted to Licensor for +inclusion in the Work by the copyright owner or by an individual or Legal +Entity authorized to submit on behalf of the copyright owner. For the +purposes of this definition, âsubmittedâ means any form of electronic, +verbal, or written communication sent to the Licensor or its +representatives, including but not limited to communication on electronic +mailing lists, source code control systems, and issue tracking systems that +are managed by, or on behalf of, the Licensor for the purpose of discussing +and improving the Work, but excluding communication that is conspicuously +marked or otherwise designated in writing by the copyright owner as âNot a +Contribution.â</p> + +<p>âContributorâ shall mean Licensor and any individual or Legal Entity on +behalf of whom a Contribution has been received by Licensor and +subsequently incorporated within the Work.</p> +</li><li> +<p>Grant of Copyright License. Subject to the terms and conditions of this +License, each Contributor hereby grants to You a perpetual, worldwide, +non-exclusive, no-charge, royalty-free, irrevocable copyright license to +reproduce, prepare Derivative Works of, publicly display, publicly perform, +sublicense, and distribute the Work and such Derivative Works in Source or +<a href="Object.html">Object</a> form.</p> +</li><li> +<p>Grant of Patent License. Subject to the terms and conditions of this +License, each Contributor hereby grants to You a perpetual, worldwide, +non-exclusive, no-charge, royalty-free, irrevocable (except as stated in +this section) patent license to make, have made, use, offer to sell, sell, +import, and otherwise transfer the Work, where such license applies only to +those patent claims licensable by such Contributor that are necessarily +infringed by their Contribution(s) alone or by combination of their +Contribution(s) with the Work to which such Contribution(s) was submitted. +If You institute patent litigation against any entity (including a +cross-claim or counterclaim in a lawsuit) alleging that the Work or a +Contribution incorporated within the Work constitutes direct or +contributory patent infringement, then any patent licenses granted to You +under this License for that Work shall terminate as of the date such +litigation is filed.</p> +</li><li> +<p>Redistribution. You may reproduce and distribute copies of the Work or +Derivative Works thereof in any medium, with or without modifications, and +in Source or <a href="Object.html">Object</a> form, provided that You meet +the following conditions:</p> + +<p>(a) You must give any other recipients of the Work or</p> + +<pre>Derivative Works a copy of this License; and</pre> + +<p>(b) You must cause any modified files to carry prominent notices</p> + +<pre>stating that You changed the files; and</pre> + +<p>© You must retain, in the Source form of any Derivative Works</p> + +<pre>that You distribute, all copyright, patent, trademark, and +attribution notices from the Source form of the Work, +excluding those notices that do not pertain to any part of +the Derivative Works; and</pre> + +<p>(d) If the Work includes a âNOTICEâ text file as part of its</p> + +<pre>distribution, then any Derivative Works that You distribute must +include a readable copy of the attribution notices contained +within such NOTICE file, excluding those notices that do not +pertain to any part of the Derivative Works, in at least one +of the following places: within a NOTICE text file distributed +as part of the Derivative Works; within the Source form or +documentation, if provided along with the Derivative Works; or, +within a display generated by the Derivative Works, if and +wherever such third-party notices normally appear. The contents +of the NOTICE file are for informational purposes only and +do not modify the License. You may add Your own attribution +notices within Derivative Works that You distribute, alongside +or as an addendum to the NOTICE text from the Work, provided +that such additional attribution notices cannot be construed +as modifying the License.</pre> + +<p>You may add Your own copyright statement to Your modifications and may +provide additional or different license terms and conditions for use, +reproduction, or distribution of Your modifications, or for any such +Derivative Works as a whole, provided Your use, reproduction, and +distribution of the Work otherwise complies with the conditions stated in +this License.</p> +</li><li> +<p>Submission of Contributions. Unless You explicitly state otherwise, any +Contribution intentionally submitted for inclusion in the Work by You to +the Licensor shall be under the terms and conditions of this License, +without any additional terms or conditions. Notwithstanding the above, +nothing herein shall supersede or modify the terms of any separate license +agreement you may have executed with Licensor regarding such Contributions.</p> +</li><li> +<p>Trademarks. This License does not grant permission to use the trade names, +trademarks, service marks, or product names of the Licensor, except as +required for reasonable and customary use in describing the origin of the +Work and reproducing the content of the <a href="NOTICE.html">NOTICE</a> +file.</p> +</li><li> +<p>Disclaimer of Warranty. Unless required by applicable law or agreed to in +writing, Licensor provides the Work (and each Contributor provides its +Contributions) on an âAS ISâ BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied, including, without limitation, any +warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or +FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for +determining the appropriateness of using or redistributing the Work and +assume any risks associated with Your exercise of permissions under this +License.</p> +</li><li> +<p>Limitation of Liability. In no event and under no legal theory, whether in +tort (including negligence), contract, or otherwise, unless required by +applicable law (such as deliberate and grossly negligent acts) or agreed to +in writing, shall any Contributor be liable to You for damages, including +any direct, indirect, special, incidental, or consequential damages of any +character arising as a result of this License or out of the use or +inability to use the Work (including but not limited to damages for loss of +goodwill, work stoppage, computer failure or malfunction, or any and all +other commercial damages or losses), even if such Contributor has been +advised of the possibility of such damages.</p> +</li><li> +<p>Accepting Warranty or Additional Liability. While redistributing the Work +or Derivative Works thereof, You may choose to offer, and charge a fee for, +acceptance of support, warranty, indemnity, or other liability obligations +and/or rights consistent with this License. However, in accepting such +obligations, You may act only on Your own behalf and on Your sole +responsibility, not on behalf of any other Contributor, and only if You +agree to indemnify, defend, and hold each Contributor harmless for any +liability incurred by, or claims asserted against, such Contributor by +reason of your accepting any such warranty or additional liability.</p> +</li></ol> + +<p>END OF TERMS AND CONDITIONS</p> +</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/Module.html ============================================================================== --- dev/buildr/1.5.0/site/rdoc/Module.html (added) +++ dev/buildr/1.5.0/site/rdoc/Module.html Sat Sep 17 06:18:39 2016 @@ -0,0 +1,105 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>class Module - 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="Object.html">Object</a> + +</div> + + + + + </div> +</nav> + +<main role="main" aria-labelledby="class-Module"> + <h1 id="class-Module" class="class"> + class Module + </h1> + + <section class="description"> + +<p>Workaround for BUILDR-535: when requiring 'ffi', JRuby defines an +:error method with arity 0.</p> + + </section> + + + + + <section id="5Buntitled-5D" class="documentation-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/NOTICE.html ============================================================================== --- dev/buildr/1.5.0/site/rdoc/NOTICE.html (added) +++ dev/buildr/1.5.0/site/rdoc/NOTICE.html Sat Sep 17 06:18:39 2016 @@ -0,0 +1,116 @@ +<!DOCTYPE html> + +<html> +<head> +<meta charset="UTF-8"> + +<title>NOTICE - 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="file"> +<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="project-metadata"> + <div id="fileindex-section" class="nav-section"> + <h3>Pages</h3> + + <ul class="link-list"> + + <li><a href="./CHANGELOG.html">CHANGELOG</a> + + <li><a href="./LICENSE.html">LICENSE</a> + + <li><a href="./NOTICE.html">NOTICE</a> + + <li><a href="./README_rdoc.html">README</a> + + </ul> +</div> + + </div> +</nav> + +<main role="main" aria-label="Page NOTICE"> + +<p>Apache <a href="Buildr.html">Buildr</a> Copyright 2007-2016 The Apache +Software Foundation</p> + +<p>This product includes software developed at The Apache Software Foundation +(<a href="http://www.apache.org">www.apache.org</a>/).</p> + +<p>COPYRIGHT NOTICES</p> +<hr> + +<p>Copyright 2007 Intalio</p> + +<p>This product includes software developed by Intalio <a +href="http://www.intalio.com">www.intalio.com</a></p> + +<p>MATERIALS IN DOCUMENTATION</p> +<hr> + +<p>The following materials are incorporated into the documentation of this +software.</p> +<ul><li> +<p>DejaVu - <a href="http://dejavu.sourceforge.net">dejavu.sourceforge.net</a></p> +</li></ul> + +<p>Copyright © 2003 by Bitstream, Inc. All Rights Reserved. Bitstream Vera is +a trademark of Bitstream, Inc.</p> +<ul><li> +<p>ColorCons - <a href="http://www.mouserunner.com">www.mouserunner.com</a>/</p> +</li></ul> + +<p>Copyright © 2006 Ken Saunders</p> +</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> +