doc: clarify the intent of `unicorn_rails`

1 files changed, 6 insertions, 1 deletions

diff --git a/Documentation/unicorn_rails.1.txt b/Documentation/unicorn_rails.1.txt
index d2d8190..267e425 100644
--- a/Documentation/unicorn_rails.1.txt
+++ b/Documentation/unicorn_rails.1.txt
@@ -4,7 +4,7 @@
 
 # NAME
 
-unicorn_rails - a rackup-like command to launch the Unicorn HTTP server
+unicorn_rails - a script/server-like command to launch the Unicorn HTTP server
 
 # SYNOPSIS
 
@@ -16,6 +16,11 @@ A rackup(1)-like command to launch Rails applications using Unicorn.  It
 is expected to be started in your Rails application root (RAILS_ROOT),
 but the "working_directory" directive may be used in the CONFIG_FILE.
 
+It is designed to help Rails 1.x and 2.y users transition to Rack, but
+it is NOT needed for Rails 3 applications.  Rails 3 users are encouraged
+to use unicorn(1) instead of unicorn_rails(1).  Users of Rails 1.x/2.y
+may also use unicorn(1) instead of unicorn_rails(1).
+
 The outward interface resembles rackup(1), the internals and default
 middleware loading is designed like the `script/server` command
 distributed with Rails.