Author: boisvert
Date: Mon Nov 23 17:55:25 2009
New Revision: 883434

URL: http://svn.apache.org/viewvc?rev=883434&view=rev
Log:
Update documentation for change related to buildr.rb location

Modified:
    buildr/trunk/doc/artifacts.textile
    buildr/trunk/doc/more_stuff.textile
    buildr/trunk/doc/settings_profiles.textile

Modified: buildr/trunk/doc/artifacts.textile
URL: 
http://svn.apache.org/viewvc/buildr/trunk/doc/artifacts.textile?rev=883434&r1=883433&r2=883434&view=diff
==============================================================================
--- buildr/trunk/doc/artifacts.textile (original)
+++ buildr/trunk/doc/artifacts.textile Mon Nov 23 17:55:25 2009
@@ -125,7 +125,7 @@
 repositories.local = '/usr/local/maven/repository'
 {% endhighlight %}
 
-That's one change you don't want to commit into the Buildfile, so the best 
place to do it is in your home directory's @buildr.rb@ file.
+That's one change you don't want to commit into the Buildfile, so the best 
place to do it is in the @buildr.rb@ file in the @.buildr@ directory under your 
home directory.
 
 Buildr downloads artifacts when it needs to use them, for example, to compile 
a project.  You don't need to download artifacts directly.  Except when you do, 
for example, if you want to download all the latest artifacts and then go 
off-line.  It's as simple as:
 

Modified: buildr/trunk/doc/more_stuff.textile
URL: 
http://svn.apache.org/viewvc/buildr/trunk/doc/more_stuff.textile?rev=883434&r1=883433&r2=883434&view=diff
==============================================================================
--- buildr/trunk/doc/more_stuff.textile (original)
+++ buildr/trunk/doc/more_stuff.textile Mon Nov 23 17:55:25 2009
@@ -280,7 +280,7 @@
 end
 {% endhighlight %}
 
-You can place this code inside @buildr.rb@ in your home directory.
+You can place this code inside @buildr.rb@ in the @.buildr@ directory under 
your home directory.
 
 h2(#eclipse). Eclipse
 
@@ -390,7 +390,7 @@
 require 'buildr/jdepend'
 {% endhighlight %}
 
-You may want to add those to the Buildfile.  Alternatively, you can use these 
tasks for all your projects without modifying the Buildfile.  One convenient 
method is to add these lines to the @buildr.rb@ file in your home directory.
+You may want to add those to the Buildfile.  Alternatively, you can use these 
tasks for all your projects without modifying the Buildfile.  One convenient 
method is to add these lines to the @buildr.rb@ file in the @.buildr@ directory 
under your home directory.
 
 Another option is to require it from the command line (@--require@ or @-r@), 
for example:
 

Modified: buildr/trunk/doc/settings_profiles.textile
URL: 
http://svn.apache.org/viewvc/buildr/trunk/doc/settings_profiles.textile?rev=883434&r1=883433&r2=883434&view=diff
==============================================================================
--- buildr/trunk/doc/settings_profiles.textile (original)
+++ buildr/trunk/doc/settings_profiles.textile Mon Nov 23 17:55:25 2009
@@ -166,9 +166,9 @@
 
 h2(#variable). Non constant settings
 
-Before loading the Buildfile, Buildr will attempt to load two other files: the 
@buildr.rb@ file it finds in your home directory, followed by the @buildr.rb@ 
file it finds in the build directory.
+Before loading the Buildfile, Buildr will attempt to load two other files: the 
@buildr.rb@ file in the @.buildr@ directory under your home directory, followed 
by the @buildr.rb@ file it finds in the build directory.
 
-The loading order allows you to place global settings that affect all your 
builds in your home directory's @buildr.rb@, but also over-ride those with 
settings for a given project.
+The loading order allows you to place global settings that affect all your 
builds in your @buildr.rb@, but also over-ride those with settings for a given 
project.
 
 Here's an example @buildr.rb@:
 
@@ -180,6 +180,12 @@
 repositories.remote << 'http://inside-the-firewall'
 {% endhighlight %}
 
+p(note). Buildr 1.3 and earlier used the file @buildr.rb@ directly in your 
home directory.  Starting with version 1.4, Buildr loads @buildr.rb@ from the 
@.buildr@ directory under your home directory in preference.  If you use Buildr 
1.3 and earlier and don't want to duplicate your settings, you can move you 
existing @buildr.rb@ under the @.buildr@ directory and create a new @buildr.rb@ 
in your home directory containing:
+
+{% highlight ruby %}
+# Backward compatibility:  Buildr 1.4+ uses $HOME/.buildr/buildr.rb
+load File.expand_path('buildr.rb', Buildr.application.home_dir)
+{% endhighlight %}
 
 h2(#environments). Environments
 


Reply via email to