Ah, didn't know that. Would you be able to write up a documentation how-to thingy? One of the things I noticed just in trying to document the interactive shell support is that I really don't know how to work the system even for little things like highlighting-free preformatted blocks. A few words of wisdom in this area would be greatly appreciated, at least by me. :-)
Daniel On Mon, Jun 22, 2009 at 7:11 PM, Assaf Arkin <ar...@intalio.com> wrote: > FYI: the version of RedCloth that we're using defaults to the original > Textile behavior which is to replace newlines with <br>, so formatting a > paragraph with line breaks ends looks good in a text editor, but badly > justified in HTML/PDF. That option can be toggled, but I learned the hard > way not to argue with RedCloth. > > Assaf > > On Sat, Jun 20, 2009 at 7:30 AM, <djspie...@apache.org> wrote: > > > Author: djspiewak > > Date: Sat Jun 20 14:30:19 2009 > > New Revision: 786830 > > > > URL: http://svn.apache.org/viewvc?rev=786830&view=rev > > Log: > > Added documentation for Scala auto-download > > > > Modified: > > buildr/trunk/doc/languages.textile > > buildr/trunk/lib/buildr/scala/compiler.rb > > > > Modified: buildr/trunk/doc/languages.textile > > URL: > > > http://svn.apache.org/viewvc/buildr/trunk/doc/languages.textile?rev=786830&r1=786829&r2=786830&view=diff > > > > > ============================================================================== > > --- buildr/trunk/doc/languages.textile (original) > > +++ buildr/trunk/doc/languages.textile Sat Jun 20 14:30:19 2009 > > @@ -128,26 +128,47 @@ > > > > h2(#scala). Scala > > > > -Before using Scala features, you must first set the > @scala_h...@environment variable to point to the root of your Scala > distribution. > > +Before using Scala, you must first @require@ the Scala compiler: > > > > -On Windows: > > - > > -{% highlight sh %} > > -> set SCALA_HOME=C:\Path\To\Scala-2.7.3 > > +{% highlight ruby %} > > +require 'buildr/scala' > > {% endhighlight %} > > > > -On Linux and other Unix variants, > > +By default, Buildr will attempt to use any version of Scala which is > > already > > +installed on your system. However, Buildr isn't *quite* smart enough to > > intuit > > +such things on its own, so for most cases, it requires the @SCALA_HOME@ > > +environment variable to be set pointing to the root of the Scala > > installation > > +(e.g. @/usr/local/scala-2.7.5.final@). The only exception to this is > if > > you have > > +installed Scala via "MacPorts":http://www.macports.org/ Buildr will > look > > in the > > +@/opt/local/share/scala/@ directory *before* it uses the > @scala_h...@envar. > > + > > +However, if @SCALA_HOME@ is not set, or if it points to an invalid > Scala > > +installation, then Buildr has a fallback option. The Scala compiler and > > standard > > +library are both available from the "Scala Tools repository": > > http://scala-tools.org/. > > +If no other Scala installation can be found, Buildr will download the > > appropriate > > +artifacts and use them instead of a full install. The only drawback to > > this > > +approach is the FSC compiler is *not* available when Scala has been > > downloaded > > +in this fashion. > > + > > +When Scala is downloaded from the Maven2 repository, Buildr will attempt > > to use > > +the very latest version (starting from version 2.7.5). If you wish to > > override > > +this default, you will need to make use of the @artifact_ns@ construct > > *before* > > +you @require@ Scala support in your buildfile: > > > > -{% highlight sh %} > > -> export SCALA_HOME=/path/to/scala-2.7.3 > > +{% highlight ruby %} > > +artifact_ns['Buildr::Compiler::Scalac'].library = '2.7.5' > > + > > +require 'buildr/scala' > > {% endhighlight %} > > > > -The @SCALA_HOME@ base directory should be such that Scala core > libraries > > are located directly under the "lib" subdirectory, and Scala scripts are > > under the "bin" directory. This step is not necessary if you installed > Scala > > using MacPorts (OS X). > > +This snippet tells Buildr to use exactly version 2.7.5 of Scala when it > > downloads > > +the JARs from Scala-Tools, regardless of what the latest version may be. > > > > -You must also require the Scala compiler in your buildfile: > > +Regardless of how Scala has been obtained, you may determine the version > > in use > > +by querying the @Scala.version@ attribute: > > > > {% highlight ruby %} > > -require 'buildr/scala' > > +Scala.version # => '2.7.5' > > {% endhighlight %} > > > > h3. Compiling Scala > > > > Modified: buildr/trunk/lib/buildr/scala/compiler.rb > > URL: > > > http://svn.apache.org/viewvc/buildr/trunk/lib/buildr/scala/compiler.rb?rev=786830&r1=786829&r2=786830&view=diff > > > > > ============================================================================== > > --- buildr/trunk/lib/buildr/scala/compiler.rb (original) > > +++ buildr/trunk/lib/buildr/scala/compiler.rb Sat Jun 20 14:30:19 2009 > > @@ -42,7 +42,7 @@ > > fail "Unable to parse Scala version: #{version_str} " > > match[0].sub(/.$/, "") # remove trailing dot, if any > > else > > - DEFAULT_VERSION > > + DEFAULT_VERSION # TODO return the version installed from > > Maven repo > > end > > end > > end > > > > > > >
