buildr 1.4.6-java → 1.4.7-java

data/addon/buildr/xmlbeans.rb

@@ -13,11 +13,6 @@
 # License for the specific language governing permissions and limitations under
 # the License.
 
-
-require 'buildr/java'
-require 'buildr/java/ant'
-
-
 module Buildr
 
   # Provides XMLBeans schema compiler. Require explicitly using <code>require "buildr/xmlbeans"</code>.

data/buildr.gemspec

@@ -15,8 +15,13 @@
 
 unless defined?(Buildr::VERSION)
   require File.join(File.dirname(__FILE__), 'lib', 'buildr', 'version.rb')
+  $LOADED_FEATURES << 'buildr/version.rb'
 end
 
+# Rakefile needs to create spec for both platforms (ruby and java), using the
+# $platform global variable.  In all other cases, we figure it out from RUBY_PLATFORM.
+$platform ||= RUBY_PLATFORM[/java/] || 'ruby'
+
 Gem::Specification.new do |spec|
   spec.name           = 'buildr'
   spec.version        = Buildr::VERSION.dup
@@ -33,9 +38,7 @@ for those one-off tasks, with a language that's a joy to use.
   TEXT
   spec.rubyforge_project  = 'buildr'
 
-  # Rakefile needs to create spec for both platforms (ruby and java), using the
-  # $platform global variable.  In all other cases, we figure it out from RUBY_PLATFORM.
-  spec.platform       = $platform || RUBY_PLATFORM[/java/] || 'ruby'
+  spec.platform       = $platform
 
   spec.files          = Dir['{addon,bin,doc,etc,lib,rakelib,spec}/**/*', '*.{gemspec,buildfile}'] +
                         ['LICENSE', 'NOTICE', 'CHANGELOG', 'README.rdoc', 'Rakefile', '_buildr', '_jbuildr']
@@ -48,30 +51,42 @@ for those one-off tasks, with a language that's a joy to use.
                           '--webcvs', 'http://svn.apache.org/repos/asf/buildr/trunk/'
   spec.post_install_message = "To get started run buildr --help"
 
+  spec.required_rubygems_version = ">= 1.8.6"
+
   # Tested against these dependencies.
-  spec.add_dependency 'rake',                 '0.8.7'
+  spec.add_dependency 'rake',                 '0.9.2.2'
   spec.add_dependency 'builder',              '2.1.2'
-  spec.add_dependency 'net-ssh',              '2.0.23'
-  spec.add_dependency 'net-sftp',             '2.0.4'
+  spec.add_dependency 'net-ssh',              '2.3.0'
+  spec.add_dependency 'net-sftp',             '2.0.5'
   spec.add_dependency 'rubyzip',              '0.9.4'
-  spec.add_dependency 'highline',             '1.5.1'
+  spec.add_dependency 'highline',             '1.6.2'
   spec.add_dependency 'json_pure',            '1.4.3'
   spec.add_dependency 'rubyforge',            '2.0.3'
   spec.add_dependency 'hoe',                  '2.3.3'
-  spec.add_dependency 'rjb',                  '1.3.3' if spec.platform.to_s == 'ruby'
-  spec.add_dependency 'rjb',                  '1.3.2' if spec.platform.to_s == 'x86-mswin32'
-  spec.add_dependency 'atoulme-Antwrap',      '0.7.1'
-  spec.add_dependency 'diff-lcs',             '1.1.2'
-  spec.add_dependency 'rspec-expectations',   '2.1.0'
-  spec.add_dependency 'rspec-mocks',          '2.1.0'
-  spec.add_dependency 'rspec-core',           '2.1.0'
-  spec.add_dependency 'rspec',                '2.1.0'
+  spec.add_dependency 'rjb',                  '1.4.0' if ($platform.to_s == 'x86-mswin32' || $platform.to_s == 'ruby')
+  spec.add_dependency 'atoulme-Antwrap',      '~> 0.7.2'
+  spec.add_dependency 'diff-lcs',             '1.1.3'
+  spec.add_dependency 'rspec-expectations',   '2.9.0'
+  spec.add_dependency 'rspec-mocks',          '2.9.0'
+  spec.add_dependency 'rspec-core',           '2.9.0'
+  spec.add_dependency 'rspec',                '2.9.0'
   spec.add_dependency 'xml-simple',           '1.0.12'
   spec.add_dependency 'minitar',              '0.5.3'
-  spec.add_dependency 'jruby-openssl',        '>= 0.7' if spec.platform.to_s == 'java'
-  spec.add_development_dependency 'jekyll',   '~> 0.10.0'
-  spec.add_development_dependency 'sdoc'
-  spec.add_development_dependency 'rcov', '0.9.9' unless spec.platform.to_s == 'java'
-  spec.add_development_dependency 'win32console' if spec.platform.to_s == 'x86-mswin32'
-  spec.add_development_dependency 'jekylltask', '>= 1.0.2' unless spec.platform.to_s == 'java'
+  spec.add_dependency 'jruby-openssl',        '>= 0.7' if $platform.to_s == 'java'
+
+  # The documentation is currently not generated whe building via jruby
+  unless $platform.to_s == 'java'
+    spec.add_development_dependency 'jekyll', '0.11.2'
+    spec.add_development_dependency 'RedCloth', '4.2.9'
+    spec.add_development_dependency 'jekylltask', '1.1.0'
+    spec.add_development_dependency 'rdoc', '3.8'
+    spec.add_development_dependency 'rcov', '0.9.9'
+  end
+
+  spec.add_development_dependency 'ci_reporter', '1.6.3'
+
+  spec.add_development_dependency 'ffi-ncurses', '0.4.0' if $platform.to_s == 'java'
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'win32console' if $platform.to_s == 'x86-mswin32'
+  spec.add_development_dependency 'rubyforge'
 end

data/doc/_layouts/default.html

@@ -58,6 +58,7 @@
               <li><a href='mailing_lists.html'>Mailing Lists</a></li>
               <li><a href='http://www.twitter.com/buildr'>Twitter</a></li>
               <li><a href='http://issues.apache.org/jira/browse/Buildr'>Issues/Bugs</a></li>
+              <li><a href='https://builds.apache.org/view/A-F/view/Buildr'>CI Jobs</a></li>
               <li><a href='contributing.html'>Contributing</a></li>
               <li><a href='specs.html'>Specs</a></li>
               <li><a href='coverage/index.html'>Coverage</a></li>

data/doc/contributing.textile

@@ -16,7 +16,8 @@ We run two mailing lists, the "users":http://buildr.markmail.org/search/list:use
 
 Check the "mailing lists":mailing_lists.html page for more information on subscribing, searching and posting to the mailing list.
 
-h2(#IRC). IRC
+
+h2(#irc).  Internet Relay Chat
 
 We are live on IRC under the buildr channel on irc.freenode.net, with a broad coverage of the US timezone. We tend to idle there, so feel free to ping the channel owner (toulmean) to make noise.
 
@@ -233,6 +234,14 @@ $ open buildr.pdf
 {% endhighlight %}
 
 
+h2(#ci).  Continuous Integration
+
+Buildr uses the Jenkins continuous integration tool to perform builds, run tests and report back on problems when changes are made to the source code repository.
+
+The care and feeding of the "CI Jobs":https://builds.apache.org/view/A-F/view/Buildr is the responsibility of the committers. To get access to configure the CI Jobs a committer needs to follow the directions on the "jenkins":http://wiki.apache.org/general/Hudson documentation site.
+
+You may also need to coordinate with the Apache infrastructure team to get accounts on the actual slave hosts that run the CI jobs. This access may be required to install tools and gems required to run the CI jobs. The main slave host to get access to is vesta.apache.org at the time of writing. You can also log on to the slave host, impersonate hudson and manually run tasks when you are attempting to track down build problems. Of course to impersonate hudson you will need to learn how to use "OPIE.":http://apache.org/dev/freebsd-jails
+
 h2(#contributors).  Contributors
 
 Here is the list of people who are actively working and committing on Buildr:
@@ -263,6 +272,6 @@ Daniel originally came to Buildr in search of a Scala build tool which was bette
 
 Antoine used Buildr first as an excuse to evade in Ruby land, creating plugins for Debian packaging, GWT compilation, or the NSIS installer. His main area of interest is the resolving of dependencies in the OSGi world. He works on making Buildr a standalone rock solid tool.
 
-* Peter Donald
+*Peter Donald*
 
 Peter already used rake to automate jobs in his ruby and java projects. When it came time to upgrade that home grown ant/java/rake build system Buildr seemed the perfect match.

data/doc/download.textile

@@ -20,14 +20,26 @@ The source code is included in both source and binary distribution, the Gem dist
 
 h2(#dist).  Binaries and Source Code
 
+h3. buildr 1.4.6 (2011-06-22)
+
+|_. Package |_. MD5 Checksum |_. PGP |
+| "buildr-1.4.6-java.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.6/buildr-1.4.6-java.gem | "4b5952d99abd59bd1d296bf21b4854e2":http://www.apache.org/dist/buildr/1.4.6/buildr-1.4.6-java.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.6/buildr-1.4.6-java.gem.asc |
+| "buildr-1.4.6-x86-mswin32.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.6/buildr-1.4.6-x86-mswin32.gem | "2c89b87a44f7f957169434969d2cdaed":http://www.apache.org/dist/buildr/1.4.6/buildr-1.4.6-x86-mswin32.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.6/buildr-1.4.6-x86-mswin32.gem.asc |
+| "buildr-1.4.6.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.6/buildr-1.4.6.gem | "4d6848a6370925e54135c36f5085be94":http://www.apache.org/dist/buildr/1.4.6/buildr-1.4.6.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.6/buildr-1.4.6.gem.asc |
+| "buildr-1.4.6.tgz":http://www.apache.org/dyn/closer.cgi/buildr/1.4.6/buildr-1.4.6.tgz | "3b76c4037d3ad95c79c3dd8d07805fb0":http://www.apache.org/dist/buildr/1.4.6/buildr-1.4.6.tgz.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.6/buildr-1.4.6.tgz.asc |
+| "buildr-1.4.6.zip":http://www.apache.org/dyn/closer.cgi/buildr/1.4.6/buildr-1.4.6.zip | "e9b7a313d7ac726c0a74c62afa7bfdc5":http://www.apache.org/dist/buildr/1.4.6/buildr-1.4.6.zip.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.6/buildr-1.4.6.zip.asc |
+
+p>. ("Release signing keys":http://www.apache.org/dist/buildr/1.4.6/KEYS)
+
+
 h3. buildr 1.4.5 (2011-02-21)
 
 |_. Package |_. MD5 Checksum |_. PGP |
-| "buildr-1.4.5.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.5/buildr-1.4.5.gem | "57cccec175e0b1b682a36f75e54d15cf":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.gem.asc |
-| "buildr-1.4.5-x86-mswin32.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.5/buildr-1.4.5-x86-mswin32.gem | "d24b11446eaa01e24b9ec1be4b6d93d1":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5-x86-mswin32.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5-x86-mswin32.gem.asc |
-| "buildr-1.4.5-java.gem":http://www.apache.org/dyn/closer.cgi/buildr/1.4.5/buildr-1.4.5-java.gem | "c167e67e33e7c3b4bf2316d7405eb11e":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5-java.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5-java.gem.asc |
-| "buildr-1.4.5.tgz":http://www.apache.org/dyn/closer.cgi/buildr/1.4.5/buildr-1.4.5.tgz | "9b335479ce006caf109c4786d83aa00c":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.tgz.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.tgz.asc |
-| "buildr-1.4.5.zip":http://www.apache.org/dyn/closer.cgi/buildr/1.4.5/buildr-1.4.5.zip | "0d3b3b474a3c90c717bdc953aab8e626":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.zip.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.zip.asc |
+| "buildr-1.4.5.gem":http://archive.apache.org/dist/buildr/1.4.5/buildr-1.4.5.gem | "57cccec175e0b1b682a36f75e54d15cf":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.gem.asc |
+| "buildr-1.4.5-x86-mswin32.gem":http://archive.apache.org/dist/buildr/1.4.5/buildr-1.4.5-x86-mswin32.gem | "d24b11446eaa01e24b9ec1be4b6d93d1":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5-x86-mswin32.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5-x86-mswin32.gem.asc |
+| "buildr-1.4.5-java.gem":http://archive.apache.org/dist/buildr/1.4.5/buildr-1.4.5-java.gem | "c167e67e33e7c3b4bf2316d7405eb11e":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5-java.gem.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5-java.gem.asc |
+| "buildr-1.4.5.tgz":http://archive.apache.org/dist/buildr/1.4.5/buildr-1.4.5.tgz | "9b335479ce006caf109c4786d83aa00c":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.tgz.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.tgz.asc |
+| "buildr-1.4.5.zip":http://archive.apache.org/dist/buildr/1.4.5/buildr-1.4.5.zip | "0d3b3b474a3c90c717bdc953aab8e626":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.zip.md5 | "Sig":http://www.apache.org/dist/buildr/1.4.5/buildr-1.4.5.zip.asc |
 
 p>. ("Release signing keys":http://www.apache.org/dist/buildr/1.4.5/KEYS)
 

data/doc/index.textile

@@ -46,52 +46,27 @@ So let's get started.  You can "read the documentation online":quick_start.html,
 
 h2(#news).  What's New
 
-New in Buildr 1.4.5 (Feb. 20th, 2011)
-
-* Added:  BUILDR-555 Add support for the jaxb binding compiler (Mark Petrovic)
-* Added:  BUILDR-554 Add support for OSGi bundle packages by importing the
-          buildr_bnd plugin
-* Added:  BUILDR-125 Add support for <security-role> in application.xml of
-          EAR packaging (Mikael Amborn)
-* Added:  BUILDR-550 Add support for groovydoc
-* Added:  BUILDR-521: System tray notifications for Linux systems
-          (via libnotify/notify-send)
-* Added:  BUILDR-537 Shell tasks should use JAVA_OPTS by default
-* Added:  BUILDR-538 Shell tasks should support passing :java_args
-* Added:  BUILDR-544 Support ${groupId} in pom files (Chris Dean)
-* Added:  BUILDR-552 Projects may now be defined using project(:name) and a block
-* Added:  BUILDR-564 Add package(:scaladoc)
-* Added:  Automatically add "require buildr/{groovy,scala}"  when generating
-          project if Groovy/Scala files are detected.
-* Change: BUILDR-540 Upgrade to rspec 2.1.0
-* Change: BUILDR-546 Upgrade to Rubyzip 0.9.4 (Michael Guymon)
-* Change: BUILDR-556 Merge buildr-iidea extension back into buildr.
-* Change: Upgrade default Scala compiler version to 2.8.1-final
-* Change: Upgrade to ScalaCheck 1.8
-* Change: Upgrade to ScalaTest 1.3
-* Change: Upgrade to Specs 1.6.6
-* Change: Upgrade to JRuby 1.5.6
-* Fixed:  BUILDR-542 Release task:  SVN tagging fails if parent tag directory
-          does not exist yet (Gerolf Seitz)
-* Fixed:  BUILDR-543 POMs are installed and uploaded twice when using artifacts
-          with classifier
-* Fixed:  BUILDR-522 Send notifications when continuous compilation
-          succeeds/fails.
-* Fixed:  BUILDR-551 Continuous compilation not working for project trees
-* Fixed:  BUILDR-557 MD5 + SHA1 checksums are not Maven compliant (Tammo van Lessen)
-* Change: Upgrade to Groovy 1.7.5
-* Change: BUILDR-545 Add the ability to specify the description element in in
-          application.xml contained within an ear.
-* Fixed:  BUILDR-547 - Ensure ECJ compiler works when there is a space in the
-          path of dependencies.
-* Fixed:  BUILDR-558 Artifact uploads should show a progress bar (Tammo van Lessen)
-* Fixed:  BUILDR-560 show a meaning full error message when POM cannot be parsed
-          (Tammo van Lessen)
-* Fixed:  BUILDR-562 WAR package isn't updated if files under src/main/webapp
-          are updated
-* Fixed:  BUILDR-569 Buildr fails under JRuby 1.6.0.RC1 due to read-only $? variable
-* Fixed:  BUILDR-570 Buildr does not work with Rubygems 1.5.x
-* Fixed:  Scaladoc task would cause build to exit prematurely
+New in Buildr 1.4.6 (June 24th, 2011)
+
+* Added:  Support for Scala 2.9.0+ (with help of Alexis Midon)
+* Added:  BUILDR-592 Allow Users to Specify SSH Options for Deployment (Marc-André Laverdière)
+* Fixed:  BUILDR-591 IntelliJ Sort modules in iml files generated by idea task to ensure main_dependencies are exported
+* Fixed:  BUILDR-583 Update jruby install to use jruby version 1.6.1 (Alexis Midon)
+* Fixed:  BUILDR-582 Revert the name change for the task to generate Intellij project files to 'idea'
+* Change: BUILDR-579 Format generated IDEA project files to look more like what IntelliJ generates (Peter Royal)
+* Change: BUILDR-574 Enhance idea task to generate test resources with test scope (Jean-Philippe Caruana)
+* Change: BUILDR-576 Upgrade to JUnit 4.8.2
+* Change: Upgrade to JRuby 1.6.2
+* Change: Scala 2.9.0-1 is now default, along with ScalaCheck 1.9, ScalaTest 1.6.1 and Specs 1.6.8.
+* Change: ScalaCheck, ScalaTest and Specs now default to sane versions when using older Scala versions.
+* Fixed:  BUILDR-571 Generated IDEA projects include resources multiple times (Peter Royal)
+* Fixed:  BUILDR-573 HTTP upload PUT request with incorrect Content-Type (Mathias Doenitz)
+* Fixed:  BUILDR-578 Tar task does not preserve uid/gid on folders (Jean-Philippe Caruana)
+* Fixed:  BUILDR-251 Classifier not handled when downloading snapshot artifacts (Ryan Fowler)
+* Fixed:  BUILDR-585 "TypeError : can't dup NilClass" when merging jars
+* Fixed:  BUILDR-586 ScalaTest uses deprecated ant task (Martin Partel)
+* Fixed:  BUILDR-584 eclipse plugin should use absolute path
+* Fixed:  BUILDR-587 ScalaTest uses deprecated reporter parameters
 
 See the "CHANGELOG":CHANGELOG for full details.
 

data/doc/installing.textile

@@ -3,6 +3,21 @@ layout: default
 title: Installing and Running
 ---
 
+h1(#all-in-one). All In One Bundle
+
+Contributors to this project maintain a separate distribution over on "RubyForge":http://rubyforge.org/projects/buildr. Using this distribution, it is possible to install Buildr just like you would install Apache Ant or Apache Maven. It comes bundled with JRuby and distributed as a cross-platform zip or tar.gz file.
+
+The RubyForge distribution is *not* an official Apache distribution. The all-in-one bundles are hosted on the "Files page":http://rubyforge.org/frs/?group_id=3180.
+
+*In details:* Navigate to "Rubyforge's buildr's Files page":http://rubyforge.org/frs/?group_id=3180 and download the all-in-one bundle for the latest version available.
+
+Unzip the bundle in a convenient location. 
+
+You can execute the buildr executable under the bin directory directly. 
+
+You should consider adding the bin directory of the result to the @PATH@ global environment variable. See "Installing Buildr for JRuby":#jruby for instructions to update it.  
+
+h1(#the-gem). Installing the gem
 
 *The easy way:*  We recommend you pick the platform you want to run Buildr on and then follow the _easy way_ instructions for that platform.  It could save you an hour or two struggling to install all the right dependencies.
 
@@ -116,13 +131,7 @@ h2(#windows).  Installing on Windows
 
 <br>
 
-*In details:* We recommend you first upgrade to the latest version of Ruby gems:
-
-{% highlight sh %}
-> gem update --system
-{% endhighlight %}
-
-Before installing Buildr, please set the @JAVA_HOME@ environment variable to point to your JDK distribution.  Next, use Ruby Gem to install Buildr:
+*In details:* Before installing Buildr, please set the @JAVA_HOME@ environment variable to point to your JDK distribution.  Next, use Ruby Gem to install Buildr:
 
 {% highlight sh %}
 > gem install buildr --platform mswin32
@@ -222,7 +231,8 @@ There are several options you can use, for a full list of options type @buildr -
 | @-q/--quiet@              | Do not log messages to standard output.                 |
 | @-r/--require [file]@     | Require MODULE before executing buildfile.              |
 | @-t/--trace@              | Turn on invoke/execute tracing, enable full backtrace.  |
-| @-v/--version@            | Display the program version.                            |
+| @-v/--verbose@            | Log message to standard output                          |
+| @-V/--version@            | Display the program version.                            |
 | @-P/--prereqs@            | Display tasks and dependencies, then exit.              |
 
 You can tell Buildr to run specific tasks and the order to run them.  For example:

data/doc/installing.textile.orig

@@ -0,0 +1,282 @@
+---
+layout: default
+title: Installing and Running
+---
+
+
+*The easy way:*  We recommend you pick the platform you want to run Buildr on and then follow the _easy way_ instructions for that platform.  It could save you an hour or two struggling to install all the right dependencies.
+
+"Installing Buildr for JRuby":#jruby is the same on all operating systems.  Choose JRuby if you're working with Java 6 on OS X, developing with multiple JDKs, or just like JRuby better.
+
+If you are running behind a proxy server, make sure the environment variable @HTTP_PROXY@ is set, as many of these steps require HTTP access.
+
+<br>
+
+*In details:* The @gem install@ and @gem update@ commands install Buildr from a binary distribution provided through "RubyForge":http://rubyforge.org/projects/buildr. This distribution is maintained by contributors to this project, but is *not* an official Apache distribution.  You can obtain the official Apache distribution files from the "download page":download.html.
+
+Older versions of RubyGems are all kind of fail.  You want to avoid these unless you have the patience to install each Buildr dependency manually.  Get RubyGems 1.3.1 or later, and when using Debian packages (e.g. Ubuntu), make sure to get the unmolested RubyGems straight form the source.
+
+The Ruby interpreter and JVM must use compatible architectures.  For example, OS X comes with 32-bit version of Ruby, Java 1.5 in both 32-bit and 64-bit flavors, and 64-bit Java 6.  As a result you can run Ruby with Java 1.5 (32-bit), but to use Java 6 you either need to build Ruby from source for 64-bit, or use "Buildr for JRuby":#jruby.
+
+h2(#linux).  Installing on Linux
+
+*The easy way:* Use this bash script to "install Buildr on Linux":scripts/install-linux.sh.  This script will install the most recent version of Buildr, or if already installed, upgrade to the most recent version.  It will also install Ruby 1.8.6 if not already installed (requires @apt-get@, @yum@ or @urpmi@) and upgrade to RubyGems 1.3.1 or later.
+
+<br>
+
+*In details:* To get started you will need a recent version of Ruby, Ruby Gems and build tools for compiling native libraries (@make@, @gcc@ and standard headers).
+
+On *RedHat/Fedora* you can use yum to install Ruby and RubyGems, and then upgrade to the most recent version of RubyGems:
+
+{% highlight sh %}
+$ sudo yum install ruby rubygems ruby-devel gcc
+$ sudo gem update --system
+{% endhighlight %}
+
+On *Ubuntu* you have to install several packages:
+
+{% highlight sh %}
+$ sudo apt-get install ruby-full ruby1.8-dev libopenssl-ruby build-essential
+{% endhighlight %}
+
+If using Ubuntu 9.10 or earlier, the Debian package for @rubygems@ will not allow you to install Buildr, so you need to install RubyGems from source:
+
+{% highlight sh %}
+$ wget http://rubyforge.org/frs/download.php/45905/rubygems-1.3.1.tgz
+$ tar xzf rubygems-1.3.1.tgz
+$ cd rubygems-1.3.1
+$ sudo ruby setup.rb
+$ sudo ln -s /usr/bin/gem1.8 /usr/bin/gem
+{% endhighlight %}
+
+Before installing Buildr, please set the @JAVA_HOME@ environment variable to point to your JDK distribution.  Next, use Ruby Gem to install Buildr:
+
+{% highlight sh %}
+$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr
+{% endhighlight %}
+
+To upgrade to a new version or install a specific version:
+
+{% highlight sh %}
+$ sudo env JAVA_HOME=$JAVA_HOME gem update buildr
+$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr -v 1.4.3
+{% endhighlight %}
+
+
+h2(#osx).  Installing on OS X
+
+*The easy way:* Use this script to "install Buildr on OS X":scripts/install-osx.sh.  This script will install the most recent version of Buildr, or if already installed, upgrade to the most recent version.  It will also install Ruby 1.8.6 if not already installed (using MacPorts/Fink) and upgrage RubyGems to 1.3.1 or later.
+
+You need to have the Apple Development Tools installed.  They are available on the Mac OSX installation CD.
+
+p(note). Java Update 3 for Snow Leopard removes header files necessary to compile the native Ruby-Java Bridge (RJB) gem, so installing rjb gem may fail on OS X.  The solution is to install Java for Mac OS X 10.6 Update 3 Developer Package from http://connect.apple.com before @gem install@.
+
+*Using RVM?* If you're not using the built-in ruby on OS X (e.g., if you're using RVM), you'll need to force-install the platform-independent RJB:
+
+{% highlight sh %}
+$ gem install rjb -v 1.3.3 --platform ruby
+{% endhighlight %}
+
+The darwin pre-built binary seems to only work with the built-in ruby.
+
+<br>
+
+*In details:* OS X 10.5 (Leopard) comes with a recent version of Ruby 1.8.6.  You do not need to install a different version of Ruby when running OS X 10.5.
+
+OS X 10.4 (Tiger) includes an older version of Ruby that is not compatible with Buildr.  You can install Ruby 1.8.6 using MacPorts (@sudo port install ruby rb-rubygems@), Fink or the "Ruby One-Click Installer for OS X":http://rubyosx.rubyforge.org/.
+
+We recommend you first upgrade to the latest version of Ruby gems:
+
+{% highlight sh %}
+$ sudo gem update --system
+{% endhighlight %}
+
+Before installing Buildr, please set the @JAVA_HOME@ environment variable to point to your JDK distribution:
+
+{% highlight sh %}
+$ export JAVA_HOME=/Library/Java/Home
+{% endhighlight %}
+
+To install Buildr:
+
+{% highlight sh %}
+$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr
+{% endhighlight %}
+
+To upgrade to a new version or install a specific version:
+
+{% highlight sh %}
+$ sudo env JAVA_HOME=$JAVA_HOME gem update buildr
+$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr -v 1.3.4
+{% endhighlight %}
+
+h2(#windows).  Installing on Windows
+
+*The easy way:*  The easiest way to install Ruby is using the "one-click installer":http://rubyinstaller.rubyforge.org/.  Be sure to install Ruby 1.8.6; support for Ruby 1.9.x is still a work in progress.  Once installed, set the @JAVA_HOME@ environment variable and run @gem install buildr --platform mswin32@.
+
+<br>
+
+*In details:* Before installing Buildr, please set the @JAVA_HOME@ environment variable to point to your JDK distribution.  Next, use Ruby Gem to install Buildr:
+
+{% highlight sh %}
+> gem install buildr --platform mswin32
+{% endhighlight %}
+
+To upgrade to a new version or install a specific version:
+
+{% highlight sh %}
+> gem update buildr
+> gem install buildr -v 1.3.4 --platform mswin32
+{% endhighlight %}
+
+h2(#jruby).  Installing for JRuby
+
+*The easy way:* Use this bash script to "install Buildr on JRuby":scripts/install-jruby.sh.  This script will install the most recent version of Buildr, or if already installed, upgrade to the most recent version.  If necessary, it will also install JRuby 1.6.1 in @/opt/jruby@ and update the @PATH@ variable in @~/.bash_profile@ or @~/.profile@.
+
+<br>
+
+*In details:* If you don't already have JRuby 1.5.1 or later installed, you can download it from the "JRuby site":http://www.jruby.org/download.
+
+After uncompressing JRuby, update your @PATH@ to include both @java@ and @jruby@ executables.
+
+For Linux and OS X:
+
+{% highlight sh %}
+$ export PATH=$PATH:[path to JRuby]/bin:$JAVA_HOME/bin
+$ jruby -S gem install buildr
+{% endhighlight %}
+
+For Windows:
+
+{% highlight sh %}
+> set PATH=%PATH%;[path to JRuby]/bin;%JAVA_HOME%/bin
+> jruby -S gem install buildr
+{% endhighlight %}
+
+To upgrade to a new version or install a specific version:
+
+{% highlight sh %}
+$ jruby -S gem update buildr
+$ jruby -S gem install buildr -v 1.3.4
+{% endhighlight %}
+
+
+*Important: Running JRuby and Ruby side by side*
+
+Ruby and JRuby maintain separate Gem repositories, and in fact install slightly different versions of the Buildr Gem (same functionality, different dependencies).  Installing Buildr for Ruby does not install it for JRuby and vice versa.
+
+If you have JRuby installed but not Ruby, the @gem@ and @buildr@ commands will use JRuby.  If you have both JRuby and Ruby installed, follow the instructions below.  To find out if you have Ruby installed (some operating systems include it by default), run @ruby --version@ from the command line.
+
+To work exclusively with JRuby, make sure it shows first on the path, for example, by setting @PATH=/opt/jruby/bin:$PATH@.
+
+You can use JRuby and Ruby side by side, by running scripts with the @-S@ command line argument.  For example:
+
+{% highlight sh %}
+$ # with Ruby
+$ ruby -S gem install buildr
+$ ruby -S buildr
+$ # with JRuby
+$ jruby -S gem install buildr
+$ jruby -S buildr
+{% endhighlight %}
+
+Run @buildr --version@ from the command line to find which version of Buildr you are using by default.  If you see @(JRuby ...)@, Buildr is running on that version of JRuby.
+
+h2. Using multiple versions of Buildr
+
+Rubygems makes it possible to install several versions of Buildr side-by-side on the same system.  If you want to run a specific version, you can do so by adding the version number between underscores ('_') as the first command-line parameter.  For example,
+
+{% highlight sh %}
+$ buildr _1.3.4_ clean   # runs Buildr v1.3.4
+
+$ buildr _1.4.4_ clean   # runs Buildr v1.4.4
+{% endhighlight %}
+
+p(note). There are two `buildr` executables installed by Rubygems.  One script serves to select the specified (or default) version of Buildr and is typically found under `/usr/bin/buildr` or `/var/lib/gems/1.8/bin/buildr`. The exact location will vary depending on your system.   The other script is the Buildr bootstrap per se and can be found under the specific version of Buildr, e.g, `/var/lib/gems/1.8/gems/buildr-1.4.0/bin/buildr`.   The first script should be on your `PATH`.   The second script should not be called directly and should not be on your `PATH`.
+
+h2(#running). Running Buildr
+
+You need a *Buildfile*, a build script that tells Buildr all about the projects it's building, what they contain, what to produce, and so on.  The Buildfile resides in the root directory of your project.  We'll talk more about it in "the next chapter":projects.html.  If you don't already have one, ask Buildr to create it by running @buildr@.
+
+p(tip). You'll notice that Buildr creates a file called @buildfile@.  It's case sensitive, but Buildr will look for either @buildfile@ or @Buildfile@.
+
+You use Buildr by running the @buildr@ command:
+
+{% highlight sh %}
+$ buildr [options] [tasks] [name=value]
+{% endhighlight %}
+
+There are several options you can use, for a full list of options type @buildr --help@:
+
+|_. Option                  |_. Usage |
+| @-f/--buildfile [file]@   | Specify the buildfile.                                  |
+| @-e/--environment [name]@ | Environment name (e.g. development, test, production).  |
+| @-h/--help@               | Display this help message.                              |
+| @-n/--nosearch@           | Do not search parent directories for the buildfile.     |
+| @-q/--quiet@              | Do not log messages to standard output.                 |
+| @-r/--require [file]@     | Require MODULE before executing buildfile.              |
+| @-t/--trace@              | Turn on invoke/execute tracing, enable full backtrace.  |
+<<<<<<< HEAD
+=======
+| @-v/--verbose@            | Log message to standard output                          |
+>>>>>>> Fix -V (capital V) to display program version
+| @-V/--version@            | Display the program version.                            |
+| @-P/--prereqs@            | Display tasks and dependencies, then exit.              |
+
+You can tell Buildr to run specific tasks and the order to run them.  For example:
+
+{% highlight sh %}
+# Clean and rebuild
+buildr clean build
+# Package and install
+buildr install
+{% endhighlight %}
+
+If you don't specify a task, Buildr will run the "@build@ task":building.html, compiling source code and running test cases.  Running a task may run other tasks as well, for example, running the @install@ task will also run @package@.
+
+There are several "environment variables":settings_profiles.html#env_vars that let you control how Buildr works, for example, to skip test cases during a build, or specify options for the JVM.  Depending on the variable, you may want to set it once in your environment, or set a different value each time you run Buildr.
+
+For example:
+
+{% highlight sh %}
+$ export JAVA_OPTS='-Xms1g -Xmx1g'
+$ buildr TEST=no
+{% endhighlight %}
+
+
+h2(#help). Help Tasks
+
+Buildr includes a number of informative tasks.  Currently that number stands at two, but we'll be adding more tasks in future releases.  These tasks report information from the Buildfile, so you need one to run them.  For more general help (version number, command line arguments, etc) use @buildr --help@.
+
+To start with, type:
+
+{% highlight sh %}
+$ buildr help
+{% endhighlight %}
+
+You can list the name and description of all your projects using the @help:projects@ task.  For example:
+
+{% highlight sh %}
+$ buildr help:projects
+killer-app                 # Code. Build. ??? Profit!
+killer-app:teh-api         # Abstract classes and interfaces
+killer-app:teh-impl        # All those implementation details
+killer-app:la-web          # What our users see
+{% endhighlight %}
+
+You are, of course, describing your projects for the sake of those who will maintain your code, right?  To describe a project, or a task, call the @desc@ method before the project or task definition.
+
+So next let's talk about "projects":projects.html.
+
+
+h2(#more). Learning More
+
+*Ruby*  It pays to pick up Ruby as a second (or first) programming language. It's fun, powerful and slightly addictive.  If you're interested in learning Ruby the language, a good place to start is "Programming Ruby: The Pragmatic Programmer's Guide":http://www.pragprog.com/titles/ruby/programming-ruby, fondly known as the _Pickaxe book_.
+
+For a quicker read (and much more humor), "Why’s (Poignant) Guide to Ruby":http://poignantguide.net/ruby/ is available online.  More resources are listed on the "ruby-lang web site":http://www.ruby-lang.org/en/documentation/.
+
+*Rake* Buildr is based on Rake, a Ruby build system that handles tasks and dependencies.  Check out the "Rake documentation":http://docs.rubyrake.org/ for more information.
+
+*AntWrap* Buildr uses AntWrap, for configuring and running Ant tasks.  You can learn more from the "Antwrap documentation":http://antwrap.rubyforge.org/.
+
+*YAML* Buildr uses YAML for its profiles.  You can "learn more about YAML here":http://www.yaml.org, and use this handy "YAML quick reference":http://www.yaml.org/refcard.html.