capistrano 2.0.0 → 2.15.5

data/CHANGELOG

@@ -1,4 +1,723 @@
-*2.0.0* July 21, 2007
+## 2.15.5 / July 4 2013
+
+* Fix multistage argument parsing when using the `-s` option. (@jmazzi)
+* Tweaks to the asset recipes. (@curtislinden)
+* Use quotes around SCM usernames and passwords (@carloslopes)
+* Avoid git warning when cloning Git repository using sha1 (@bpaquet)
+
+## 2.15.4 / April 29 2013
+
+* Fix parallel command logging (@gnufied)
+* Fix a double-asset manifest problem on Rails upgrades. (@jimryan)
+
+## 2.15.3 / April 25 2012
+
+* For deploy:cleanup, use try_sudo with rm command. (@joshstaiger)
+* Restore maintenance.rhtml (@chulkilee)
+* Fixes GH-434, If branches is an array of array, iterate them separately. (@gnufied)
+
+A big "thank you" to the people who've pushed really amazing patches to the
+2.15.x branch so soon after it's release. 2.15.0 was just too huge to go out
+bug free.
+
+## 2.15.2 / April 24 2013
+
+* Fixed a bug with asset_paths (String vs. Array). (@joeycarmello)
+
+## 2.15.1 / April 23 2013
+
+* Support for Rails 4 (and other) randomised asset manifest names. (@jimryan)
+
+## 2.15.0 / April 23 2013
+
+* New varaible :shared_assets_prefix to allow people to host somewhere other
+  than `/assets/`. Default is `assets`.
+* Bring back web:enable and web:disable tasks. Sincerely apologies to all affected
+  removing these was one of the most glaring mistakes we've made on this project
+  and I feel personally responsible.
+* Makes :git_shallow_clone work with branches (@cannikin)
+* Avoid removing required assets (@bosko)
+* Fix escaping of asset_paths when calling `deploy:finalize_update` (@mcary)
+* Improve parallel command logging (@mpapis)
+* Allow updating variables in the cap shell `cap> set :some_setting new_value`
+  (@jpfuentes2)
+* Add the option to configure `Capistrano::Logger.default_formatters=` this
+  relates to the previous merging of the capistrano-colors gem. (@kellyredding)
+* Don't attempt to connect to a nil `:gateway` (@mattheath)
+* Simplify our .gemspec dependency list (@timoschilling)
+* Make the existece of `config/deploy/{stage}.rb` optional, it'll be loaded if
+  it exists, otherwise we continue without it (@ymainier)
+* Misc spelling/typo fixes. (@mv)
+* Update mtime and atime with touch when fixing asset timestamps (@wildoats)
+* Change call of `rake {env} precompile:all` to drop the errornous `{env}` (@zxiest)
+* Evaluate assets_role at runtime using a lambda (@nlenepveu)
+* Handle when hosts (for example by joining/leaving the no_release meta group)
+  have different old releases for `deploy:cleanup` (@oggy)
+* Check for nil when tearing down connections (@yyuu)
+* Go back to using SCP for uploads as against SFTP (@pjungwir)
+* Added an option to dereference symlinks when using the :copy strategy
+  (`set :copy_dereference_symlink, true`) useful when your working directory
+  contains files symlinked in from outside your project root (@mehmetc)
+* Small typo fix in README (@yule)
+* Add Ruby 2.0.0-p0 to the TravisCI build (@jarrettmeyer)
+* Add the option to set the shared asset prefix for Rails,
+  (`set :shared_assets_prefix, "my_shared_assets"`) corresponds with it's
+  namesake in Rails. By default is set to `assets`. (@spectator)
+* Improved error messages for `cap {stage} deploy:check` (@petems)
+* Make `run_locally` work with the `--dry-run` flag. (@flagthisiskun)
+* Fix a link in the README to writing a good commit message. (@mhutchin)
+* Code style fixes (@mv)
+* Report differently if the command was killed by a signal (for example the
+  oom killer on Ubuntu/Debian). (@tanob)
+
+
+## 2.14.0 / January 9 2013
+
+* Removed ui.output_cols limit of 80 chars (@aussielunix)
+* Added :p4charset variable for Perforce command line (@randyinla)
+* Added support for rolling back assets, and removing expired assets (@ndbroadbent)
+* Merged in `capistrano_colors` gem, and renamed to 'log_formatters', since it does much more than just colors
+  (@ndbroadbent)
+* Use more intelligence in setting the :scm variable based on known version control directory names (@czarneckid)
+* Remove the deploy:web:{disable, enable} tasks (@carsomyr)
+* Group finalize_update shell commands into one command, harden shell calls with #shellescape, and separate arguments
+  with -- (@ndbroadbent)
+
+## 2.13.0 / August 21 2012
+
+This release contains multiple bugfixes and handling of exotic situations. The
+`Configuration#capture` method should now work in spite of `ActiveSupport`
+shenanigans. Thank you, the community, for all of your contributions:
+
+ * Close input streams when sending commands that don't read input. Dylan Smith
+   (dylanahsmith)
+ * Listen for method definition on `Kernel` and undefine on `Namespace`. Chris
+   Griego (cgriego)
+ * Fixed shell `Thread.abort_on_exception` bug. George Malamidis (nutrun)
+ * Adding a log method to `Capistrano::Deploy::SCM::None` to maintain
+   consistency with other SCM classes. Kevin Lawver (kplawver)
+ * Add deprecation warning if someone uses old `deploy:symlink` syntax on
+   callbacks. Ken Mazaika (kenmazaika)
+ * Simplify the `finalize_update` code by respecting the `:shared_children`
+   variable during removal and recreation of the parent. John Knight
+   (knightlabs)
+
+## 2.12.0 / April 13 2012
+
+This release reverts the very verbose logging introduced in the previous version, it also
+enables a handful of power-user features which are largely un-documented, but shouldn't be
+important unless you are looking for them. Undocumented code shouldn't scare you, simply
+read through deploy.rb in the Gem if you want to know how a new feature works!
+
+ * Update mapped commands to remove symlink deprecation warning. Despo Pentara (despo)
+ * Add the "rpm" remote dependency. Nick Hoffman (nickhoffman)
+ * Add commented deploy:cleanup task to default recipe. Jean-Philippe Doyle (j15e)
+ * Teach deploy:web:enable to fail gracefully. Lee Marlow (lmarlow)
+ * Ticket 193 alias task show wrong name when it is not overridden. Rafa García (rgo)
+ * Allow configuration of which roles assets are precompiled on. Frederick Cheung (fcheung)
+ * Fix transfer action to honor dry-run flag. Serg Podtynnyi (shtirlic)
+ * Changed single to double quotes for Windows, fixes a Windows bug in the HG module. Matthew J Morrison (mattjmorrison)
+ * Add UnsharedRemoteCache (copied from eycap gem). Ben Symonds (bensymonds)
+
+As ever, a sincere thanks to all contributors, and do not hesitate to contact me if this
+release causes problems for you.
+
+## 2.11.0 / Febuary 20 2012
+
+This release replaces and fixes a broken 2.10.0 release (see below for
+information)
+
+This release includes all fixes as documented for 2.10.0, plus additional code
+cleanup (SHA: 3eecac2), as well as changing the public API from
+`deploy:symlink`, to `deploy:create_symlink`
+
+* Remove a testing dependency on `ruby-debug` (Lee Hambley, reported by Serg
+Podtynnyi)
+
+* Formerly deprecate `deploy:symlink`, this move was prompted by the Rake
+namespace fiasco of their 0.9.0 release, and is replaced by
+`deploy:create_symlink`. If you are looking for a place to hook asset related
+tasks, please consider `deploy:finalize_update`. Replaced by
+`deploy:create_symlink`, `deploy:symlink` now raises a deprecation warning,
+and defers to `deploy:symlink`. (Lee Hambley)
+
+* Update the 2.10.0 changelog. (Lee Hambley, reported by Jérémy Lecour)
+
+## 2.10.0 / Febuary 19 2012
+
+If you are reading this after Febuary 20th 2012, do not be surprised when you
+cannot find 2.10.0 on Rubygems.org, it has been removed because of a breaking
+API change. It is replaced logically enough by 2.11.0 where the API is still
+changed, but now issues a warning and falls back to the expected behaviour.
+
+The CHANGELOG for this release was updated retrospectively, I'm sorry I missed
+that when releasing the gem, 2.10.0 apparently not my finest hour as a
+maintainer.
+
+Ths fixes in this release include
+
+* Include sample NGinx config for `deploy:web:disable`(added by Roger Ertesvåg)
+
+* Fix gemspec time format warning (reported by Tony Arcieri, fixed by building the Gem against Ruby-1.9.3)
+
+* Finally removed deprecated `before_` and `after_` tasks. (Lee Hambley)
+
+* Rake 0.9.x compatibility (reported by James Miller, fixed by Lee Hambley)
+
+* More detailed logging output (fixed by Huang Liang)
+
+* Includes multistage, without `capistrano-ext`. `require 'capistrano/ext/multistage'` (fixed by Lee Hambley)
+
+## 2.9.0 / September 24 2011
+
+A vairly heavy release, including some new features which most of you won't
+need, but power users have contributed, this also marks the beginning of the
+end of the 2.x series, more information will follow in due course, but with
+the proliferation of Bundler, and better ways to do deployment, we will be
+introducing heavier changes to Capistrano to keep the tool current.
+
+**Please note, following some reported problems with the asset pipeline code
+being not found, remember Capistrano needs to be in your Gemfile, and as such
+needs to be run with Bundler, otherwise you risk loading a system-wide version
+of Capistrano who's behaviour might be different from that specified in your
+Gemfile. This is also good practice because much of the deploy logic resides
+in the Gem, and you wouldn't want that to change without your knowledge. Rails
+applications include Cap in the Gemfile anyway, you should follow this
+convention.**
+
+* find_servers() will no longer raise if there are no servers, this behaviour
+can be modified by way of the `:on_no_matching_servers` option. Thanks to
+`@ppgengler`.
+
+* Short Git SHA1 fragments are now supported in commands such as `cap deploy
+-s revision=d7e99f` thanks to `@ndbroadbent`.
+
+* One can now specify individual SCM commands by setting
+`:scm_arguments_<command_name>`. Thanks to `@alextk`.
+
+* Travis CI build now passes thanks to @andrew, build tested against MRI
+`1.8.7`. `1.9.2` and `REE`.
+
+* Support for Perforce labels, I don't know much about this, but I believe
+it's much like deploying a Git tag, thanks to `@ak47`.
+
+* Git SCM now correctly adheres to the `:scm_verbose` setting. Thanks
+`@dubek`.
+
+* `set()` can now be used to set a `false` value, previously this was a no-op.
+Thanks to `@nilbus`.
+
+* Support for Git 1.6x submodules, The Git SCM strategy now queries Git on the
+server-side to ensure it supports the `--recursive` flag, if it doesn't then
+it will fall back to using the long-hand. Many thanks to all those involved in
+the discussion surrounding this topic, and to `@nilbus` for a beautifully
+clean solution which doesn't hold us back.
+
+* When using `:cached_copy` with Subversion, use `svn switch` to for more
+reliable switching of branches/etc. Thanks to `@iGEL` for the patch that we
+accepted finally, and to `@richmeyers` who also submitted a patch and
+contributed to the discssion.
+
+Other cleanups and minor improvements to the code and tests were committed by yours truly
+(@leehambley), @maxim, @ak47 and @andrew).
+
+## 2.8.0 / August 3 2011
+
+A short release, after the last. Announcing Rails 3.1 asset pipeline support.
+
+The asset pipeline support requires an additiona `load` in your `Capfile`.
+
+You can see information pertaining to the pull request, including the inline
+comments here: https://github.com/capistrano/capistrano/pull/35
+
+Documentation will be available soon in the wiki.
+
+* Drop-In Rails 3.1 asset pipeline support. (Chris Griego)
+
+## 2.7.0 / August 3 2011
+
+A fairly substantial release. There are fixes so that current_release works
+during dry-runs, (although, apparently still not with bundler.)
+
+The test-suite was also modified to work with Ruby 1.9.2, except in one case
+where Ruby 1.9.x calls `to_ary` and `to_a` on mocks, which still makes an
+error. 1.9.x has always been supported, but due to lack of maintenance on my
+part the tests didn't ever pass.
+
+The `start`, `stop` and `restart` tasks have been reduced to mere hooks into
+which extensions can define their own functionality.
+
+The `readme` was also slightly improved, simply tweaks to express how best to
+run the test suite.
+
+* Ensure dry-run works with `:current_release` variable (Carol Nichols)
+* Added a new variable `:git_submodules_recursive`, setting the value to false
+will ensure Git doesn't recursively initialize and checkout submodules. (Konstantin Kudryashov)
+* Added an additional task option, `:on_no_matching_servers`, setting the
+value to `:continue` will ensure tasks with no matched servers continue
+without error, instead of raising `Capistrano::NoMatchingServersError` as was
+the previous behaviour. (Chris Griego)
+
+A huge thanks to all contributors, as always!
+
+Remember: @capistranorb on twitter for news.
+
+## 2.6.1 / June 25 2011
+
+A short maintenance release, Some fixes to the verbose flag inside the Git SCM
+as well as another argument for the (internal) `variable()` command, offering
+a default. The Git SCM is now verbose by default, but can be disabled by
+setting `:scm_verbose` to false.
+
+There has been an additional method added to string, within the context of the
+test suite, I'm always sketchy about adding additional methods to core
+classes, but it's a short term fix until I make the time to patch the test
+suite not to compare strings literally. The method is `String#compact`, and is
+implemented simply as `self.gsub(/\s+/, ' ')`.
+
+Here's the run-down of changes, and their committers, as always - a huge thank
+you to the community that continues to drive Capistrano's development.
+
+* `deploy:setup` now respects `:group_writable` (Daniel Duvall)
+* Fixes to `:scm_verbose` for the Git module (defaults to On.) (Matthew Davies)
+* Will now copy hidden files in the project's root into the release
+directory (Mark Jaquith)
+* Now handles closing already-dead connections in a sane way (does not raise
+an exception) (Will Bryant)
+* Renamed `Capistrano::VERSION::TINY` to `Capistrano::VERSION::PATCH` (Lee
+Hambley)
+* Removed the `VERSION` file (Lee Hambley)
+
+## 2.6.0 / May 3 2011
+
+A rather large release, feature-version bump because of the new
+multiple-gateways feature as implemented by Ryan Duryea (way to go!)
+
+Please also note from this release that if you use Git submodules, the
+Git-version requirement for the new implementation is now >= 1.5.6, from
+previously un-documented. (1.5.6 is new-enough that I think this is
+acceptable)
+
+  * Upgrade Net::SSH-gateway dependency to 1.1 (fixes a thread-deadlocking bug on MRI  1.9)
+  * Respect "dry-run" on transfer methods (Florian Frank)
+  * Add support for multiple gateways: (Ryan Duryea)
+        set :gateway, {
+          'gate1.example.com' => 'server1.example.com',
+          [ 'gate2.example.com', 'gate3.example.com' ] => [ 'server5.example.com', 'server6.example.com' ]
+        }
+  * Properly support nested Git submodules, moves Git requirement to >= 1.5.6 [if  you rely upon submodules] (Ken Miller)
+  * Fetch tags into the remote cache, allows deploying a tag when using Git, with the remote_cache strategy (Florian Frank)
+  * Various fixes to path handling bugs in the copt strategy. (Philippe Rathé)
+
+## 2.5.21 / April 6 2011
+
+  * Fixed to follow best-practice guidelines from Bundler (Ben Langfeld)
+  * No longer force a gemset for Capistrano development. (Ben Langfeld)
+
+## 2.5.20 / March 16 2011
+
+  * `deploy:migrations` will now always operate on the latest_release, not
+  current_release (Mike Vincent)
+  * Adds a check for the presence of `rsync` when using the copy strategy with `rsync`. (Chris Griego)
+  * Do not try to look up the `:release_path` on servers which are defined `:no_release` (Chris Griego)
+  * Tiny patch to the `CVS` SCM code to be Ruby 1.9 compatible (Martin Carpenter)
+  * Changed the default `Git` submodule behaviour to use `--recursive`, Lighthouse Issue #176. (Lee Hambley)
+  * `:public_children` can now be `set()`, the default is unchanged, thanks (Chris Griego)
+  * Fixing the load path in the default `Capfile` to search vendored/unpacked Gems. Lighthouse Issue #174 (Mari Carmen/Rafael García)
+  * Adds a `maintenance_basename` variable (default value is `maintenance`) to allow you to set the maintenance page name (Celestino Gomes)
+  * Spelling fixes in inline-documentation (Tom Copeland)
+  * Make `zip` and `tar` handle symlinks the same way (zip follows symlinks by default, tar needs the option `-h`) (Ross Cooperman)
+
+## 2.5.19 / June 21, 2010
+
+  * Small bug fixes, no improvements for people who weren't experiencing problems anyway.
+
+## 2.5.18 / March 14, 2010
+
+Small fix for rolling back if a shell scripts exits non-zero; enabled a rollback if git (or other) externals fail during the deploy.
+
+  * #151 check return code status of system command to create local copy and rollback if not 0 (David King)
+
+## 2.5.17 / February 27, 2010
+
+Various small bug fixes.
+
+## 2.5.16 / February 14, 2010
+
+Fixed a small regression in 2.5.15
+
+## 2.5.15 / 14 February 2010
+
+Fixes a feature request not to overwrite roles when using the ROLES environmental variable.
+
+  * #126 - The option to not overwriting the roles which are defined in the task definition.
+  * Removed the `upgrade` file as it has been a couple of years since 1.x was in the wild.
+  * Slight internal re-factor of the way we calculate the `version`
+
+## 2.5.14 / 18 January 2010
+
+Fixes a low-value bug, thanks to Chris G for the well submitted patch:
+
+  * #139 - Improves consistency of variable lookup, scm variables with a local_ prefix will be honoured with priority locally (Chris Griego)
+
+## 2.5.13 / 6 January 2010
+
+* Small maintenance release:
+
+  * #118 - Modified CLI test to not load user or system configuration file (Emily Price)
+  * #88  - Re-fixed a problem here, massive apologies to all concerned. (Hangover from 2.5.12)
+
+## 2.5.12 / 5 January 2010
+
+* Tweak the directory version listing (caused a lot of problems, please upgrade immediately)
+
+## 2.5.11 / December 2009
+
+* Deprecations and other small changes
+
+## 2.5.10 / 3 November 2009
+
+* Fixes Darcs remote repository problem when using the copy strategy [Alex `regularfry` Young]
+* Documentation improvements for embedding Capistrano [Lee Hambley]
+* Fixes ticket #95 -formally deprecating the before_something and after_something methods [Lee Hambley]
+
+## 2.5.9 / 1 August 2009
+
+* Adds support for customizing which `tar` command to use. [Jeremy Wells]
+
+* Fixes a couple of documentation problems, typos and worse. [Lee Hambley]
+
+  * #105 - Add skip_hostfilter option to find_servers() [Eric]
+  * #103 - Using non-master branch fails with Ruby 1.9 [Suraj Kurapati]
+  * #96  - Tweak for 1.9 Compatibility
+  * #79  - Capistrano hangs on shell command for many computers
+  * #77  - Copy command doesn't work on Solaris due to tar/gtar
+  * #76  - Invalid Subversion URL
+  * Improved web:disable task, now suggests a .htaccess block to use suggested by Rafael García
+  * Includes more logger options (can now select stdout, stderr of a file) [Rafael García]
+
+## 2.5.8 / July 2009
+
+* Fixes a problem in 2.5.7 where deploy:finalize_update had been badly merged.
+
+## 2.5.6 & 2.5.7 / July 2009
+
+* 2.5.7 masks a broken 2.5.6 release that was accidentally mirrored via Rubyforge.
+
+* Clean the cached git repository [Graeme Mathieson]
+
+* Fixes perforce issues reported at http://bit.ly/wt0es [Scott Johnson]
+
+* Improved back-tick handling code in relation to the above.
+
+* Fixes a Git issue when submodules update upstream. (via mailing list) [sneakin]
+
+* Capify now creates the config directory in directories without one.
+
+## 2.5.5 / 24 Feb 2009
+
+* Make sure role(:foo) actually declares an (empty) role for :foo, even without server arguments [Jamis Buck]
+
+
+## 2.5.4 / 4 Feb 2009
+
+* When using rsync with the remote_cache strategy include -t switch to preserve file times [Kevin McCarthy]
+
+* Bump Net::SSH dependency to version 2.0.10 [Jamis Buck]
+
+* Use 'user' from .ssh/config appropriately [Jamis Buck]
+
+* Allow respond_to?() method to accept optional second parameter (include_priv) [Matthias Marschall]
+
+* Make sure sudo prompts are retried correctly even if "try again" and the prompt appear in the same text chunk from the server [Jamis Buck]
+
+* Add supported environment variables to -H output [François Beausoleil]
+
+
+## 2.5.3 / December 6, 2008
+
+* Make previous_release return nil if there is no previous release [Mathias Meyer]
+
+* Play nice with rubies that don't inspect terminals well (ie. JRuby) by defaulting screen columns to 80 [Bob McWhirter]
+
+* Rollback of deploy:symlink would explode if there was no previous revision to rollback to [Jamis Buck]
+
+* Fix bug in transfer.rb that caused get/put/upload/download to ignore blocks passed to them [arika]
+
+* Fix issue with git SCM that caused "Unable to resolve revision" errors when there was trailing whitespace in git's output [Mark Zuneska, Daniel Berlinger and Evan Closson]
+
+
+## 2.5.2 / November 13, 2008
+
+* Fix issue with git SCM that caused "Unable to resolve revision for 'HEAD'" errors on deploy [Jamis Buck]
+
+
+## 2.5.1 / November 7, 2008
+
+* Add -t (--tools) switch for better task lists for external tools [Jamis Buck]
+
+* Make the RemoteDependency#try method use invoke_command instead of run, for sudo-ability [Matthias Marschall]
+
+* Make locally executed commands in Windows more Windows-friendly [esad@esse.at]
+
+* Added :scm_arguments variable for custom SCM arguments (subversion-only, currently) [David Abdemoulaie]
+
+* Don't emit -p for sudo when :sudo_prompt is blank [Matthias Marschall]
+
+* Copy symlinks when using rsync [Paul Paradise]
+
+* Make sure git query-revision matches on exact branch name [grant@nightriot.com]
+
+* Use -T <arg> to filter listed tasks by a pattern [Mathias Meyer, Geoffrey Grosenbach]
+
+* Expose the #scm method on SCM::Base for building custom scm commands [Mathias Meyer]
+
+* Start logging some locally executed commands [springyweb]
+
+* Added HOSTFILTER environment variable for constraining tasks so they run only on hosts matching the given list of servers [Walter Smith]
+
+* Make sure the glob matching for copy excludes does not delete parent directories [Fabio Akita]
+
+* Ruby 1.9 compatibility [Jamis Buck]
+
+
+## 2.5.0 / August 28, 2008
+
+* Allow :gateway to be set to an array, in which case a chain of tunnels is created [Kerry Buckley]
+
+* Allow HOSTS spec to override even non-existent roles [Mike Bailey]
+
+* Sort releases via "ls -xt" instead of "ls -x" to allow for custom release names [Yan Pritzker]
+
+* Convert arguments to -s and -S into integers, booleans, etc. based on whether the arguments appear to be those types [Jamis Buck]
+
+* Add descriptions of -n and -d to the verbose help text [Jamis Buck]
+
+* Make rollbacks work with processes that need the current directory to be valid in order to restart properly (e.g. mongrel_rails) [Jamis Buck]
+
+* Rename deploy:rollback_code to deploy:rollback:code [Jamis Buck]
+
+* Added parallel() helper for executing multiple different commands in parallel [Jamis Buck]
+
+* Make sure a task only uses the last on_rollback block, once, on rollback [Jamis Buck]
+
+* Add :shared_children variable to customize which subdirectories are created by deploy:setup [Jonathan Share]
+
+* Allow filename globbing in copy_exclude setting for the copy strategy [Jonathan Share]
+
+* Allow remote_cache strategy to use copy_exclude settings (requires rsync) [Lewis Mackenzie]
+
+* Make None SCM module work in Windows [Carlos Kozuszko]
+
+* Recognize mingw as a Windows platform [Carlos Kozuszko]
+
+* Fixed failing tests in Windows [Carlos Kozuszko]
+
+* Made :scm_auth_cache control whether password option is emitted in subversion module [Brendan Schwartz]
+
+* Fixed timestamp bug in CVS module [Jørgen Fjeld]
+
+* Added -n/--dry-run switch, to display but not execute remote tasks [Paul Gross]
+
+
+## 2.4.3 / June 28, 2008
+
+* Fix gem dependencies so gem actually understands them [Jamis Buck]
+
+
+## 2.4.2 / June 27, 2008
+
+* Specify gem dependencies in rakefile [Jamis Buck]
+
+
+## 2.4.1 / June 27, 2008
+
+* Use Echoe to manage the Rakefile [Jamis Buck]
+
+* Let Net::SSH manage the default SSH port selection [Ben Lavender]
+
+* Changed capture() helper to not raise an exception on error, but to warn instead [Jeff Forcier]
+
+
+## 2.4.0 / June 13, 2008
+
+* Added :normalize_asset_timestamps option to deployment, defaulting to true, which allows asset timestamping to be disabled [John Trupiano]
+
+
+## 2.4.0 Preview Release #1 (2.3.101) / June 5, 2008
+
+* Only make deploy:start, deploy:stop, and deploy:restart try sudo as :runner. The other sudo-enabled tasks (deploy:setup, deploy:cleanup, etc.) will now use the :admin_runner user (which by default is unset). [Jamis Buck]
+
+* Make sure triggers defined as a block inherit the scope of the task they are attached to, instead of the task they were called from [Jamis Buck]
+
+* Make deploy:upload use the upload() helper for more efficient directory processing [Jamis Buck]
+
+* Make deploy:upload accept globs [Mark Imbriaco]
+
+* Make sure the host is reported with the output from scm_run [Jamis Buck]
+
+* Make git SCM honor the :scm_verbose option [Jamis Buck]
+
+* Don't follow symlinks when using :copy_cache [Jamis Buck]
+
+* If :mode is given to upload() helper, do a chmod after to set the mode [Jamis Buck]
+
+* Fix load_from_file method for windows users [Neil Wilson]
+
+* Display a deprecation error if a remote git branch is specified [Tim Harper]
+
+* Fix deployment recipes to use the updated sudo helper [Jamis Buck]
+
+* Enhance the sudo helper so it can be used to return the command, instead of executing it [Jamis Buck]
+
+* Revert "make sudo helper play nicely with complex command chains", since it broke stuff [Jamis Buck]
+
+* Make set(:default_shell, false) work for not using a shell on a per-command basis [Ryan McGeary]
+
+* Improved test coverage [Ryan McGeary]
+
+* Fixed "coverage" take task [Ryan McGeary]
+
+* Use upload() instead of put() with the copy strategy [Jamis Buck]
+
+* Revert the "git fetch --tags" change, since it didn't work as expected [Jamis Buck]
+
+* Fix deploy:pending when using git SCM [Ryan McGeary]
+
+* Make sure deploy:check works with :none scm (which has no default command) [Jamis Buck]
+
+* Add debug switch for enabling conditional execution of commands [Mark Imbriaco]
+
+
+## 2.3.0 / May 2, 2008
+
+* Make deploy:setup obey the :use_sudo and :runner directives, and generalize the :use_sudo and :runner options into a try_sudo() helper method [Jamis Buck]
+
+* Make sudo helper play nicely with complex command chains [Jamis Buck]
+
+* Expand file-transfer options with new upload() and download() helpers. [Jamis Buck]
+
+* Allow SCP transfers in addition to SFTP. [Jamis Buck]
+
+* Use Net::SSH v2 and Net::SSH::Gateway. [Jamis Buck]
+
+* Added #export method for git SCM [Phillip Goldenburg]
+
+* For query_revision, git SCM used git-rev-parse on the repo hosting the Capfile, which may NOT be the same tree as the actual source reposistory. Use git-ls-remote instead to resolve the revision for checkout. [Robin H. Johnson]
+
+* Allow :ssh_options hash to be specified per server [Jesse Newland]
+
+* Added support for depend :remote, :file to test for existence of a specific file [Andrew Carter]
+
+* Ensure that the default run options are mixed into the command options when executing a command from the cap shell [Ken Collins]
+
+* Added :none SCM module for deploying a specific directory's contents [Jamis Buck]
+
+* Improved "copy" strategy supports local caching and pattern exclusion (via :copy_cache and :copy_exclude variables) [Jamis Buck]
+
+
+## 2.2.0 / February 27, 2008
+
+* Fix git submodule support to init on sync [halorgium]
+
+* Add alternative server-centric role definition method [James Duncan Davidson]
+
+* Add support for password prompts from the Mercurial SCM [ches]
+
+* Add support for :max_hosts option in task definition or run() [Rob Holland <rob@inversepath.com>]
+
+* Distributed git support for better operability with remote_cache strategy [voidlock]
+
+* Use a default line length in help text if line length is otherwise too small [Jamis Buck]
+
+* Fix incorrect reference to the 'setup' task in task documentation [rajeshduggal]
+
+* Don't try to kill the spawner process on deploy:stop if no spawner process exists [Jamis Buck]
+
+* Dynamic roles (e.g. role(:app) { "host.name" }) [dmasover]
+
+* Implement Bzr#next_revision so that pending changes can be reported correctly [casret]
+
+* Use a proper export command for bzr SCM [drudru]
+
+* Use checkout instead of merge for git SCM [nuttycom]
+
+* Fix typo in Subversion SCM module, encountered when an update fails [kemiller]
+
+* Fix documentation typo in upload.rb [evolving_jerk]
+
+* Added test case to show that the :scm_command is honored by the git SCM module [grempe]
+
+* Fail gracefully when double-colons are used to delimit namespaces [richie]
+
+* Add support for :git_enable_submodules variable, to enable submodules with the git SCM [halorgium]
+
+* If subversion asks for a password, prompt as a last resort [Jamis Buck]
+
+* Use checkout --lightweight for bzr checkout, instead of branch [michiels]
+
+* Make sure bzr SCM works when revision is head (or unspecified) [michiels]
+
+* Support p4sync_flags and p4client_root variables for Perforce [gseidman]
+
+* Prepare for Net::SSH v2 by making sure Capistrano only tries to load Net::SSH versions less than 1.99.0 [Jamis Buck]
+
+
+## 2.1.0 / October 14, 2007
+
+* Default to 0664 instead of 0660 on upload [Jamis Buck]
+
+* Fix deploy:pending to query SCM for the subsequent revision so that it does not include the last deployed change [Jamis Buck]
+
+* Prefer 'Last Changed Rev' over 'Revision' when querying latest revision via Subversion [Jamis Buck]
+
+* Explicitly require 'stringio' in copy_test [mislav]
+
+* When Subversion#query_revision fails, give a more sane error [Jamis Buck]
+
+* Don't run the upgrade:revisions task on non-release servers [Jamis Buck]
+
+* Fix cap shell to properly recognize sudo prompt [Mark Imbriaco, barnaby, Jamis Buck]
+
+* Git SCM module [Garry Dolley, Geoffrey Grosenbach, Scott Chacon]
+
+* Use the --password switch for subversion by default, but add :scm_prefer_prompt variable (defaults to false) [Jamis Buck]
+
+
+## 2.0.100 (2.1 Preview 1) / September 1, 2007
+
+* capify-generated Capfile will autoload all recipes from vendor/plugins/*/recipes/*.rb [Graeme Mathieson]
+
+* Use sudo -p switch to set sudo password prompt to something predictable [Mike Bailey]
+
+* Allow independent configurations to require the same recipe file [Jamis Buck]
+
+* Set :shell to false to run a command without wrapping it in "sh -c" [Jamis Buck]
+
+* Don't request a pty by default [Jamis Buck]
+
+* Add a "match" remote dependency method [Adam Greene]
+
+* Allow auth-caching of subversion credentials to be enabled via :scm_auth_cache [tsmith]
+
+* Don't let a task trigger itself when used as the source for an "on" hook [Jamis Buck]
+
+* Avoid using the --password switch with subversion for security purposes [sentinel]
+
+* Add version_dir, current_dir, and shared_dir variables for naming the directories used in deployment [drinkingbird]
+
+* Use Windows-safe binary reads for reading file contents [Ladislav Martincik]
+
+* Add Accurev SCM support [Doug Barth]
+
+* Use the :runner variable to determine who to sudo as for deploy:restart [Graham Ashton]
+
+* Add Namespaces#top to always return a reference to the topmost namespace [Jamis Buck]
+
+* Change the "-h" output so that it does not say that "-q" is the default [Jamis Buck]
+
+
+## 2.0.0 / July 21, 2007
 
 * Make the "no matching servers" error more sane [halorgium]
 
@@ -27,7 +746,7 @@
 * Spelling corrections in docs [Tim Carey-Smith, Giles Bowkett]
 
 
-*1.99.3 (2.0 Preview 4)* June 28, 2007
+## 1.99.3 (2.0 Preview 4) / June 28, 2007
 
 * Don't break task descriptions on a period that appears in the middle of a sentence [Jamis Buck]
 
@@ -60,8 +779,8 @@
 * Make sure symlink and finalize_update tasks reference the most recent release when called by themselves [Jamis Buck]
 
 
-*1.99.2 (2.0 Preview 3)* June 15, 2007
- 
+## 1.99.2 (2.0 Preview 3) / June 15, 2007
+
 * CVS SCM module [Brian Phillips]
 
 * Fix typo in Perforce SCM module [Chris Bailey]
@@ -85,7 +804,7 @@
 * Add :default_environment variable, which is applied to every command
 
 
-*1.99.1 (2.0 Preview 2)* May 10, 2007
+## 1.99.1 (2.0 Preview 2) / May 10, 2007
 
 * Fix some documentation typos [eventualbuddha]
 
@@ -120,7 +839,7 @@
 * Make the copy strategy check out to a temporary directory [Jamis Buck]
 
 
-*1.99.0 (2.0 Preview 1)* April 24, 2007
+## 1.99.0 (2.0 Preview 1) / April 24, 2007
 
 * Add `capify' script to make it easier to prepare a project for deployment using cap [Jamis Buck]
 
@@ -141,7 +860,7 @@
 * Merged the Configuration and Actor classes, performed various other massive refactorings of the code [Jamis Buck]
 
 
-*1.4.1* (February 24, 2007)
+## 1.4.1 / February 24, 2007
 
 * Use the no-auth-cache option with subversion so that username/password tokens do not get cached by capistrano usage [jonathan]
 
@@ -152,7 +871,7 @@
 * Add :env option to 'run' (and friends) so that you can specify environment variables to be injected into the new process' environment [Mathieu Lajugie]
 
 
-*1.4.0* (February 3, 2007)
+## 1.4.0 / February 3, 2007
 
 * Use the auth info for subversion more consistently [Jamis Buck]
 
@@ -179,12 +898,12 @@
 * Fix off-by-one bug in show_tasks width-computation [NeilW]
 
 
-*1.3.1* (January 5, 2007)
+## 1.3.1 / January 5, 2007
 
 * Fix connection problems when using gateways [Ezra Zygmuntowicz]
 
 
-*1.3.0* (December 23, 2006)
+## 1.3.0 / December 23, 2006
 
 * Deprecate rake integration in favor of invoking `cap' directly [Jamis Buck]
 
@@ -215,7 +934,7 @@
 * Added :as option to sudo, so you can specify who the command is executed as [Mark Imbriaco]
 
 
-*1.2.0* (September 14, 2006)
+## 1.2.0 / September 14, 2006
 
 * Add experimental 'shell' task [Jamis Buck]
 
@@ -271,7 +990,7 @@
       on_rollback { run "ln -nfs #{previous_release} #{current_path}" }
       run "ln -nfs #{current_release} #{current_path}"
     end
-    
+
     cap symlink # will not run on 192.168.0.3
 
 * Deprecate the -r/--recipe switch in favor of -f/--file (for more make/rake-like semantics) [Jamis Buck]
@@ -287,7 +1006,7 @@
     task :setup, :roles => [ :app, :web, :db ]
       # normally this would run every where
     end
-    
+
     ROLES=app cap setup # this will only run for the app role, overwritting the default declaration
 
 * Added :hosts option to task definition that allows you to specify cross-cutting tasks [DHH]. Example:
@@ -299,7 +1018,7 @@
 * Fix operator precedence problem in script for touching the revisions.log #3223 [jason.garber@emu.edu]
 
 
-*1.1.0* (March 6th, 2006)
+## 1.1.0 / March 6th, 2006
 
 * Simplify the generated capistrano.rake file, and make it easier to customize
 
@@ -312,12 +1031,12 @@
 * Look for config/deploy.rb, capfile, and Capfile by default
 
 
-*1.0.1* (February 20th, 2006)
+## 1.0.1 / February 20th, 2006
 
 * Fix broken switchtower_invoke function in switchtower.rake (missing require statement)
 
 
-*1.0.0* (Feburary 18th, 2006)
+## 1.0.0 / Feburary 18th, 2006
 
 * Make CVS module's :local value default to "."
 
@@ -366,7 +1085,7 @@
 * Set :actor key on SSH channel instances
 
 
-*0.10.0* (January 2nd, 2006)
+## 0.10.0 / January 2nd, 2006
 
 * Handle ssh password prompts like "someone's password:"
 
@@ -405,7 +1124,7 @@
 * Require Net::SSH 1.0.5
 
 
-*0.9.0* (October 18th, 2005)
+## 0.9.0 / October 18th, 2005
 
 * Use process reaper instead of custom reap script for restarting