You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@buildr.apache.org by as...@apache.org on 2008/01/26 01:31:25 UTC
svn commit: r615412 - in /incubator/buildr/trunk: ./ doc/ doc/css/ doc/pages/
Author: assaf
Date: Fri Jan 25 16:31:23 2008
New Revision: 615412
URL: http://svn.apache.org/viewvc?rev=615412&view=rev
Log:
Added contributors and cleaned up references
Modified:
incubator/buildr/trunk/Rakefile
incubator/buildr/trunk/doc/css/default.css
incubator/buildr/trunk/doc/pages/contributing.textile
incubator/buildr/trunk/doc/pages/getting_started.textile
incubator/buildr/trunk/doc/pages/recipes.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/web.haml
Modified: incubator/buildr/trunk/Rakefile
URL: http://svn.apache.org/viewvc/incubator/buildr/trunk/Rakefile?rev=615412&r1=615411&r2=615412&view=diff
==============================================================================
--- incubator/buildr/trunk/Rakefile (original)
+++ incubator/buildr/trunk/Rakefile Fri Jan 25 16:31:23 2008
@@ -144,7 +144,7 @@
print = Docter::Rake.generate('print', print_docs[:collection], print_docs[:template], :one_page)
pdf_file = file('html/buildr.pdf'=>print) do |task|
mkpath 'html'
- sh *%W{prince #{print}/index.html -o #{task.name}} do |ok, res|
+ sh *%W{prince #{print}/index.html --baseurl=http://incubator.apache.org/buildr/ -o #{task.name}} do |ok, res|
fail 'Failed to create PDF, see errors above' unless ok
end
end
Modified: incubator/buildr/trunk/doc/css/default.css
URL: http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/css/default.css?rev=615412&r1=615411&r2=615412&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/css/default.css (original)
+++ incubator/buildr/trunk/doc/css/default.css Fri Jan 25 16:31:23 2008
@@ -72,19 +72,19 @@
}
table {
- border: none;
- margin: auto;
+ border-spacing: 0.2em 0;
}
th, td {
- padding: 1em;
- border: 1px solid #C0C0C0;
+ padding: 0.3em 0.5em 0.3em 0.5em;
+ border-bottom: 1px solid #D8D8D8;
vertical-align: top;
background-color: #FFFFFF;
}
th {
- background-color: #F5F5F5;
+ border-bottom: none;
+ background-color: #E5E5E5;
}
Modified: incubator/buildr/trunk/doc/pages/contributing.textile
URL: http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/contributing.textile?rev=615412&r1=615411&r2=615412&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/contributing.textile (original)
+++ incubator/buildr/trunk/doc/pages/contributing.textile Fri Jan 25 16:31:23 2008
@@ -18,11 +18,11 @@
"archive":http://mail-archives.apache.org/mod_mbox/incubator-buildr-user/) for
developers working with Buildr, and the
"buildr-dev":mailto:buildr-dev@incubator.apache.org mailing list
-("subscribe":buildr-dev-subscribe@incubator.apache.org,
+("subscribe":mailto:buildr-dev-subscribe@incubator.apache.org,
"archive":http://mail-archives.apache.org/mod_mbox/incubator-buildr-dev/) for
developement of Buildr itself. We also have a
-"commits":buildr-commits@incubator.apache.org mailing list
-("subscribe":buildr-commits-subscribe@incubator.apache.org) if you want to
+"commits":mailto:buildr-commits@incubator.apache.org mailing list
+("subscribe":mailto:buildr-commits-subscribe@incubator.apache.org) if you want to
stalk us.
@@ -94,7 +94,6 @@
framework. The main difference between RSpec and xUnit is that RSpec helps you
formulate test cases in terms of specifications: you describe how the code
should behave, and run RSpec to make sure it matches that specification.
-"Here's an example":http://rspec.info/examples.html.
You can run an individual specifications using the @spec@ command, for example:
@@ -147,10 +146,19 @@
If you're thinking of editing the docs, and using @rake html@ to see what the
HTML looks like, you may want to try something simpler. Start by running the
Docter Web server with @rake docter@ and then point your browser at
-"http://localhost:3000":http://localhost:3000. To see your edits, simply
-refresh the page.
+@http://localhost:3000@. To see your edits, simply refresh the page.
Generating the PDF is a bit more tricky, we use the HTML in combination with
print media CSS stylesheets and run them through the wonderful
"PrinceXML":http://www.princexml.com/, so you'll need to install PrinceXML
first before you can @rake pdf@.
+
+
+h2. Contributors
+
+Here is the list of people who are actively working and committing on Buildr:
+
+|_.Name |_.ID |_.Organization |_. Role |
+| Assaf Arkin | assaf | "Intalio":http://intalio.com | Developer & PMC |
+| Alex Boisvert | boisvert | "Intalio":http://intalio.com | Developer & PMC |
+| Matthieu Riou | mriou | "Intalio":http://intalio.com | Developer & PMC Chair |
Modified: incubator/buildr/trunk/doc/pages/getting_started.textile
URL: http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/getting_started.textile?rev=615412&r1=615411&r2=615412&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/getting_started.textile (original)
+++ incubator/buildr/trunk/doc/pages/getting_started.textile Fri Jan 25 16:31:23 2008
@@ -2,8 +2,7 @@
h2. Installing Buildr
-More information about "downloading and installing
-Buildr":http://incubator.apache.org/buildr/downloading.html.
+More information about "downloading and installing Buildr":downloading.html.
h2. Conventions
Modified: incubator/buildr/trunk/doc/pages/recipes.textile
URL: http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/recipes.textile?rev=615412&r1=615411&r2=615412&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/recipes.textile (original)
+++ incubator/buildr/trunk/doc/pages/recipes.textile Fri Jan 25 16:31:23 2008
@@ -3,8 +3,6 @@
Commond recipes for Buildr, collected from the mailing list.
-h2. Java
-
h4. Creating a classpath
For Java, the classpath argument is simply a list of paths joined with an
@@ -45,8 +43,6 @@
}}}
-h2. Configuration
-
h4. Keeping your Profiles.yaml file DRY
YAML allows you to write an object (map, array, etc) once and reference it in
@@ -76,9 +72,7 @@
}}}
-h2. Continuous Integration
-
-h4. Atlassian Bamboo
+h4. Continuous Integration with Atlassian Bamboo
This recipe outlines how to configure a new Bamboo project to use Buildr. The
following steps assume that you have logged-on to Bamboo as an Administrator.
Modified: incubator/buildr/trunk/doc/pages/testing.textile
URL: http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/testing.textile?rev=615412&r1=615411&r2=615412&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/testing.textile (original)
+++ incubator/buildr/trunk/doc/pages/testing.textile Fri Jan 25 16:31:23 2008
@@ -364,9 +364,8 @@
classifier) your checks must call @package@ with the same qualifying arguments
to return the very same package task.
-Buildr expectations are based on RSpec. Check the "RSpec
-documentation":http://rspec.rubyforge.org/ if want to see all the supported
-matchers, or want to write your own.
+Buildr expectations are based on RSpec. Check the RSpec documentation if want
+to see all the supported matchers, or want to write your own.
We're almost done, but there's "a few more things":more_stuff.html you'll want
to learn.
@@ -379,5 +378,5 @@
values like "dev", "stage", "deploy" to change how your build works in
different settings.
-fn2. "RSpec":http://rspec.rubyforge.org/ is the behavior-driven development
+fn2. "RSpec":http://rspec.info/ is the behavior-driven development
framework we use to test Buildr itself.
Modified: incubator/buildr/trunk/doc/pages/troubleshooting.textile
URL: http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/troubleshooting.textile?rev=615412&r1=615411&r2=615412&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/troubleshooting.textile (original)
+++ incubator/buildr/trunk/doc/pages/troubleshooting.textile Fri Jan 25 16:31:23 2008
@@ -2,9 +2,8 @@
Common troubleshooting tips collected from the mailing list.
-h2. Building
-h3. Running out of heap space
+h4. Running out of heap space
You can give the JVM more heap space by setting the @JAVA_OPTS@ environment
variables. This environment variable provides arguments for staring the JVM.
@@ -26,32 +25,7 @@
}}}
-h2. Buildfiles
-
-h3. Bugs resulting from a dangling comma or period
-
-Ruby statements don't need a delimiter and can span multiple lines, which can
-lead to bugs resulting from dangling commas and periods left at the end of the
-line. For example:
-
-{{{!ruby
-compile.with 'org.apache.axis2:axis2:jar:1.2',
-test.with 'log4j:log4j:jar:1.1'
-}}}
-
-This is actually a single method call with two arguments, separated by a comma.
-The second argument is the result of calling @test.with@, and makes the test
-task a pre-requisite of the compile task, leading to a circular dependency.
-
-As you can imagine this happens usually after editing, specifically for commas
-and periods which are small enough that you won't notice them from a cursory
-glance at the code, so if all else fails, search for lines that end with one of
-these characters.
-
-
-h2. RJB
-
-h3. RJB fails to compile
+h4. RJB fails to compile
On Linux, BSD and Cygwin, RJB locates the JDK headers files -- which it uses to
compile a native C extension -- based on the @JAVA_HOME@ environment variable.
@@ -66,7 +40,7 @@
}}}
-h3. Segmentation Fault when running Java code
+h4. Segmentation Fault when running Java code
This is most likely a JVM inconsistency, for example, when part of the RJB
library uses JDK 1.6, the other part uses JDK 1.5.
@@ -82,3 +56,26 @@
echo $JAVA_HOME
ls -l /usr/bin/javac
}}}
+
+
+h4. Bugs resulting from a dangling comma or period
+
+Ruby statements don't need a delimiter and can span multiple lines, which can
+lead to bugs resulting from dangling commas and periods left at the end of the
+line. For example:
+
+{{{!ruby
+compile.with 'org.apache.axis2:axis2:jar:1.2',
+test.with 'log4j:log4j:jar:1.1'
+}}}
+
+This is actually a single method call with two arguments, separated by a comma.
+The second argument is the result of calling @test.with@, and makes the test
+task a pre-requisite of the compile task, leading to a circular dependency.
+
+As you can imagine this happens usually after editing, specifically for commas
+and periods which are small enough that you won't notice them from a cursory
+glance at the code, so if all else fails, search for lines that end with one of
+these characters.
+
+
Modified: incubator/buildr/trunk/doc/print.haml
URL: http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/print.haml?rev=615412&r1=615411&r2=615412&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/print.haml (original)
+++ incubator/buildr/trunk/doc/print.haml Fri Jan 25 16:31:23 2008
@@ -1,4 +1,4 @@
-!!!
+!!! 1.1
%html
%head
%meta{ 'http-equiv'=>'Content-Type', :content=>'text/html;charset=UTF-8' }/
Modified: incubator/buildr/trunk/doc/web.haml
URL: http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/web.haml?rev=615412&r1=615411&r2=615412&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/web.haml (original)
+++ incubator/buildr/trunk/doc/web.haml Fri Jan 25 16:31:23 2008
@@ -1,4 +1,4 @@
-!!!
+!!! 1.1
%html
%head
%meta{ 'http-equiv'=>'Content-Type', :content=>'text/html;charset=UTF-8' }/