rake 11.3.0 → 13.0.1

data/README.rdoc

@@ -2,8 +2,7 @@
 
 home :: https://github.com/ruby/rake
 bugs :: https://github.com/ruby/rake/issues
-docs :: http://docs.seattlerb.org/rake/
-build status :: {<img src="https://travis-ci.org/ruby/rake.svg?branch=master" alt="travis-ci">}[https://travis-ci.org/ruby/rake] {<img src="https://ci.appveyor.com/api/projects/status/github/ruby/rake?branch=master&svg=true" alt="appveyor">}[https://ci.appveyor.com/project/ruby/rake]
+docs :: https://ruby.github.io/rake
 
 == Description
 
@@ -24,9 +23,9 @@ Rake has the following features:
   file names and paths.
 
 * A library of prepackaged tasks to make building rakefiles easier. For example,
-  tasks for building tarballs and publishing to FTP or SSH sites.  (Formerly
-  tasks for building RDoc and Gems were included in rake but they're now
-  available in RDoc and RubyGems respectively.)
+  tasks for building tarballs. (Formerly
+  tasks for building RDoc, Gems, and publishing to FTP were included in rake but they're now
+  available in RDoc, RubyGems, and rake-contrib respectively.)
 
 * Supports parallel execution of tasks.
 
@@ -75,10 +74,10 @@ Type "rake --help" for all available options.
 
 === Rake Information
 
-* {Rake command-line}[rdoc-ref:doc/command_line_usage.rdoc]
-* {Writing Rakefiles}[rdoc-ref:doc/rakefile.rdoc]
-* The original {Rake announcement}[rdoc-ref:doc/rational.rdoc]
-* Rake {glossary}[rdoc-ref:doc/glossary.rdoc]
+* {Rake command-line}[link:doc/command_line_usage.rdoc]
+* {Writing Rakefiles}[link:doc/rakefile.rdoc]
+* The original {Rake announcement}[link:doc/rational.rdoc]
+* Rake {glossary}[link:doc/glossary.rdoc]
 
 === Presentations and Articles about Rake
 
@@ -101,7 +100,6 @@ other projects with similar (and not so similar) goals.
 * http://directory.fsf.org/wiki/Bras -- Bras, one of earliest
   implementations of "make in a scripting language".
 * http://www.a-a-p.org -- Make in Python
-* http://www.aromatic.com/tools/jam.txt -- JAM, Java Automated Make
 * http://ant.apache.org -- The Ant project
 * http://search.cpan.org/search?query=PerlBuildSystem -- The Perl Build System
 * http://www.rubydoc.info/gems/rant/0.5.7/frames -- Rant, another Ruby make tool.
@@ -131,7 +129,7 @@ Rake is available under an MIT-style license.
 = Other stuff
 
 Author::   Jim Weirich <jim.weirich@gmail.com>
-Requires:: Ruby 1.9.3 or later
+Requires:: Ruby 2.0.0 or later
 License::  Copyright Jim Weirich.
            Released under an MIT-style license.  See the MIT-LICENSE
            file included in the distribution.

data/Rakefile

@@ -6,28 +6,36 @@
 # This file may be distributed under an MIT style license.  See
 # MIT-LICENSE for details.
 
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
+begin
+  require "bundler/gem_tasks"
+rescue LoadError
+end
 
-# XXX: https://github.com/bundler/bundler/pull/4981
-require 'bundler/plugin/api/source'
-
-require 'bundler/gem_tasks'
-require 'rake/testtask'
-require 'rdoc/task'
-
+require "rake/testtask"
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
   t.verbose = true
-  t.test_files = FileList['test/**/test_*.rb']
+  t.test_files = FileList["test/**/test_*.rb"]
 end
 
+require "rdoc/task"
 RDoc::Task.new do |doc|
-  doc.main   = 'README.rdoc'
-  doc.title  = 'Rake -- Ruby Make'
+  doc.main   = "README.rdoc"
+  doc.title  = "Rake -- Ruby Make"
   doc.rdoc_files = FileList.new %w[lib MIT-LICENSE doc/**/*.rdoc *.rdoc]
-  doc.rdoc_dir = 'html'
+  doc.rdoc_dir = "html"
+end
+
+task ghpages: :rdoc do
+  %x[git checkout gh-pages]
+  require "fileutils"
+  FileUtils.rm_rf "/tmp/html"
+  FileUtils.mv "html", "/tmp"
+  FileUtils.rm_rf "*"
+  FileUtils.cp_r Dir.glob("/tmp/html/*"), "."
 end
 
-task :default => :test
+task default: :test

data/bin/bundle

@@ -0,0 +1,105 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'bundle' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "rubygems"
+
+m = Module.new do
+    module_function
+
+  def invoked_as_script?
+    File.expand_path($0) == File.expand_path(__FILE__)
+  end
+
+  def env_var_version
+    ENV["BUNDLER_VERSION"]
+  end
+
+  def cli_arg_version
+    return unless invoked_as_script? # don't want to hijack other binstubs
+    return unless "update".start_with?(ARGV.first || " ") # must be running `bundle update`
+    bundler_version = nil
+    update_index = nil
+    ARGV.each_with_index do |a, i|
+      if update_index && update_index.succ == i && a =~ Gem::Version::ANCHORED_VERSION_PATTERN
+        bundler_version = a
+      end
+      next unless a =~ /\A--bundler(?:[= ](#{Gem::Version::VERSION_PATTERN}))?\z/
+      bundler_version = $1 || ">= 0.a"
+      update_index = i
+    end
+    bundler_version
+  end
+
+  def gemfile
+    gemfile = ENV["BUNDLE_GEMFILE"]
+    return gemfile if gemfile && !gemfile.empty?
+
+    File.expand_path("../../Gemfile", __FILE__)
+  end
+
+  def lockfile
+    lockfile =
+      case File.basename(gemfile)
+      when "gems.rb" then gemfile.sub(/\.rb$/, gemfile)
+      else "#{gemfile}.lock"
+      end
+    File.expand_path(lockfile)
+  end
+
+  def lockfile_version
+    return unless File.file?(lockfile)
+    lockfile_contents = File.read(lockfile)
+    return unless lockfile_contents =~ /\n\nBUNDLED WITH\n\s{2,}(#{Gem::Version::VERSION_PATTERN})\n/
+    Regexp.last_match(1)
+  end
+
+  def bundler_version
+    @bundler_version ||= begin
+      env_var_version || cli_arg_version ||
+        lockfile_version || "#{Gem::Requirement.default}.a"
+    end
+  end
+
+  def load_bundler!
+    ENV["BUNDLE_GEMFILE"] ||= gemfile
+
+    # must dup string for RG < 1.8 compatibility
+    activate_bundler(bundler_version.dup)
+  end
+
+  def activate_bundler(bundler_version)
+    if Gem::Version.correct?(bundler_version) && Gem::Version.new(bundler_version).release < Gem::Version.new("2.0")
+      bundler_version = "< 2"
+    end
+    gem_error = activation_error_handling do
+      gem "bundler", bundler_version
+    end
+    return if gem_error.nil?
+    require_error = activation_error_handling do
+      require "bundler/version"
+    end
+    return if require_error.nil? && Gem::Requirement.new(bundler_version).satisfied_by?(Gem::Version.new(Bundler::VERSION))
+    warn "Activating bundler (#{bundler_version}) failed:\n#{gem_error.message}\n\nTo install the version of bundler this project requires, run `gem install bundler -v '#{bundler_version}'`"
+    exit 42
+  end
+
+  def activation_error_handling
+    yield
+    nil
+  rescue StandardError, LoadError => e
+    e
+  end
+end
+
+m.load_bundler!
+
+if m.invoked_as_script?
+  load Gem.bin_path("bundler", "bundle")
+end

data/bin/rake

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rake", "rake")

data/bin/rdoc

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rdoc' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rdoc", "rdoc")

data/bin/rubocop

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rubocop' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rubocop", "rubocop")

data/doc/jamis.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module RDoc
 module Page
 

data/doc/rake.1

@@ -1,141 +1,156 @@
-.\"                                      Hey, EMACS: -*- nroff -*-
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.TH RAKE 1 "December 3, 2014" "rake 10.4.2" "Rake User Commands"
-.\" Please adjust this date whenever revising the manpage.
-.\"
-.\" Some roff macros, for reference:
-.\" .nh        disable hyphenation
-.\" .hy        enable hyphenation
-.\" .ad l      left justify
-.\" .ad b      justify to both left and right margins
-.\" .nf        disable filling
-.\" .fi        enable filling
-.\" .br        insert line break
-.\" .sp <n>    insert n+1 empty lines
-.\" for manpage-specific macros, see man(7)
-.SH NAME
-rake \- a make-like build utility for Ruby
-.SH SYNOPSIS
-\fBrake\fR [\fI\-f rakefile\fR] {\fIOPTIONS\fR} \fITARGETS...\fR
-.br
-.SH DESCRIPTION
-.B rake
-is a make-like build utility for Ruby. Tasks and dependencies are specified in
-standard Ruby syntax.
-.SH OPTIONS
-.TP
-\fB\-m\fR, \fB\-\-multitask\fR
+.Dd June 12, 2016
+.Dt RAKE 1
+.Os rake 11.2.2
+.Sh NAME
+.Nm rake
+.Nd make-like build utility for Ruby
+.Sh SYNOPSIS
+.Nm
+.Op Fl f Ar rakefile
+.Op Ar options
+.Ar targets ...
+.Sh DESCRIPTION
+.Nm
+is a
+.Xr make 1 Ns -like
+build utility for Ruby.
+Tasks and dependencies are specified in standard Ruby syntax.
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl m , Fl -multitask
 Treat all tasks as multitasks.
-.TP
-\fB\-B\fR, \fB\-\-build\-all\fR
+.It Fl B , Fl -build-all
 Build all prerequisites, including those which are up\-to\-date.
-
-.TP
-\fB\-j\fR, \fB\-\-jobs\fR [\fINUMBER\fR]
+.It Fl j , Fl -jobs Ar num_jobs
 Specifies the maximum number of tasks to execute in parallel (default is number of CPU cores + 4).
-
-.SS Modules
-.TP
-\fB\-I\fR, \fB\-\-libdir\fR \fILIBDIR\fR
-Include \fILIBDIR\fR in the search path for required modules.
-.TP
-\fB\-r\fR, \fB\-\-require\fR \fIMODULE\fR
-Require \fIMODULE\fR before executing rakefile.
-
-.SS Rakefile location
-.TP
-\fB\-f\fR, \fB\-\-rakefile\fR [\fIFILENAME\fR]
-Use \fIFILENAME\fR as the rakefile to search for.
-.TP
-\fB\-N\fR, \fB\-\-no\-search\fR, \fB\-\-nosearch\fR
+.El
+.Ss Modules
+.Bl -tag -width Ds
+.It Fl I , Fl -libdir Ar libdir
+Include
+.Ar libdir
+in the search path for required modules.
+.It Fl r , Fl -require Ar module
+Require
+.Ar module
+before executing
+.Pa rakefile .
+.El
+.Ss Rakefile location
+.Bl -tag -width Ds
+.It Fl f , Fl -rakefile Ar filename
+Use
+.Ar filename
+as the rakefile to search for.
+.It Fl N , Fl -no-search , Fl -nosearch
 Do not search parent directories for the Rakefile.
-.TP
-\fB\-G\fR, \fB\-\-no\-system\fR, \fB\-\-nosystem\fR
+.It Fl G , Fl -no-system , Fl -nosystem
 Use standard project Rakefile search paths, ignore system wide rakefiles.
-.TP
-\fB\-R\fR, \fB\-\-rakelibdir\fR \fIRAKELIBDIR\fR
-Auto\-import any .rake files in \fIRAKELIBDIR\fR (default is 'rakelib')
-.HP
-\fB\-\-rakelib\fR
-.TP
-\fB\-g\fR, \fB\-\-system\fR
-Using system wide (global) rakefiles (usually '\fI~/.rake/*.rake\fR').
-
-.SS Debugging
-.TP
-\fB\-\-backtrace\fR=\fI\,[OUT]\/\fR
-Enable full backtrace.  \fIOUT\fR can be stderr (default) or stdout.
-.TP
-\fB\-t\fR, \fB\-\-trace\fR=\fI\,[OUT]\/\fR
-Turn on invoke/execute tracing, enable full backtrace. \fIOUT\fR can be stderr (default) or stdout.
-.TP
-\fB\-\-suppress\-backtrace\fR \fIPATTERN\fR
-Suppress backtrace lines matching regexp \fIPATTERN\fR. Ignored if \fI\-\-trace\fR is on.
-.TP
-\fB\-\-rules\fR
+.It Fl R , Fl -rakelib Ar rakelibdir , Fl -rakelibdir Ar rakelibdir
+Auto-import any .rake files in
+.Ar rakelibdir
+(default is
+.Sq rakelib )
+.It Fl g , Fl -system
+Use system-wide (global) rakefiles (usually
+.Pa ~/.rake/*.rake ) .
+.El
+.Ss Debugging
+.Bl -tag -width Ds
+.It Fl -backtrace Ns = Ns Ar out
+Enable full backtrace.
+.Ar out
+can be
+.Dv stderr
+(default) or
+.Dv stdout .
+.It Fl t , Fl -trace Ns = Ns Ar out
+Turn on invoke/execute tracing, enable full backtrace.
+.Ar out
+can be
+.Dv stderr
+(default) or
+.Dv stdout .
+.It Fl -suppress-backtrace Ar pattern
+Suppress backtrace lines matching regexp
+.Ar pattern .
+Ignored if
+.Fl -trace
+is on.
+.It Fl -rules
 Trace the rules resolution.
-
-.TP
-\fB\-n\fR, \fB\-\-dry\-run\fR
+.It Fl n , Fl -dry-run
 Do a dry run without executing actions.
-.TP
-\fB\-T\fR, \fB\-\-tasks\fR [\fIPATTERN\fR]
-Display the tasks (matching optional \fIPATTERN\fR) with descriptions, then exit.
-.TP
-\fB\-D\fR, \fB\-\-describe\fR [\fIPATTERN\fR]
-Describe the tasks (matching optional \fIPATTERN\fR), then exit.
-.TP
-\fB\-W\fR, \fB\-\-where\fR [\fIPATTERN\fR]
-Describe the tasks (matching optional \fIPATTERN\fR), then exit.
-.TP
-\fB\-P\fR, \fB\-\-prereqs\fR
+.It Fl T , Fl -tasks Op Ar pattern
+Display the tasks (matching optional
+.Ar pattern )
+with descriptions, then exit.
+.It Fl D , Fl -describe Op Ar pattern
+Describe the tasks (matching optional
+.Ar pattern ) ,
+then exit.
+.It Fl W , Fl -where Op Ar pattern
+Describe the tasks (matching optional
+.Ar pattern ) ,
+then exit.
+.It Fl P , Fl -prereqs
 Display the tasks and dependencies, then exit.
-
-.TP
-\fB\-e\fR, \fB\-\-execute\fR \fICODE\fR
+.It Fl e , Fl -execute Ar code
 Execute some Ruby code and exit.
-.TP
-\fB\-p\fR, \fB\-\-execute\-print\fR \fICODE\fR
+.It Fl p , Fl -execute-print Ar code
 Execute some Ruby code, print the result, then exit.
-.TP
-\fB\-E\fR, \fB\-\-execute\-continue\fR \fICODE\fR
+.It Fl E , Fl -execute-continue Ar code
 Execute some Ruby code, then continue with normal task processing.
-
-.SS Information
-.TP
-\fB\-v\fR, \fB\-\-verbose\fR
+.El
+.Ss Information
+.Bl -tag -width Ds
+.It Fl v , Fl -verbose
 Log message to standard output.
-.TP
-\fB\-q\fR, \fB\-\-quiet\fR
+.It Fl q , Fl -quiet
 Do not log messages to standard output.
-.TP
-\fB\-s\fR, \fB\-\-silent\fR
-Like \fB\-\-quiet\fR, but also suppresses the 'in directory' announcement.
-.TP
-\fB\-X\fR, \fB\-\-no\-deprecation\-warnings\fR
+.It Fl s , Fl -silent
+Like
+.Fl -quiet ,
+but also suppresses the
+.Sq in directory
+announcement.
+.It Fl X , Fl -no-deprecation-warnings
 Disable the deprecation warnings.
-.TP
-\fB\-\-comments\fR
+.It Fl -comments
 Show commented tasks only
-.TP
-\fB\-A\fR, \fB\-\-all\fR
-Show all tasks, even uncommented ones (in combination with \fB\-T\fR or \fB\-D\fR)
-.TP
-\fB\-\-job\-stats\fR [\fILEVEL\fR]
-Display job statistics. \fILEVEL=history\fR displays a complete job list
-.TP
-\fB\-V\fR, \fB\-\-version\fR
+.It Fl A , Fl -all
+Show all tasks, even uncommented ones (in combination with
+.Fl T
+or
+.Fl D )
+.It Fl -job-stats Op Ar level
+Display job statistics.
+If
+.Ar level
+is
+.Sq history ,
+displays a complete job list.
+.It Fl V , Fl -version
 Display the program version.
-.TP
-\fB\-h\fR, \fB\-H\fR, \fB\-\-help\fR
+.It Fl h , Fl H , Fl -help
 Display a help message.
-
-.SH SEE ALSO
-The complete documentation for \fBrake\fR has been installed at \fI/usr/share/doc/rake-doc/html/index.html\fR. It is also available online at \fIhttp://docs.seattlerb.org/rake\fR.
-.SH AUTHOR
-.B rake
-was written by Jim Weirich <jim@weirichhouse.org>
-.PP
-This manual was created by Caitlin Matos <caitlin.matos@zoho.com> for the Debian project (but may be used by others). It was inspired by the manual by Jani Monoses <jani@iv.ro> for the Ubuntu project.
+.El
+.Sh SEE ALSO
+The complete documentation for
+.Nm rake
+has been installed at
+.Pa /usr/share/doc/rake-doc/html/index.html .
+It is also available online at
+.Lk https://ruby.github.io/rake .
+.Sh AUTHORS
+.An -nosplit
+.Nm
+was written by
+.An Jim Weirich Aq Mt jim@weirichhouse.org .
+.Pp
+This manual was created by
+.An Caitlin Matos Aq Mt caitlin.matos@zoho.com
+for the Debian project (but may be used by others).
+It was inspired by the manual by
+.An Jani Monoses Aq Mt jani@iv.ro
+for the Ubuntu project.