Author: assaf
Date: Wed Feb 20 17:25:16 2008
New Revision: 629666
URL: http://svn.apache.org/viewvc?rev=629666&view=rev
Log:
Moved download instructions to Getting Started, fixed many PDF styling issues
Modified:
incubator/buildr/trunk/NOTICE
incubator/buildr/trunk/Rakefile
incubator/buildr/trunk/doc/css/default.css
incubator/buildr/trunk/doc/css/print.css
incubator/buildr/trunk/doc/images/note.png
incubator/buildr/trunk/doc/images/tip.png
incubator/buildr/trunk/doc/pages/artifacts.textile
incubator/buildr/trunk/doc/pages/download.textile
incubator/buildr/trunk/doc/pages/getting_started.textile
incubator/buildr/trunk/doc/pages/index.textile
incubator/buildr/trunk/doc/pages/projects.textile
incubator/buildr/trunk/doc/pages/testing.textile
incubator/buildr/trunk/doc/pages/troubleshooting.textile
incubator/buildr/trunk/doc/print.haml
incubator/buildr/trunk/doc/print.toc.yaml
incubator/buildr/trunk/doc/web.haml
Modified: incubator/buildr/trunk/NOTICE
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/NOTICE?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/NOTICE (original)
+++ incubator/buildr/trunk/NOTICE Wed Feb 20 17:25:16 2008
@@ -63,3 +63,11 @@
Licensed under the Ruby License
Copyright 2004 Mauricio Julio Fernández Pradier and Austin Ziegler
+* DejaVu - http://dejavu.sourceforge.net
+Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved.
+Bitstream Vera is a trademark of Bitstream, Inc.
+
+* ColorCons - http://www.mouserunner.com/
+Licensed under Creative Commons Attribution-ShareAlike 2.5
+Copyright (c) 2006 Ken Saunders
+
Modified: incubator/buildr/trunk/Rakefile
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/Rakefile?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/Rakefile (original)
+++ incubator/buildr/trunk/Rakefile Wed Feb 20 17:25:16 2008
@@ -145,7 +145,7 @@
include('doc/css', 'doc/images', 'doc/scripts', 'html/report.html',
'html/coverage', 'html/rdoc')
}
print_docs = {
- :collection => Docter.collection('Buildr — The build system that
doesn\'t suck').using('doc/print.toc.yaml').
+ :collection => Docter.collection('Buildr').using('doc/print.toc.yaml').
include('doc/pages', 'LICENSE'),
:template => Docter.template('doc/print.haml').include('doc/css',
'doc/images')
}
@@ -226,6 +226,10 @@
end
namespace :release do
+
+ # TODO: Check that we're using allison.
+ # TODO: Check that we can generate PDFs.
+
task :ready? do
require 'highline'
require 'highline/import'
Modified: incubator/buildr/trunk/doc/css/default.css
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/css/default.css?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/css/default.css (original)
+++ incubator/buildr/trunk/doc/css/default.css Wed Feb 20 17:25:16 2008
@@ -83,6 +83,7 @@
th {
border-bottom: none;
background-color: #E5E5E5;
+ text-align: left;
}
Modified: incubator/buildr/trunk/doc/css/print.css
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/css/print.css?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/css/print.css (original)
+++ incubator/buildr/trunk/doc/css/print.css Wed Feb 20 17:25:16 2008
@@ -1,21 +1,21 @@
[EMAIL PROTECTED] { margin: 1in 0.5in 2in 0.5in; }
[EMAIL PROTECTED] { margin: 1in 0.75in 1in 0.75in; }
@page:left {
- @bottom-left { content: counter(page); }
- @bottom-right { content: string(pagetitle); }
- @top-right { content: string(doctitle); }
+ @top-left { content: counter(page); }
+ @top-right { content: string(pagetitle); }
}
@page:right {
- @bottom-right { content: counter(page); }
- @bottom-left { content: string(pagetitle); }
- @top-left { content: string(doctitle); }
+ @top-left { content: string(pagetitle); }
+ @top-right { content: counter(page); }
}
@page:first {
- @bottom-left { content: normal }
- @bottom-right { content: normal }
@top-left { content: normal }
@top-right { content: normal }
}
+title {
+ string-set: doctitle content();
+}
+
body {
font-size: 12pt;
margin: 0;
@@ -30,8 +30,10 @@
h1:first-child { page-break-before: avoid; }
pre, p, blockquote { page-break-inside: avoid; }
pre {
- font-size: 85% !important;
line-height: 1.3em;
+ white-space: pre-wrap; /* css-3 */
+ padding: 0.3em 0 0.9em 0.6em;
+ margin: 0;
}
a:link, a:visited {
background: transparent;
@@ -44,7 +46,7 @@
color: black;
background: transparent;
width: auto !important;
- margin: 0 5%;
+ margin: 0;
padding: 0;
border: 0;
}
@@ -68,7 +70,8 @@
#footer { margin-top: 5%; }
-#license+pre {
+#license {
+ padding-top: 1in;
page-break-before: none !important;
page-break-inside: always !important;
}
Modified: incubator/buildr/trunk/doc/images/note.png
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/images/note.png?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
Binary files - no diff available.
Modified: incubator/buildr/trunk/doc/images/tip.png
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/images/tip.png?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
Binary files - no diff available.
Modified: incubator/buildr/trunk/doc/pages/artifacts.textile
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/artifacts.textile?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/artifacts.textile (original)
+++ incubator/buildr/trunk/doc/pages/artifacts.textile Wed Feb 20 17:25:16 2008
@@ -308,5 +308,10 @@
upload bean
}}}
+p(tip). Calling the @install@ (and likewise @upload@) method on an artifact
+does not install the artifact, it simply adds a task that will execute when you
+run @buildr [EMAIL PROTECTED] If you need to download and install an
artifact, invoke
+the task directly with @install(<artifact>)[EMAIL PROTECTED]
+
Next we're going to "package some artifacts":packaging.html.
Modified: incubator/buildr/trunk/doc/pages/download.textile
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/download.textile?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/download.textile (original)
+++ incubator/buildr/trunk/doc/pages/download.textile Wed Feb 20 17:25:16 2008
@@ -1,227 +1,13 @@
-h1. Download and Installation
+h1. Download
-The installation instructions are slightly different for each operating system.
-If you are using Ruby, pick the one that best matches your operating system.
-If you are using JRuby, see the instructions for "JRuby":#jruby and also read
-about using "JRuby and Ruby side by side":#using_jruby_and_ruby.
+h2. Installing Buildr
-p(note). At the moment it seems that Buildr will not work with Java 6, and can
-only be used with Java 1.5 or earlier. If you prefer to use Java 6, consider
-installing and using "Buildr for JRuby":jruby.
-
-
-h2. Linux
-
-To get started you will need a recent version of Ruby, Ruby Gems and build
-tools for compiling native libraries (Make and GCC).
-
-On RedHat/Fedora you can use yum to install Ruby and RubyGems, and then upgrade
-to the most recent version of RubyGems:
-
-{{{!sh
-$ sudo yum install ruby rubygems ruby-devel gcc
-$ sudo gem update --system
-}}}
-
-On Ubuntu you have to install several packages:
-
-{{{!sh
-$ sudo apt-get install ruby-full ruby1.8-dev libopenssl-ruby build-essential
-}}}
-
-The Debian package for @rubygems@ will not allow you to install Buildr, so you
-need to install RubyGems from source:
-
-{{{!sh
-$ curl -OL http://rubyforge.org/frs/download.php/29548/rubygems-1.0.1.tgz
-$ tar xzf rubygems-1.0.1.tgz
-$ cd rubygems-1.0.1
-$ sudo ruby setup.rb
-$ sudo ln -s /usr/bin/gem1.8 /usr/bin/gem
-}}}
-
-Before installing Buildr, please set the @JAVA_HOME@ environment variable to
-point to your JDK distribution. Next, use Ruby Gem to install Buildr:
-
-{{{!sh
-$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr
-}}}
-
-To upgrade to a new version of Buildr:
-
-{{{!sh
-$ sudo env JAVA_HOME=$JAVA_HOME gem update buildr
-}}}
-
-To install a specific version of Buildr:
-
-{{{!sh
-$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr -v 1.3.0
-}}}
-
-You can also use this script "to install Buildr on
-Linux":scripts/install-linux.sh. The script will either install or upgrade
-Buildr to the latest version. It will also upgrade RubyGems to version 1.0.1
-or later, and if necessary install Ruby 1.8.6 using yum (RPM) or apt-get (deb).
-
-
-h2. OS/X
-
-OS/X 10.5 (Leopard) comes with the latest version of Ruby 1.8. If you are
-using an older version of OS/X, you will first need to upgrade to a recent
-version of Ruby. You can install Ruby using MacPorts or Fink, or use the
-"One-Click Installer":http://rubyosx.rubyforge.org/.
-
-We recommend you first upgrade to the latest version of Ruby gems:
-
-{{{!sh
-$ sudo gem update --system
-}}}
-
-Before installing Buildr, please set the @JAVA_HOME@ environment variable to
-point to your JDK distribution:
-
-{{{!sh
-$ export JAVA_HOME=/Library/Java/Home
-}}}
-
-To install Buildr:
-
-{{{!sh
-$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr
-}}}
-
-To upgrade to a new version of Buildr:
-
-{{{!sh
-$ sudo env JAVA_HOME=$JAVA_HOME gem update buildr
-}}}
-
-To install a specific version of Buildr:
-
-{{{!sh
-$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr -v 1.3.0
-}}}
-
-You can also use this script "to install Buildr on
-OS/X":scripts/install-osx.sh. The script will either install or upgrade Buildr
-to the latest version. It will also upgrade RubyGems to version 1.0.1 or
-later, and if necessary install Ruby 1.8.6 using MacPorts or Fink.
-
-
-h2. Windows
-
-If you don't already have Ruby installed, now is the time to do it. The
-easiest way to install Ruby is using the "one-click
-installer":http://rubyinstaller.rubyforge.org/.
-
-We recommend you first upgrade to the latest version of Ruby gems:
-
-{{{!sh
-> gem update --system
-}}}
-
-Before installing Buildr, please set the @JAVA_HOME@ environment variable to
-point to your JDK distribution. Next, use Ruby Gem to install Buildr:
-
-{{{!sh
-> gem install buildr
-}}}
-
-Buildr uses several libraries that include native extensions. During
-installation it will ask you to pick a platform for these libraries. By
-selecting @mswin32@ it will download and install pre-compiled DLLs for these
-extensions.
-
-To upgrade to a new version of Buildr:
-
-{{{!sh
-> gem update buildr
-}}}
-
-To install a specific version of Buildr:
-
-{{{!sh
-> gem install buildr -v 1.3.0
-}}}
-
-
-h2. JRuby
-
-If you don't already have JRuby 1.1RC2 or later installed, you can download it
-from the "JRuby site":http://dist.codehaus.org/jruby/.
-
-After uncompressing JRuby, update your @PATH@ to include both JRuby and Java
-executables, so you can run JRuby with the command @[EMAIL PROTECTED]
-
-For Windows:
-
-{{{!sh
-> set JRUBY_HOME=<path to JRuby>
-> set PATH=%JRUBY_HOME%/bin;%JAVA_HOME%/bin;%PATH%
-> gem install buildr
-}}}
-
-And for Unix:
-
-{{{!sh
-$ export JRUBY_HOME=<path to JRuby>
-$ export PATH=$JRUBY_HOME/bin:$JAVA_HOME/bin:$PATH
-$ gem install buildr
-}}}
-
-Once installed, you will find the @buildr@ exectuable in the @JRUBY_HOME/bin@
-directory.
-
-To upgrade to a new version of Buildr:
-
-{{{!sh
-$ sudo gem update buildr
-}}}
-
-To install a specific version of Buildr:
-
-{{{!sh
-$ sudo gem install buildr -v 1.3.0
-}}}
-
-You can also use this script "to install Buildr for
-JRuby":scripts/install-jruby.sh. The script will either install or upgrade
-Buildr to the latest version. If you do not already have JRuby installed, it
-will install JRuby 1.1RC2 in @/opt/jruby@ and update the PATH in
[EMAIL PROTECTED]/.bash_profile@ or @~/[EMAIL PROTECTED]
-
-
-h2. Using JRuby and Ruby
-
-Ruby and JRuby maintain separate Gem repositories, and in fact install slightly
-different versions of the Buildr Gem (same functionality, different
-dependencies). If you want to use Buildr with both, you must install it
-separately for each one.
-
-If you installed JRuby on your machine and do not have Ruby installed, the
[EMAIL PROTECTED]@ and @buildr@ commands will default to using JRuby. However,
you may
-already have Ruby installed (some operating systems come with Ruby
-pre-installed), in which case these commands will default to whichever is first
-on the path.
-
-To work exclusively with JRuby, make sure it shows first on the path, for
example,
-by setting @PATH=/opt/jruby/bin:[EMAIL PROTECTED] Alternatively, you can run
scripts with a particular version
-of Ruby using the @-S@ command line argument. For example:
-
-{{{!
-$ # with Ruby
-$ ruby -S gem install buildr
-$ ruby -S buildr
-$ # with JRuby
-$ jruby -S gem install buildr
-$ jruby -S buildr
-}}}
-
-To find out which version of Buildr you are using by default, run @buildr
[EMAIL PROTECTED] Buildr reports the version number and adds @(JRuby)@ next to
it when
-running on JRuby.
+The easiest way to install Buildr is using the fabulous RubyGems package
manager. Of course,
+you will need either Ruby or JRuby, and we recommend a recent version of
RubyGems and
+if this sounds foreign to you, don't worry. We'll show you how to install
Buildr on Linux,
+OS/X, Windows and JRuby in the "Getting Started guide":getting_started.html,
we even provide
+automated installation scripts.
h2. Binaries and Source Code
Modified: incubator/buildr/trunk/doc/pages/getting_started.textile
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/getting_started.textile?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/getting_started.textile (original)
+++ incubator/buildr/trunk/doc/pages/getting_started.textile Wed Feb 20
17:25:16 2008
@@ -2,7 +2,202 @@
h2. Installing Buildr
-More information about "downloading and installing Buildr":download.html.
+The installation instructions are slightly different for each operating system.
+If you are using Ruby, pick the one that best matches your operating system and
+target platform.
+
+p(note). The current release of Buildr for Ruby does not work with Java 6 and
+can only be used with Java 1.5 or earlier. "Buildr for JRuby":#jruby works
+nicely with Java 6, consider using that instead.
+
+
+h3. Linux
+
+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:
+
+{{{!sh
+$ sudo yum install ruby rubygems ruby-devel gcc
+$ sudo gem update --system
+}}}
+
+On *Ubuntu* you have to install several packages:
+
+{{{!sh
+$ sudo apt-get install ruby-full ruby1.8-dev libopenssl-ruby build-essential
+}}}
+
+The Debian package for @rubygems@ will not allow you to install Buildr, so you
+need to install RubyGems from source:
+
+{{{!sh
+$ curl -OL http://rubyforge.org/frs/download.php/29548/rubygems-1.0.1.tgz
+$ tar xzf rubygems-1.0.1.tgz
+$ cd rubygems-1.0.1
+$ sudo ruby setup.rb
+$ sudo ln -s /usr/bin/gem1.8 /usr/bin/gem
+}}}
+
+Before installing Buildr, please set the @JAVA_HOME@ environment variable to
+point to your JDK distribution. Next, use Ruby Gem to install Buildr:
+
+{{{!sh
+$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr
+}}}
+
+To upgrade to a new version or install a specific version:
+
+{{{!sh
+$ sudo env JAVA_HOME=$JAVA_HOME gem update buildr
+$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr -v 1.3.0
+}}}
+
+You can also use this script "to install Buildr on
+Linux":scripts/install-linux.sh. This script will install Buildr or if already
+installed, upgrade to a more recent version. It will also install Ruby 1.8.6
+if not already installed (using @yum@ or @apt-get@) and upgrage RubyGems to
+1.0.1.
+
+
+h3. OS/X
+
+OS/X 10.5 (Leopard) comes with a recent version of Ruby 1.8.6. OS/X 10.4
+(Tiger) includes an older version of Ruby, we recommend you first 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:
+
+{{{!sh
+$ sudo gem update --system
+}}}
+
+Before installing Buildr, please set the @JAVA_HOME@ environment variable to
+point to your JDK distribution:
+
+{{{!sh
+$ export JAVA_HOME=/Library/Java/Home
+}}}
+
+To install Buildr:
+
+{{{!sh
+$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr
+}}}
+
+To upgrade to a new version or install a specific version:
+
+{{{!sh
+$ sudo env JAVA_HOME=$JAVA_HOME gem update buildr
+$ sudo env JAVA_HOME=$JAVA_HOME gem install buildr -v 1.3.0
+}}}
+
+You can also use this script "to install Buildr on
+OS/X":scripts/install-osx.sh. This script will install Buildr or if already
+installed, upgrade to a more recent version. It will also install Ruby 1.8.6
+if not already installed (using MacPorts) and upgrage RubyGems to 1.0.1.
+
+
+h3. Windows
+
+If you don't already have Ruby installed, now is the time to do it. The
+easiest way to install Ruby is using the "one-click
+installer":http://rubyinstaller.rubyforge.org/.
+
+We recommend you first upgrade to the latest version of Ruby gems:
+
+{{{!sh
+> gem update --system
+}}}
+
+Before installing Buildr, please set the @JAVA_HOME@ environment variable to
+point to your JDK distribution. Next, use Ruby Gem to install Buildr:
+
+{{{!sh
+> gem install buildr
+}}}
+
+Buildr uses several libraries that include native extensions. During
+installation it will ask you to pick a platform for these libraries. By
+selecting @mswin32@ it will download and install pre-compiled DLLs for these
+extensions.
+
+To upgrade to a new version or install a specific version:
+
+{{{!sh
+> gem update buildr
+> gem install buildr -v 1.3.0
+}}}
+
+
+h3. JRuby
+
+If you don't already have JRuby 1.1RC2 or later installed, you can download it
+from the "JRuby site":http://dist.codehaus.org/jruby/.
+
+After uncompressing JRuby, update your @PATH@ to include both @java@ and
@jruby@
+executables.
+
+For Linux and OS/X:
+
+{{{!sh
+$ export PATH=$PATH:[path to JRuby]/bin:$JAVA_HOME/bin
+$ gem install buildr
+}}}
+
+For Windows:
+
+{{{!sh
+> set PATH=%PATH%;[path to JRuby]/bin;%JAVA_HOME%/bin
+> gem install buildr
+}}}
+
+To upgrade to a new version or install a specific version:
+
+{{{!sh
+$ sudo gem update buildr
+$ sudo gem install buildr -v 1.3.0
+}}}
+
+You can also use this script "to install Buildr on
+JRuby":scripts/install-jruby.sh. This script will install Buildr or if already
+installed, upgrade to a more recent version. If necessary, it will also
+install JRuby 1.1RC2 in @/opt/jruby@ and update the @PATH@ variable in
[EMAIL PROTECTED]/.bash_profile@ or @~/[EMAIL PROTECTED]
+
+*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:[EMAIL PROTECTED]
+
+You can use JRuby and Ruby side by side, by running scripts with the @-S@
+command line argument. For example:
+
+{{{!
+$ # with Ruby
+$ ruby -S gem install buildr
+$ ruby -S buildr
+$ # with JRuby
+$ jruby -S gem install buildr
+$ jruby -S buildr
+}}}
+
+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. Conventions
@@ -96,8 +291,10 @@
h2. 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.
+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 [EMAIL
PROTECTED]
To start with, type:
Modified: incubator/buildr/trunk/doc/pages/index.textile
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/index.textile?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/index.textile (original)
+++ incubator/buildr/trunk/doc/pages/index.textile Wed Feb 20 17:25:16 2008
@@ -27,7 +27,10 @@
* Simple way to upgrade to new versions.
* Did we mention fast?
-h4. Buildr 1.3
+
+h2. News
+
+Check out "all that's new in Buildr 1.3":whats_new.html.
* Building Scala projects
* Building Groovy projects
@@ -38,19 +41,21 @@
* More documentation
* Other features and bug fixes.
-Check out "what's new in Buildr 1.3":whats_new.html.
-p(tip). The Apache Software Foundation is a non-profit organization, consider
+h2. Notices
+
+The Apache Software Foundation is a non-profit organization, consider
"sponsoring":http://www.apache.org/foundation/sponsorship.html and check the
"thanks":http://www.apache.org/foundation/thanks.html page.
-p(note). Apache Buildr is an effort undergoing incubation at The Apache
-Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is
-required of all newly accepted projects until a further review indicates that
-the infrastructure, communications, and decision making process have stabilized
-in a manner consistent with other successful ASF projects. While incubation
-status is not necessarily a reflection of the completeness or stability of the
-code, it does indicate that the project has yet to be fully endorsed by the
-ASF.
+Apache Buildr is an effort undergoing incubation at The Apache Software
+Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of
+all newly accepted projects until a further review indicates that the
+infrastructure, communications, and decision making process have stabilized in
+a manner consistent with other successful ASF projects. While incubation status
+is not necessarily a reflection of the completeness or stability of the code,
+it does indicate that the project has yet to be fully endorsed by the ASF.
-"So let's get started":getting_started.html.
+"ColorCons":http://www.mouserunner.com/Spheres_ColoCons1_Free_Icons.html,
+copyright of Ken Saunders. "DejaVu fonts":http://dejavu.sourceforge.net,
+copyright of Bitstream, Inc.
Modified: incubator/buildr/trunk/doc/pages/projects.textile
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/projects.textile?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/projects.textile (original)
+++ incubator/buildr/trunk/doc/pages/projects.textile Wed Feb 20 17:25:16 2008
@@ -14,7 +14,7 @@
first, let's pick up a sample project to work with. We'll call it
_killer-app_:
-{{{!ruby,lines
+{{{!ruby
require 'buildr'
VERSION_NUMBER = '1.0'
Modified: incubator/buildr/trunk/doc/pages/testing.textile
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/testing.textile?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/testing.textile (original)
+++ incubator/buildr/trunk/doc/pages/testing.textile Wed Feb 20 17:25:16 2008
@@ -43,16 +43,16 @@
@[EMAIL PROTECTED]
There are benefits to running test cases in separate VMs. The default forking
-mode is @:once@, and you can change it by setting the @:fork@ option. It
-accepts the following values:
+mode is @:once@, and you can change it by setting the @:fork@ option.
-*@:[EMAIL PROTECTED] â Create one VM to run all test classes in the project,
separate VMs
-for each project.
-*@:[EMAIL PROTECTED] â Create one VM for each test case class. Slow but
provides the best
-isolation between test classes.
[EMAIL PROTECTED]@* â Without forking, Buildr runs all test cases in a
single VM. This
+|_. :fork=> |_. Behavior |
+| @:once@ | Create one VM to run all test classes in the project, separate
+VMs for each project. |
+| @:each@ | Create one VM for each test case class. Slow but provides the
+best isolation between test classes. |
+| @false@ | Without forking, Buildr runs all test cases in a single VM. This
option runs fastest, but at the risk of running out of memory and causing test
-cases to interfere with each other.
+cases to interfere with each other. |
You can see your tests running in the console, and if any tests fail, Buildr
will show a list of the failed test classes. In addition, JUnit produces text
@@ -345,12 +345,13 @@
Buildr provides the following matchers:
-*exist* â Given a file task checks that the file (or directory) exists.
-*empty* â Given a file task checks that the file (or directory) is empty.
-*contain* â Given a file task referencing a file, checks its contents, using
+|_. Method |_. Checks that ... |
+| @exist@ | Given a file task checks that the file (or directory) exists. |
+| @empty@ | Given a file task checks that the file (or directory) is empty. |
+| @contain@ | Given a file task referencing a file, checks its contents, using
string or regular expression. For a file task referencing a directory, checks
that it contains the specified files; global patterns using @*@ and @**@ are
-allowed.
+allowed. |
All these matchers operate against a file task. If you run them against a
ZipTask (including JAR, WAR, etc) they can also check the contents of the ZIP
Modified: incubator/buildr/trunk/doc/pages/troubleshooting.textile
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/troubleshooting.textile?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/troubleshooting.textile (original)
+++ incubator/buildr/trunk/doc/pages/troubleshooting.textile Wed Feb 20
17:25:16 2008
@@ -57,6 +57,10 @@
ls -l /usr/bin/javac
}}}
+*Note:* It seems that RJB works with Java 6, except when it doesn't, and for a
+few people it doesn't. In that case, either switch to Java 1.5, or simply run
+Buildr on JRuby using Java 6.
+
h2. Bugs resulting from a dangling comma or period
Modified: incubator/buildr/trunk/doc/print.haml
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/print.haml?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/print.haml (original)
+++ incubator/buildr/trunk/doc/print.haml Wed Feb 20 17:25:16 2008
@@ -8,14 +8,29 @@
@import 'css/eiffel.css';
@import 'css/print.css' print;
%meta{ :name=>'subject', :content=>'Official Buildr documentation from the
people in the know' }
+ %meta{ :name=>'author', :content=>'http://incubator.apache.org/buildr' }
%body
#wrap
#header
%img{ :src=>'images/apache-incubator-logo.png', :alt=>'Apache
Incubator', :style=>'float:right;width:10em' }
%img{ :src=>'images/buildr-hires.png', :alt=>collection.title,
:style=>'width:20em' }
- .tagline= 'The build system that doesn\'t suck'
+ .tagline= ''
#content
= collection.toc.to_html(:nested, :class=>'toc')
+ #license
+ %p Copyright 2007-2008 Apache Buildr
+ %p
+ Licensed under the Apache License, Version 2.0 (the "License"); you
+ may not use this file except in compliance with the License. You
+ may obtain a copy of the License at
+ %p{ :style=>'margin-left: 2em' }
+ %a{ :href=>'http://www.apache.org/licenses/LICENSE-2.0' }
http://www.apache.org/licenses/LICENSE-2.0
+ %p
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied. See the License for the specific language governing
+ permissions and limitations under the License.
- pages.each do |page|
%h1{ :id=>page.id }= page.title
= page.toc.to_html(:nested, :class=>'toc')
Modified: incubator/buildr/trunk/doc/print.toc.yaml
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/print.toc.yaml?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/print.toc.yaml (original)
+++ incubator/buildr/trunk/doc/print.toc.yaml Wed Feb 20 17:25:16 2008
@@ -11,4 +11,3 @@
- Recipes: recipes.html
- Troubleshooting: troubleshooting.html
- Contributing: contributing.html
-- License: license.html
Modified: incubator/buildr/trunk/doc/web.haml
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/web.haml?rev=629666&r1=629665&r2=629666&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/web.haml (original)
+++ incubator/buildr/trunk/doc/web.haml Wed Feb 20 17:25:16 2008
@@ -16,7 +16,7 @@
%img{ :src=>'images/apache-incubator-logo.png', :alt=>'Apache
Incubator' }
%a{ :href=>'http://incubator.apache.org/buildr/' }
%img{ :src=>'images/buildr.png', :alt=>collection.title }
- .tagline= 'The build system that doesn\'t suck'
+ .tagline= ''
#pages
= collection.toc.to_html(:nested=>1, :class=>'toc')
%form{ :id=>'searchbox_003673095760649043902:ogcgrzu0l2y',
:action=>'http://www.google.com/cse' }
