rake 11.3.0 → 12.0.0.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 184b8d40ba4318206ffb77ecbec59f404f79c3a4
-  data.tar.gz: 34df138dc05774d528519aaf2de75d5af73009e9
+  metadata.gz: 7a2ad30b1c047b07f92723581ef8569bc40463b7
+  data.tar.gz: b92a7aee36f6319bd904831475bdc1fdbbd17a90
 SHA512:
-  metadata.gz: 5e21c0877242d27258e08ac9262cba80c6d14950cfb777c899e412872e53bcc52f39e5eb705fda4dfbbd0cdfa8fb208d642473c82158794fe8c80c698c9a3daf
-  data.tar.gz: 30ec40ec21a545bd2006118b0dc661fa5579a6309a79630b0856a05f19aeaf38e46f181d1f7fd17aaf101641292503494374902adb6fd99785a5775f2eb83d76
+  metadata.gz: f23ce6c0ac605c2e818b734df7f67ad7c0e34bdde880735723f18cefc79313b6df0ea178cb29cb09099a1fa0473a740a60624bf0d60954ae0161b64052855448
+  data.tar.gz: 3aea3dffbfe317a004c2c51ca73aed5b2ffbf4c0bdf40673d56d72846679b5d6a87c3ab9ff0b2ba55f4204a9df2e13c7ef6ee494f71647135046869a3e724250

data/.rubocop.yml

@@ -1,18 +1,57 @@
-StringLiterals:
-  Enabled: false
+AllCops:
+  TargetRubyVersion: 2.3
+  DisabledByDefault: true
+  Exclude:
+    - doc/**/*.rb
+    - rake.gemspec
 
-SpaceAroundEqualsInParameterDefault:
-  Enabled: false
+Style/LineLength:
+  Enabled: true
+  Max: 120
+
+Style/HashSyntax:
+  Enabled: true
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/IndentationWidth:
+  Enabled: true
+
+Style/Tab:
+  Enabled: true
+
+Style/EmptyLines:
+  Enabled: true
+
+Style/TrailingBlankLines:
+  Enabled: true
 
-HashSyntax:
-  Enabled: false
+Style/TrailingWhitespace:
+  Enabled: true
+
+Style/SpaceBeforeBlockBraces:
+  Enabled: true
 
-LineLength:
+Style/SpaceInsideBlockBraces:
   Enabled: true
-  Max: 90
 
-WhileUntilModifier:
-  Enabled: false
+Style/SpaceInsideHashLiteralBraces:
+  Enabled: true
 
-IfUnlessModifier:
-  Enabled: false
+Style/CaseIndentation:
+  Enabled: true
+
+Style/MultilineIfThen:
+  Enabled: true
+
+Style/MethodDefParentheses:
+  Enabled: true
+
+Style/BracesAroundHashParameters:
+  Enabled: true
+
+Lint/EndAlignment:
+  Enabled: true
+  AlignWith: variable

data/.travis.yml

@@ -8,20 +8,13 @@ rvm:
   - 2.3.1
   - ruby-head
   - jruby-1.7.20
-  - jruby-9.0.5.0
-  - jruby-9.1.0.0
+  - jruby-9.1.5.0
   - jruby-head
-  - rbx-2
-  - rbx
 before_install:
-  - gem update bundler --no-document
+  - gem install bundler --no-document -v '~> 1.13.3'
 before_script:
   - unset JRUBY_OPTS
 script: ruby -Ilib exe/rake
-matrix:
-  allow_failures:
-    - rvm: jruby-head
-    - rvm: rbx
 notifications:
   email:
   - hsbt@ruby-lang.org

data/Gemfile

@@ -1,3 +1,3 @@
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 gemspec

data/History.rdoc

@@ -1,24 +1,37 @@
+=== 12.0.0(dev)
+
+==== Compatibility Changes
+
+* Remove arguments on clear #157 by Jesse Bowes
+* Removed `rake/contrib` packages. These are extracted to `rake-contrib` gem.
+* Removed to deprecated warnings for `last\_comment`.
+
+==== Enhancements:
+
+* Re-use trace option on `cleanup` task. #164 by Brian Henderson
+* Actions adore keyword arguments #174 by Josh Cheek
+
 === 11.3.0 / 2016-09-20
 
-Enhancements:
+==== Enhancements:
 
 * Remove to reference `Fixnum` constant. Pull request #160 by nobu
 
 === 11.2.2 / 2016-06-12
 
-Bug fixes:
+==== Bug fixes
 
 * Fix unexpected behavior with multiple dependencies on Rake::TestTask
 
 === 11.2.1 / 2016-06-12
 
-Bug fixes:
+==== Bug fixes
 
 * Fix regression of dependencies handling on Rake::TestTask. Report #139
 
 === 11.2.0 / 2016-06-11
 
-Bug fixes:
+==== Bug fixes
 
 * Fix unexpected cut-out behavior on task description using triple dots
   and exclamation. Report #106 from Stephan Kämper and Pull request #134 by Lee
@@ -26,7 +39,7 @@ Bug fixes:
   by bakunyo
 * Ignore to use `hwprefs` on Darwin platform. Use sysctl now. Report #128
 
-Enhancements:
+==== Enhancements
 
 * Spawn options for sh Pull equest #138 by Eric Hodel.
 * Allow to specify dependencies(prerequisites) for Rake::TestTask
@@ -38,39 +51,39 @@ Enhancements:
 
 === 11.1.2 / 2016-03-28
 
-Bug fixes:
+==== Bug fixes
 
 * Remove `-W` option when Rake::TestTask#verbose enabled. It's misunderstanding
   specification change with Rake 11. Partly revert #67
 
 === 11.1.1 / 2016-03-14
 
-Bug fixes:
+==== Bug fixes
 
 * Use `-W` instead of `--verbose` when Rake::TestTask#verbose enabled.
   JRuby doesn't have `--verbose` option.
 
 === 11.1.0 / 2016-03-11
 
-Compatibility Changes:
+==== Compatibility Changes
 
 * Revert to remove `last\_comment`. It will remove Rake 12.
 
 === 11.0.1 / 2016-03-09
 
-Bug fixes:
+==== Bug fixes
 
 * Fixed packaging manifest.
 
 === 11.0.0 / 2016-03-09
 
-Bug fixes:
+==== Bug fixes
 
 * Correctly handle bad encoding in exception messages. Pull request #113
   by Tomer Brisker
 * Fix verbose option at TestTask. Pull request #67 by Mike Blumtritt
 
-Enhancements:
+==== Enhancements
 
 * Make FileList#exclude more analogous to FileList#include.
 * Use IO.open instead of Open3.popen3 for CPU counter.
@@ -84,7 +97,7 @@ Enhancements:
   Pull request #12 by Chris Keathley
 * Use ruby warnings by default. Pull request #97 by Harold Giménez
 
-Compatibility Changes:
+==== Compatibility Changes
 
 * Removed to support Ruby 1.8.x
 * Removed constant named `RAKEVERSION`
@@ -98,7 +111,7 @@ Compatibility Changes:
 
 === 10.5.0 / 2016-01-13
 
-Enhancements:
+==== Enhancements
 
 * Removed monkey patching for Ruby 1.8. Pull request #46 by Pablo Herrero.
 * Inheritance class of Rake::FileList returns always self class.
@@ -106,7 +119,7 @@ Enhancements:
 
 === 10.4.2 / 2014-12-02
 
-Bug fixes:
+==== Bug fixes
 
 * Rake no longer edits ARGV.  This allows you to re-exec rake from a rake
   task.  Pull requset #9 by Matt Palmer.
@@ -117,14 +130,14 @@ Bug fixes:
 
 === 10.4.1 / 2014-12-01
 
-Bug fixes:
+==== Bug fixes
 
 * Reverted fix for #277 as it caused numerous issues for rake users.
   rails/spring issue #366 by Gustavo Dutra.
 
 === 10.4.0 / 2014-11-22
 
-Enhancements:
+==== Enhancements
 
 * Upgraded to minitest 5.  Pull request #292 by Teo Ljungberg.
 * Added support for Pathname in rake tasks.  Pull request #271 by Randy
@@ -135,7 +148,7 @@ Enhancements:
   task.  Issue #277 by Matt Palmer.
 * Etc.nprocessors is used for counting the number of CPUs.
 
-Bug fixes:
+==== Bug fixes
 
 * Updated rake manpage.  Issue #283 by Nathan Long, pull request #291 by
   skittleys.
@@ -148,7 +161,7 @@ Bug fixes:
 
 === 10.3.2 / 2014-05-15
 
-Bug fixes:
+==== Bug fixes
 
 * Rake no longer infinitely loops when showing exception causes that refer to
   each other.  Bug #272 by Chris Bandy.
@@ -156,7 +169,7 @@ Bug fixes:
 
 === 10.3.1 / 2014-04-17
 
-Bug fixes:
+==== Bug fixes
 
 * Really stop reporting an error when cleaning already-deleted files.  Pull
   request #269 by Randy Coulman
@@ -164,13 +177,13 @@ Bug fixes:
 
 === 10.3 / 2014-04-15
 
-Enhancements:
+==== Enhancements
 
 * Added --build-all option to rake which treats all file prerequisites as
   out-of-date.  Pull request #254 by Andrew Gilbert.
 * Added Rake::NameSpace#scope.  Issue #263 by Jon San Miguel.
 
-Bug fixes:
+==== Bug fixes
 
 * Suppress org.jruby package files in rake error messages for JRuby users.
   Issue #213 by Charles Nutter.
@@ -182,13 +195,13 @@ Bug fixes:
 
 === 10.2.2 / 2014-03-27
 
-Bug fixes:
+==== Bug fixes
 
 * Restored Ruby 1.8.7 compatibility
 
 === 10.2.1 / 2014-03-25
 
-Bug fixes:
+==== Bug fixes
 
 * File tasks including a ':' are now top-level tasks again.  Issue #262 by
   Josh Holtrop.
@@ -197,7 +210,7 @@ Bug fixes:
 
 === 10.2.0 / 2014-03-24
 
-Enhancements:
+==== Enhancements
 
 * Rake now requires Ruby 1.9 or newer.  For me, this is a breaking change, but
   it seems that Jim planned to release it with Rake 10.2.  See also pull
@@ -215,7 +228,7 @@ Enhancements:
   Filip Hrbek.
 * Rake now prints the exception class on errors.  Patch #251 by David Cornu.
 
-Bug fixes:
+==== Bug fixes
 
 * Fixed typos.  Pull request #256 by Valera Rozuvan, #250 via Jake Worth, #260
   by Zachary Scott.
@@ -227,11 +240,10 @@ Bug fixes:
 * Fixed bug in can\_detect\_signals? in test.  Patch from #243 by Alexey
   Borzenkov.
 
-=== 10.1.1 and earlier
+=== 10.1.1
 
-Additions to the old CHANGES file were not made consistently so some
-versions are missing from this file.  These changes are usually described in
-the individual release notes files.
+* Use http://github.com/jimweirich/rake instead of http://rake.rubyforge.org for
+  canonical project url.
 
 === 10.1.0
 

data/README.rdoc

@@ -2,7 +2,7 @@
 
 home :: https://github.com/ruby/rake
 bugs :: https://github.com/ruby/rake/issues
-docs :: http://docs.seattlerb.org/rake/
+docs :: https://ruby.github.io/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]
 
 == Description
@@ -24,9 +24,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  respectively.)
 
 * Supports parallel execution of tasks.
 
@@ -101,7 +101,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.

data/Rakefile

@@ -6,28 +6,33 @@
 # 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)
 
-
-# XXX: https://github.com/bundler/bundler/pull/4981
-require 'bundler/plugin/api/source'
-
-require 'bundler/gem_tasks'
-require 'rake/testtask'
-require 'rdoc/task'
+require "bundler/gem_tasks"
+require "rake/testtask"
+require "rdoc/task"
 
 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
 
 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
+  `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/appveyor.yml

@@ -1,16 +1,13 @@
 ---
-version: "{build}"
 clone_depth: 10
 install:
   - SET PATH=C:\Ruby%ruby_version%\bin;%PATH%
-  - ruby --version
-  - gem --version
-  - gem install minitest bundler --no-document
-build_script:
-  - net user
-  - net localgroup
+  - gem install bundler --no-document
+  - bundle install
+build: off
 test_script:
   - ruby -Ilib exe/rake
+deploy: off
 environment:
   matrix:
     - ruby_version: "193"
@@ -20,3 +17,5 @@ environment:
     - ruby_version: "21-x64"
     - ruby_version: "22"
     - ruby_version: "22-x64"
+    - ruby_version: "23"
+    - ruby_version: "23-x64"

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.