Browse files

Bump to 10.0.3 and add release docs.

  • Loading branch information...
jimweirich committed Dec 12, 2012
1 parent 976132c commit 2b0e29ec2608b80e635fda0ed74a535395987c42
Showing with 192 additions and 1 deletion.
  1. +191 −0 doc/release_notes/rake-10.0.3.rdoc
  2. +1 −1 lib/rake/version.rb
@@ -0,0 +1,191 @@
+= Rake 10.0.3 Released
+ "Jim, when will Rake reach version 1.0?"
+Over the past several years I've been asked that question at
+conferences, panels and over twitter. Due to historical reasons (or
+maybe just plain laziness) Rake has (incorrectly) been treating the
+second digit of the version as the major release number. So in my head
+Rake was already at version 9.
+Well, it's time to fix things. This next version of Rake drops old,
+crufty, backwards compatibility hacks such as top level constants, DSL
+methods defined in Object and numerous other features that are just no
+longer desired. It's also time to drop the leading zero from the
+version number as well and call this new version of rake what it
+really is: Version 10.
+So, welcome to Rake 10.0!
+Rake 10 is actually feature identical to the latest version of Rake 9
+(that would be the version spelled 0.9.3), *except* that Rake 10 drops
+all the sundry deprecated features that have accumulated over the years.
+If your Rakefile is up to date and current with all the new features
+of Rake 10, you are ready to go. If your Rakefile still uses a few
+deprecated feeatures, feel free to use Rake 9 (0.9.3) with the same
+feature set. Just be aware that future features will be in Rake 10
+family line.
+== Changes in Version 10
+As mentioned above, there are no new features in Rake 10. However,
+there are a number of features missing:
+* Classic namespaces are now gone. Rake is no longer able to reflect
+ the options settings in the global variables ($rakefile, $show_tasks,
+ $show_prereqs, $trace, $dryrun and $silent). The
+ <tt>--classic-namespace</tt> option is no longer supported.
+* Global constants are no longer supported. This includes
+ <tt>Task</tt>, <tt>FileTask</tt>, <tt>FileCreationTask</tt> and
+ <tt>RakeApp</tt>). The constant missing hook to warn about using
+ global rake constants has been removed.
+* The Rake DSL methods (task, file, directory, etc) are in their own
+ module (Rake::DSL). The stub versions of these methods (that printed
+ warnings) in Object have been removed. However, the DSL methods are
+ added to the top-level <tt>main</tt> object. Since <tt>main</tt> is
+ not in the inheritance tree, the presence of the DSL methods in main
+ should be low impact on other libraries.
+ If you want to use the Rake DSL commands from your own code, just
+ include <tt>Rake::DSL</tt> into your own classes and modules.
+* The deprecated syntax for task arguments (the one using
+ <tt>:needs</tt>) has been removed.
+* The <tt>--reduce-compat</tt> flag has been removed (it's not needed
+ anymore).
+* The deprecated <tt>rake/sys.rb</tt> library has been removed.
+* The deprecated <tt>rake/rdoctask.rb</tt> library has been removed.
+ RDoc supplies its own rake task now.
+* The deprecated <tt>rake/gempackagetask.rb</tt> library has been
+ removed. Gem supplies its own package task now.
+There is one small behavioral change:
+* Non-file tasks now always report the current time as their time
+ stamp. This is different from the previous behavior where non-file
+ tasks reported current time only if there were no prerequisites, and
+ the max prerequisite timestamp otherwise. This lead to inconsistent
+ and surprising behavior when adding prerequisites to tasks that in
+ turn were prequisites to file tasks. The new behavior is more
+ consistent and predictable.
+== Changes (from 0.9.3, 0.9.4, 0.9.5)
+Since Rake 10 includes the changes from the last version of Rake 9,
+we'll repeat the changes for versions 0.9.3 through 0.9.5 here.
+=== New Features (in 0.9.3)
+* Multitask tasks now use a thread pool. Use -j to limit the number of
+ available threads.
+* Use -m to turn regular tasks into multitasks (use at your own risk).
+* You can now do "Rake.add_rakelib 'dir'" in your Rakefile to
+ programatically add rake task libraries.
+* You can specific backtrace suppression patterns (see
+ --supress-backtrace)
+* Directory tasks can now take prerequisites and actions
+* Use --backtrace to request a full backtrace without the task trace.
+* You can say "--backtrace=stdout" and "--trace=stdout" to route trace
+ output to standard output rather than standard error.
+* Optional 'phony' target (enable with 'require 'rake/phony'") for
+ special purpose builds.
+* Task#clear now clears task comments as well as actions and
+ prerequisites. Task#clear_comment will specifically target comments.
+* The --all option will force -T and -D to consider all the tasks,
+ with and without descriptions.
+=== Bug Fixes (in 0.9.3)
+* Semi-colons in windows rakefile paths now work.
+* Improved Control-C support when invoking multiple test suites.
+* egrep method now reads files in text mode (better support for
+ Windows)
+* Better deprecation line number reporting.
+* The -W option now works with all tasks, whether they have a
+ description or not.
+* File globs in rake should not be sorted alphabetically, independent
+ of file system and platform.
+* Numerous internal improvements.
+* Documentation typos and fixes.
+=== Bug Fixes (in 0.9.4)
+* Exit status with failing tests is not correctly set to non-zero.
+* Simplified syntax for phony task (for older versions of RDoc).
+* Stand alone FileList usage gets glob function (without loading in
+ extra dependencies)
+=== Bug Fixes (in 0.9.5)
+* --trace and --backtrace no longer swallow following task names.
+== What is Rake
+Rake is a build tool similar to the make program in many ways. But
+instead of cryptic make recipes, Rake uses standard Ruby code to
+declare tasks and dependencies. You have the full power of a modern
+scripting language built right into your build tool.
+== Availability
+The easiest way to get and install rake is via RubyGems ...
+ gem install rake (you may need root/admin privileges)
+Otherwise, you can get it from the more traditional places:
+Home Page::
+GitHub:: git://
+== Thanks
+As usual, it was input from users that drove a lot of these changes. The
+following people contributed patches, made suggestions or made
+otherwise helpful comments. Thanks to ...
+* Aaron Patterson
+* Dylan Smith
+* Jo Liss
+* Jonas Pfenniger
+* Kazuki Tsujimoto
+* Michael Bishop
+* Michael Elufimov
+* Ryan Davis
+* Sam Grönblom
+* Sam Phippen
+* Sergio Wong
+* Tay Ray Chuan
+* grosser
+* quix
+Also, many thanks to Eric Hodel for assisting with getting this release
+out the door.
+-- Jim Weirich
@@ -1,5 +1,5 @@
module Rake
- VERSION = '10.0.2'
+ VERSION = '10.0.3'
module Version # :nodoc: all
MAJOR, MINOR, BUILD, = Rake::VERSION.split '.'

0 comments on commit 2b0e29e

Please sign in to comment.