rake-builder 0.0.16 → 0.0.17

data/COPYING

@@ -1,4 +1,4 @@
-Copyright (c) 2010 Joe Yates
+Copyright (c) 2010-2012 Joe Yates
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -18,3 +18,4 @@ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/README.md

@@ -0,0 +1,178 @@
+rake-builder
+============
+
+*Rake for C, C++, Objective-C and Objective-C++ Projects*
+
+* [Source code]
+* [Documentation]
+* [Rubygem]
+
+[Source code]:   http://github.com/joeyates/rake-builder         "Source code at GitHub"
+[Documentation]: http://rdoc.info/projects/joeyates/rake-builder "Documentation at Rubydoc.info"
+[Rubygem]:       http://rubygems.org/gems/rake-builder           "Ruby gem at rubygems.org"
+
+Hello World! Example
+====================
+
+(See the 'examples' directory for source).
+
+Rakefile:
+```ruby
+require 'rubygems' if RUBY_VERSION < '1.9'
+require 'rake'
+require 'rake/builder'
+
+Rake::Builder.new do |builder|
+  builder.target = 'hello_world_cpp'
+end
+```
+
+main.cpp
+```cpp
+#include <iostream>
+
+int main(int argc, char *argv[]) {
+  std::cout << "Hello World!\n";
+
+  return 0;
+}
+```
+
+The Hello World! project should build and run:
+
+```shell
+$ rake run
+Hello World!
+```
+
+Installation
+============
+
+Dependencies
+------------
+
+* makedepend
+ * linux: package 'xutils-dev'
+ * OS X: already installed
+
+Gem
+---
+
+```shell
+$ (sudo) gem install rake-builder
+```
+
+Usage
+=====
+
+Examples
+--------
+See the 'examples' directory.
+
+If you've installed the gem system-wide, type the following to go to
+the correct directory:
+
+```shell
+$ cd `gem environment gemdir`/gems/rake-builder-nnn
+$ cd examples
+```
+
+Project Configuration
+---------------------
+
+In order to build on a specific computer, you will need
+to indicate information like non-standard
+include paths.
+
+Rake::Builder collects all such information in one file:
+'.rake-builder'
+
+This file should be created in the same directory as the Rakefile.
+
+The file should be a YAML structure, and must include a version.
+
+Currently, the following can be configured:
+* extra include paths: :include_paths
+* extra compilation options (e.g. defines): :compilation_options
+
+### Example '.rake-builder'
+
+```yaml
+---
+:rake_builder:
+  :config_file:
+    :version: "1.0"
+:include_paths:
+- /opt/local/include
+- /usr/include/c++/4.2.1
+```
+
+Default Tasks
+-------------
+
+* compile
+* build
+* run - executables only
+* install
+* clean
+
+Installing Headers
+------------------
+
+If you install a static library, your headers will also be installed.
+Ensure that you use file globs, e.g. './include/**/*.h',
+as these will ensure that your headers are installed in the correct subdirectories.
+
+Project
+=======
+
+Status
+------
+
+* Builds C, C++ and Objective-C projects using [GCC](http://gcc.gnu.org/).
+
+Dependency Resolution
+---------------------
+
+Task dependencies must ensure that out of date files are recreated as needed.
+
+![rake-builder Dependency Resolution](http://github.com/downloads/joeyates/rake-builder/RakeBuilderDependencyStructure.png "rake-builder Dependency Resolution")
+
+Limitations
+-----------
+
+### File Modification Times
+
+Rake's FileTask decides whether a file needs rebuilding by comparing on disk file
+modification times (see the private method *out_of_date?*, which returns true if the
+dependency was modified *after* the dependent).
+Unfortunately, most modern file systems hold modification times in whole
+seconds. If a dependency and a dependent were modificed during the same second,
+**even if the dependency were modified later**, *out_of_date?* returns *false*
+which is not the correct answer.
+
+This problem is mostly felt in testing, where file modification times are temporarily
+modified to test dependencies. Also, tests wait for second to complete after building.
+
+#### File Modification Time Resolutions
+
+* [Ext3](http://en.wikipedia.org/wiki/Ext3) - resolution: 1s
+* [Ext4](http://en.wikipedia.org/wiki/Ext4) - resolution: 1 microsecond
+* [Hierarchical_File_System](http://en.wikipedia.org/wiki/Hierarchical_File_System) - resolution: 1s
+* [HFS_Plus](http://en.wikipedia.org/wiki/HFS_Plus) - resolution: 1s
+
+### Source Files with the Same Name
+
+Currently, object files from all source files are placed in the same directory.
+So, if there are two source files with the same name, they will overwrite each other.
+
+Alternatives
+------------
+
+* GNU build system, a.k.a. Autotools: autoconf, configure, make, etc.
+* [Boost.Build](http://www.boost.org/boost-build2/)
+* [CMake](http://www.cmake.org/)
+* [SCons](http://www.scons.org/)
+* [waf](http://code.google.com/p/waf/)
+* [fbuild](https://github.com/felix-lang/fbuild)
+

data/examples/07_multiple_targets/Rakefile

@@ -0,0 +1,16 @@
+require 'rubygems' if RUBY_VERSION < '1.9'
+require 'rake'
+require 'rake/builder'
+
+Rake::Builder.new do |builder|
+  builder.target               = 'foo/target_1'
+  builder.objects_path         = 'foo/objects'
+  builder.programming_language = 'c'
+end
+
+Rake::Builder.new do |builder|
+  builder.target               = 'bar/target_2'
+  builder.objects_path         = 'bar/objects'
+  builder.programming_language = 'c'
+end
+

data/examples/07_multiple_targets/main.c

@@ -0,0 +1,7 @@
+#include <stdio.h>
+
+int main(int argc, char *argv[]) {
+  printf( "Hello World!\n" );
+
+  return 0;
+}

data/lib/rake/builder/version.rb

@@ -6,7 +6,7 @@ module Rake
     module VERSION #:nodoc:
       MAJOR = 0
       MINOR = 0
-      TINY  = 16
+      TINY  = 17
 
       STRING = [ MAJOR, MINOR, TINY ].join('.')
     end

data/lib/rake/builder.rb

@@ -64,17 +64,23 @@ module Rake
       'c' => {
         :source_file_extension => 'c',
         :compiler              => 'gcc',
-        :linker                => 'gcc'
+        :linker                => 'gcc',
+        :ar                    => 'ar',
+        :ranlib                => 'ranlib'
       },
       'c++' => {
         :source_file_extension => 'cpp',
         :compiler              => 'g++',
-        :linker                => 'g++'
+        :linker                => 'g++',
+        :ar                    => 'ar',
+        :ranlib                => 'ranlib'
       },
       'objective-c' => {
         :source_file_extension => 'm',
         :compiler              => 'gcc',
-        :linker                => 'gcc'
+        :linker                => 'gcc',
+        :ar                    => 'ar',
+        :ranlib                => 'ranlib'
       },
     }
 
@@ -84,6 +90,12 @@ module Rake
     # The linker that will be used
     attr_accessor :linker
 
+    # Toolchain setting - ar
+    attr_accessor :ar
+
+    # Toolchain setting - ranlib
+    attr_accessor :ranlib
+
     # Extension of source files (default 'cpp' for C++ and 'c' for C)
     attr_accessor :source_file_extension
 
@@ -173,29 +185,20 @@ module Rake
       task :autoconf, [:project_title, :version] => [] do | task, args |
         project_title = args.project_title or raise "Please supply a project_title parameter"
         version       = decide_version( args.version )
-        if File.exist?( 'configure.ac' )
+        if File.exist?('configure.ac')
           raise "The file 'configure.ac' already exists"
         end
-        if File.exist?( 'Makefile.am' )
+        if File.exist?('Makefile.am')
           raise "The file 'Makefile.am' already exists"
         end
         create_configure_ac project_title, version
         create_makefile_am
       end
-
-      desc "A file containing the major.minor.revision version information"
-      file 'VERSION' do
-        raise <<-EOT
-        In order to create autoconf files, you need to create a file called VERSION in the root directory of the project.
-        The file should contain the version of the project, like this:
-            1.2.3
-        EOT
-      end
     end
 
     def self.create_configure_ac( project_title, version )
       source = Rake::Path.relative_path( instances[ 0 ].source_files[ 0 ], instances[ 0 ].rakefile_path  )
-      File.open( 'configure.ac', 'w' ) do | f |
+      File.open('configure.ac', 'w') do | f |
         f.write <<EOT
 AC_PREREQ(2.61)
 AC_INIT(#{project_title}, #{ version })
@@ -262,8 +265,10 @@ EOT
           f.write "bin_PROGRAMS = #{ names }\n\n"
           binaries.each do | bin |
             f.write <<EOT
-#{ bin[ :label ] }_SOURCES = #{ bin[ :sources ] }
+#{ bin[ :label ] }_SOURCES  = #{ bin[ :sources ] }
 #{ bin[ :label ] }_CPPFLAGS = #{ bin[ :compiler_flags ] }
+#{ bin[ :label ] }_LDFLAGS  = -L.
+#{ bin[ :label ] }_LDADD    = #{ bin[ :libraries ] }
 
 EOT
           end
@@ -282,7 +287,8 @@ EOT
       :name         => primary_name, 
       :label        => sources_label,
       :sources      => sources,
-      :compiler_flags => compiler_flags
+      :compiler_flags => compiler_flags,
+      :libraries      => library_dependencies_list,
       }
     end
 
@@ -292,11 +298,11 @@ EOT
     def self.decide_version( parameter_version )
       acceptable_version_string = %r(^(\d+)\.(\d+)\.(\d+)$)
       if parameter_version && parameter_version !~ acceptable_version_string
-        raise "The supplied version number '#{ parameter_version }' is badly formatted. It should consist of three numbers separated by ."
+        raise "The supplied version number '#{parameter_version}' is badly formatted. It should consist of three numbers separated by ."
       end
       file_version = load_file_version
       if file_version && file_version !~ acceptable_version_string
-        raise "Your VERSION file contains a version number '#{ parameter_version }' which is badly formatted. It should consist of three numbers separated by ."
+        raise "Your VERSION file contains a version number '#{file_version}' which is badly formatted. It should consist of three numbers separated by ."
       end
       case
       when parameter_version.nil? && file_version.nil?
@@ -321,16 +327,13 @@ EOT
     end
 
     def self.load_file_version
-      if File.exist?( 'VERSION' )
-        version = File.read( 'VERSION' )
-        version.strip!
-      else
-        nil
-      end
+      return nil unless File.exist?('VERSION')
+      version = File.read('VERSION')
+      version.strip
     end
 
     def self.save_file_version( version )
-      File.open( 'VERSION', 'w' ) { | f | f.write "#{ version }/n" }
+      File.open('VERSION', 'w') { |f| f.write "#{version}\n" }
     end
  
     self.define_global
@@ -348,7 +351,7 @@ EOT
     # Source files found in source_search_paths
     def source_files
       return @source_files if @source_files
-      @source_files = find_files( @source_search_paths, @source_file_extension ).uniq
+      @source_files = find_files( @source_search_paths, @source_file_extension ).uniq.sort
     end
 
     # Header files found in header_search_paths
@@ -387,6 +390,8 @@ EOT
       raise BuilderError.new( "Don't know how to build '#{ @programming_language }' programs", task_namespace ) if KNOWN_LANGUAGES[ @programming_language ].nil?
       @compiler              ||= KNOWN_LANGUAGES[ @programming_language ][ :compiler ]
       @linker                ||= KNOWN_LANGUAGES[ @programming_language ][ :linker ]
+      @ar                    ||= KNOWN_LANGUAGES[ @programming_language ][ :ar ]
+      @ranlib                ||= KNOWN_LANGUAGES[ @programming_language ][ :ranlib ]
       @source_file_extension ||= KNOWN_LANGUAGES[ @programming_language ][ :source_file_extension ]
 
       @source_search_paths   = Rake::Path.expand_all_with_root( @source_search_paths, @rakefile_path )
@@ -458,9 +463,10 @@ EOT
                         *@target_prerequisites ] do | t |
         shell "rm -f #{ t.name }"
         build_commands.each do | command |
-          shell command
+          stdout, stderr = shell(command)
+          raise BuildFailure.new("Error: command '#{command}' failed: #{stderr} #{stdout}") if not $?.success?
         end
-        raise BuildFailure.new( "The build command failed" ) if ! File.exist?( t.name )
+        raise BuildFailure.new("'#{@target}' not created") if not File.exist?(@target)
       end
 
       desc "Compile all sources"
@@ -485,10 +491,12 @@ EOT
         config.save
       end
 
-      microsecond_file @makedepend_file => [ scoped_task( :load_local_config ),
-                                 scoped_task( :missing_headers ),
-                                 @objects_path,
-                                 *project_files ] do
+      microsecond_file @makedepend_file => [
+          scoped_task( :load_local_config ),
+          scoped_task( :missing_headers ),
+          @objects_path,
+          *project_files
+      ] do
         system('which makedepend >/dev/null')
         raise 'makedepend not found' unless $?.success?
         @logger.add( Logger::DEBUG, "Analysing dependencies" )
@@ -520,13 +528,13 @@ EOT
         File.open( @makedepend_file ).each_line do |line|
           next if line !~ /:\s/
           mapped_object_file = $`
-          header_file = $'.gsub( "\n", '' )
+          header_files = $'.chomp
           # TODO: Why does it work,
           # if I make the object (not the source) depend on the header?
           source_file = object_to_source[ mapped_object_file ]
           object_file = object_path( source_file )
           object_file_task = Rake.application[ object_file ]
-          object_file_task.enhance( [ header_file ] )
+          object_file_task.enhance(header_files.split(' '))
         end
       end
 
@@ -661,8 +669,8 @@ EOT
       when :executable
         [ "#{ @linker } -o #{ @target } #{ file_list( object_files ) } #{ link_flags }" ]
       when :static_library
-        [ "ar -cq #{ @target } #{ file_list( object_files ) }",
-          "ranlib #{ @target }" ]
+        [ "#{ @ar } -cq #{ @target } #{ file_list( object_files ) }",
+          "#{ @ranlib } #{ @target }" ]
       when :shared_library
         [ "#{ @linker } -shared -o #{ @target } #{ file_list( object_files ) } #{ link_flags }" ]
       end
@@ -696,8 +704,10 @@ EOT
     end
 
     def compiler_flags
-      flags = include_path + ' ' + compilation_options.join( ' ' )
-      flags << ' ' << architecture_option if RUBY_PLATFORM =~ /darwin/i
+      flags = include_path
+      options = compilation_options.join( ' ' )
+      flags << ' ' + options             if options != ''
+      flags << ' ' + architecture_option if RUBY_PLATFORM =~ /darwin/i
       flags
     end
 
@@ -841,9 +851,14 @@ EOT
       end
     end
 
-    def shell( command, log_level = Logger::DEBUG )
+    def shell(command, log_level = Logger::DEBUG)
       @logger.add(log_level, command)
-      system command, {:out => '/dev/null', :err => '/dev/null'}
+      originals        = $stdout, $stderr
+      stdout, stderr   = StringIO.new, StringIO.new
+      $stdout, $stderr = stdout, stderr
+      system command, {:out => :out, :err => :err}
+      $stdout, $stderr = *originals
+      [stdout.read, stderr.read]
     end
 
   end

data/lib/rake/microsecond.rb

@@ -35,21 +35,25 @@ module Rake
       include FileUtils
 
       attr_accessor :timestamp
+      attr_accessor :path
 
       def self.define_task( *args, &block )
-        task = super( *args, &block )
+        task           = super(*args, &block)
+        task.path      = args[0]
         task.timestamp = nil
         task
       end
 
       def needed?
-        exists = File.directory?( self.name )
-        @timestamp = File.stat( self.name ).mtime if exists
+        exists = File.directory?(self.path)
+        if exists && @timestamp.nil?
+          @timestamp = File.stat(self.path).mtime
+        end
         ! exists
       end
 
       def execute(*args)
-        mkdir_p self.name, :verbose => false
+        mkdir_p self.path, :verbose => false
         @timestamp = Time.now
         super(*args)
       end

data/spec/autoconf_spec.rb

@@ -0,0 +1,191 @@
+load File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe 'autoconf' do
+
+  include RakeBuilderHelper
+
+  before :each do
+    Rake::Task.clear
+    Rake::Builder.define_global
+
+    @project = cpp_task(:executable)
+
+    @args = Rake::TaskArguments.new(
+      [:project_title, :version],
+      ['my_title',     '1.0.0'],
+    )
+    File.stub!(:exist?).and_return(false)
+    @files = {
+      'VERSION'      => stub('File', :write => nil),
+      'configure.ac' => stub('File', :write => nil),
+      'Makefile.am'  => stub('File', :write => nil),
+    }
+    # Capture text saved to files
+    @output = {}
+    File.stub!(:open) do |(filename, perms), &block|
+      file = @files[filename]
+      file.stub!(:write) do |s|
+        @output[filename] = s
+      end
+      block.call file
+    end
+  end
+
+  context 'invocation' do
+
+    it "has an 'autoconf' task" do
+      task_names.include?('autoconf').
+                                    should     be_true
+    end
+
+    it 'requires a project_title parameter' do
+      @args = Rake::TaskArguments.new([], [])
+
+      expect do
+        Rake::Task['autoconf'].execute(@args)
+      end.                          to         raise_error(RuntimeError, /supply a project_title/)
+    end
+
+    context 'version parameter' do
+
+      it 'should be nn.nn.nn' do
+        @args = Rake::TaskArguments.new(
+          [:project_title, :version],
+          ['my_title',     'foo'],
+        )
+
+        expect do
+          Rake::Task['autoconf'].execute(@args)
+        end.                          to         raise_error(RuntimeError, /The supplied version number 'foo' is badly formatted/)
+      end
+
+      context 'when missing' do
+
+        before :each do
+          @args = Rake::TaskArguments.new(
+            [:project_title],
+            ['my_title',   ],
+          )
+          File.stub(:read).with('VERSION').and_return('2.3.444')
+        end
+
+        it 'checks for a VERSION file' do
+          File.should_receive(:exist?).with('VERSION').and_return(true)
+
+          Rake::Task['autoconf'].execute(@args)
+        end
+
+        it 'fails without a VERSION file' do
+          expect do
+            Rake::Task['autoconf'].execute(@args)
+          end.                          to         raise_error(RuntimeError, /This task requires a project version/)
+        end
+
+        context 'with a VERSION file' do
+
+          before :each do
+            File.stub(:exist?).with('VERSION').and_return(true)
+          end
+
+          it 'reads the file' do
+            File.should_receive(:read).with('VERSION').and_return('2.3.444')
+
+            Rake::Task['autoconf'].execute(@args)
+          end
+
+          it 'uses the version' do
+            Rake::Task['autoconf'].execute(@args)
+
+            @output['configure.ac'].      should     =~ /AC_INIT\(.*?, 2\.3\.444\)/
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+
+  it "fails if 'configure.ac' exists" do
+    File.should_receive(:exist?).with('configure.ac').and_return(true)
+
+    expect do
+      Rake::Task['autoconf'].execute(@args)
+    end.                          to         raise_error(RuntimeError, /'configure.ac' already exists/)
+  end
+
+  it "fails if 'Makefile.am' exists" do
+    File.should_receive(:exist?).with('Makefile.am').and_return(true)
+
+    expect do
+      Rake::Task['autoconf'].execute(@args)
+    end.                          to         raise_error(RuntimeError, /'Makefile.am' already exists/)
+  end
+
+  context 'configure.ac' do
+
+    it 'is created' do
+      File.                       should_receive(:open).
+                                  with('configure.ac', 'w')
+
+      Rake::Task['autoconf'].execute(@args)
+    end
+
+    it 'has the title' do
+      Rake::Task['autoconf'].execute(@args)
+
+      @output['configure.ac'].      should     =~ /AC_INIT\(my_title, /
+    end
+
+    it 'has the version' do
+      Rake::Task['autoconf'].execute(@args)
+
+      @output['configure.ac'].      should     =~ /AC_INIT\(.*?, 1\.0\.0\)/
+    end
+
+    it 'checks for a source file' do
+      Rake::Task['autoconf'].execute(@args)
+
+      @output['configure.ac'].      should     =~ /AC_CONFIG_SRCDIR\(\[cpp_project\/main\.cpp\]\)/
+    end
+
+    it 'references the Makefile' do
+      Rake::Task['autoconf'].execute(@args)
+
+      @output['configure.ac'].      should     =~ /AC_CONFIG_FILES\(\[Makefile\]\)/
+    end
+
+  end
+
+  context 'Makefile.am' do
+
+    it 'is created' do
+      File.                       should_receive(:open).
+                                  with('Makefile.am', 'w')
+
+      Rake::Task['autoconf'].execute(@args)
+    end
+
+    it 'has sources' do
+      Rake::Task['autoconf'].execute(@args)
+
+      @output['Makefile.am'].     should     =~ /the_executable_SOURCES\s*=\s+cpp_project\/main\.cpp/
+    end
+
+    it 'has flags' do
+      Rake::Task['autoconf'].execute(@args)
+
+      @output['Makefile.am'].     should     =~ /the_executable_CPPFLAGS\s*=/
+    end
+
+    it 'has libraries' do
+      Rake::Task['autoconf'].execute(@args)
+
+      @output['Makefile.am'].     should     =~ /the_executable_LDADD\s*=/
+    end
+
+  end
+
+end
+

data/spec/cpp_project_spec.rb

@@ -1,5 +1,30 @@
 load File.dirname(__FILE__) + '/spec_helper.rb'
 
+describe '#source_files' do
+
+  include RakeBuilderHelper
+
+  before( :each ) do
+    Rake::Path.stub!(:find_files).with(anything, 'h').and_return(['a.h'])
+    Rake::Path.stub!(:find_files).with(anything, 'cpp').and_return(['a.cpp'])
+
+    Rake::Task.clear
+  end
+
+  it 'should find files with the .cpp extension' do
+    Rake::Path.should_receive(:find_files).with(anything, 'cpp').and_return(['a.cpp'])
+
+    cpp_task(:executable)
+  end
+
+  it 'should allow configuration of source extension' do
+    Rake::Path.should_receive(:find_files).with(anything, 'cc').and_return(['a.cc'])
+
+    cpp_task(:executable) { |p| p.source_file_extension = 'cc' }
+  end
+
+end
+
 describe 'when building an executable' do
 
   include RakeBuilderHelper
@@ -48,7 +73,7 @@ describe 'when building an executable' do
   end
 
   it 'has a \'run\' task' do
-    Rake::Task[ 'run' ].should_not be_nil
+    task_names.include?('run').   should     be_true
   end
 
   it 'builds the program with \'run\'' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rake-builder
 version: !ruby/object:Gem::Version
-  version: 0.0.16
+  version: 0.0.17
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-15 00:00:00.000000000 Z
+date: 2013-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -60,23 +60,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 2.3.0
 - !ruby/object:Gem::Dependency
-  name: pry
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: pry-doc
+  name: pry-plus
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -101,53 +85,56 @@ files:
 - CHANGES
 - COPYING
 - Rakefile
-- README.rdoc
+- README.md
 - lib/compiler.rb
-- lib/rake/path.rb
 - lib/rake/once_task.rb
+- lib/rake/microsecond.rb
+- lib/rake/file_task_alias.rb
 - lib/rake/builder/qt_builder.rb
 - lib/rake/builder/version.rb
 - lib/rake/local_config.rb
-- lib/rake/file_task_alias.rb
+- lib/rake/path.rb
 - lib/rake/builder.rb
-- lib/rake/microsecond.rb
-- examples/04_zlib/include/main.h
-- examples/05_tests/include/units.h
 - examples/05_tests/include/main.h
+- examples/05_tests/include/units.h
 - examples/03_search_paths/include/main.h
-- examples/02_hello_world_c/main.c
+- examples/04_zlib/include/main.h
+- examples/07_multiple_targets/main.c
 - examples/04_zlib/src/main.c
-- examples/05_tests/src/main.cpp
-- examples/05_tests/src/units.cpp
+- examples/02_hello_world_c/main.c
+- examples/01_hello_world_cpp/main.cpp
 - examples/05_tests/test/test_unit.cpp
+- examples/05_tests/src/units.cpp
+- examples/05_tests/src/main.cpp
 - examples/03_search_paths/src/main.cpp
-- examples/01_hello_world_cpp/main.cpp
 - examples/06_hello_world_objective_c/main.m
 - examples/README.rdoc
-- examples/02_hello_world_c/Rakefile
-- examples/04_zlib/Rakefile
-- examples/05_tests/Rakefile
-- examples/03_search_paths/Rakefile
 - examples/01_hello_world_cpp/Rakefile
+- examples/05_tests/Rakefile
 - examples/06_hello_world_objective_c/Rakefile
-- spec/logger_spec.rb
-- spec/objective_c_project/main.m
+- examples/07_multiple_targets/Rakefile
+- examples/03_search_paths/Rakefile
+- examples/04_zlib/Rakefile
+- examples/02_hello_world_c/Rakefile
+- spec/spec_helper.rb
+- spec/cpp_project/main.h
+- spec/cpp_project/main.cpp
+- spec/generated_files_spec.rb
+- spec/c_project/main.c
+- spec/c_project/main.h
+- spec/c_project_spec.rb
 - spec/objective_c_project/main.h
-- spec/paths_spec.rb
-- spec/local_config_spec.rb
+- spec/objective_c_project/main.m
+- spec/target_spec.rb
+- spec/microsecond_task_spec.rb
 - spec/cpp_project_spec.rb
+- spec/logger_spec.rb
 - spec/dependencies_spec.rb
 - spec/objective_c_project_spec.rb
-- spec/c_project_spec.rb
-- spec/generated_files_spec.rb
-- spec/target_spec.rb
+- spec/paths_spec.rb
+- spec/local_config_spec.rb
 - spec/libraries_spec.rb
-- spec/microsecond_task_spec.rb
-- spec/cpp_project/main.h
-- spec/cpp_project/main.cpp
-- spec/spec_helper.rb
-- spec/c_project/main.c
-- spec/c_project/main.h
+- spec/autoconf_spec.rb
 homepage: http://github.com/joeyates/rake-builder
 licenses: []
 post_install_message: 
@@ -162,7 +149,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3351991107247363695
+      hash: 4353605042528954080
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -171,7 +158,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3351991107247363695
+      hash: 4353605042528954080
 requirements: []
 rubyforge_project: nowarning
 rubygems_version: 1.8.23
@@ -179,22 +166,23 @@ signing_key:
 specification_version: 3
 summary: Rake for C/C++ Projects
 test_files:
-- spec/logger_spec.rb
-- spec/objective_c_project/main.m
+- spec/spec_helper.rb
+- spec/cpp_project/main.h
+- spec/cpp_project/main.cpp
+- spec/generated_files_spec.rb
+- spec/c_project/main.c
+- spec/c_project/main.h
+- spec/c_project_spec.rb
 - spec/objective_c_project/main.h
-- spec/paths_spec.rb
-- spec/local_config_spec.rb
+- spec/objective_c_project/main.m
+- spec/target_spec.rb
+- spec/microsecond_task_spec.rb
 - spec/cpp_project_spec.rb
+- spec/logger_spec.rb
 - spec/dependencies_spec.rb
 - spec/objective_c_project_spec.rb
-- spec/c_project_spec.rb
-- spec/generated_files_spec.rb
-- spec/target_spec.rb
+- spec/paths_spec.rb
+- spec/local_config_spec.rb
 - spec/libraries_spec.rb
-- spec/microsecond_task_spec.rb
-- spec/cpp_project/main.h
-- spec/cpp_project/main.cpp
-- spec/spec_helper.rb
-- spec/c_project/main.c
-- spec/c_project/main.h
+- spec/autoconf_spec.rb
 has_rdoc: 

data/README.rdoc

@@ -1,143 +0,0 @@
-= rake-builder - Rake for C, C++, Objective-C and Objective-C++ Projects
-
-rake-builder builds C, C++, Objective-C and Objective-C++
-projects.
-
-Here is a typical example:
-
- require 'rubygems' if RUBY_VERSION < '1.9'
- require 'rake'
- require 'rake/builder'
- 
- Rake::Builder.new do |builder|
-   builder.target               = 'my_program'
-   builder.source_search_paths  = [ 'src' ]
-   builder.header_search_paths  = [ 'include' ]
- end
-
-= Dependencies
-
-* makedepend
-** linux: package 'xutils-dev'
-** OS X: already installed
-
-= Installation
-
- $ sudo gem install rake-builder
-
-= Hello World! Example
-
-See the 'examples' directory.
-
-The Hello World! project should build and run:
-
- $ cd examples/01_hello_world_cpp
- $ rake run
- Hello World!
-
-= Usage
-
-See the 'examples' directory.
-
-If you've installed the gem system-wide, type the following to go to
-the correct directory:
-
- $ cd `gem environment gemdir`/gems/rake-builder-nnn
- $ cd examples
-
-== Project Configuration
-
-In order to build on a specific computer, you will need
-to indicate information like non-standard
-include paths.
-
-Rake::Builder collects all such information in one file:
-'.rake-builder'
-
-For namespaced tasks, e.g. 'test:build', the file is '.rake-builer.test'
-
-This file should be created in the same
-directory as the Rakefile.
-
-The file should be a YAML structure, and must include a version.
-
-Currently, the following can be configured:
-* extra include paths: :include_paths
-* extra compilation options (e.g. defines): :compilation_options
-
-=== Example '.rake-builder'
-
- ---
- :rake_builder:
-   :config_file:
-     :version: "1.0"
- :include_paths:
- - /opt/local/include
- - /usr/include/c++/4.2.1
-
-= Default Tasks
-
-* compile
-* build
-* run - executables only
-* install
-* clean
-
-= Installing Headers
-
-If you install a static library, your headers will also be installed.
-Ensure that you use file globs, e.g. './include/**/*.h',
-as these will ensure that your headers are installed in the correct subdirectories.
-
-= Online
-
-* {Source code}[http://github.com/joeyates/rake-builder]
-* Documentation[http://rdoc.info/projects/joeyates/rake-builder]
-* Gem[http://rubygems.org/gems/rake-builder]
-
-= Dependencies
-
-Task dependencies must ensure that out of date files are recreated as needed.
-
-http://github.com/downloads/joeyates/rake-builder/RakeBuilderDependencyStructure.png
-
-= Limitations
-
-== File Modification Times
-
-Rake's FileTask decides whether a file needs rebuilding by comparing on disk file
-modification times (see the private method <em>out_of_date?</em>, which returns true if the
-dependency was modified *after* the dependent).
-Unfortunately, most modern file systems hold modification times in whole
-seconds. If a dependency and a dependent were modificed during the same second,
-<b>even if the dependency were modified later</b>, <em>out_of_date?</em> returns *false*
-which is not the correct answer.
-
-This problem is mostly felt in testing, where file modification times are temporarily
-modified to test dependencies. Also, tests wait for second to complete after building.
-
-=== File Modification Time Resolutions
-
-* Ext3[http://en.wikipedia.org/wiki/Ext3] - resolution: 1s
-* Ext4[http://en.wikipedia.org/wiki/Ext4] - resolution: 1 microsecond
-* Hierarchical_File_System[http://en.wikipedia.org/wiki/Hierarchical_File_System] - resolution: 1s
-* HFS_Plus[http://en.wikipedia.org/wiki/HFS_Plus] - resolution: 1s
-
-== Source Files with the Same Name
-
-Currently, object files from all source files are placed in the same directory.
-So, if there are two source files with the same name, they will overwrite each other.
-
-= Status
-
-* Builds C, C++ and Objective-C projects using GCC[http://gcc.gnu.org/].
-
-= Alternatives
-
-* GNU build system, a.k.a. Autotools: autoconf, configure, make, etc.
-* Boost.Build
-* CMake
-* rakepp - another customisation of Rake for C++ projects
-* Scons
-* waf[http://code.google.com/p/waf/]
-* http://felix-lang.org/blog/2010/aug/30/fbuild-0-2/