From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: X-Spam-Status: No, score=-4.0 required=3.0 tests=ALL_TRUSTED,BAYES_00 shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id 4E15320248; Mon, 15 Apr 2019 06:52:27 +0000 (UTC) Date: Mon, 15 Apr 2019 06:52:27 +0000 From: Eric Wong To: unicorn-public@bogomips.org Subject: [RFC] doc: unicorn_rails: clarify that it is intended for rails <= 2.x Message-ID: <20190415065227.ru6ulyz35v5ynvzd@dcvr> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline List-Id: Hopefully the wording is a little more explicit and clearer by stating its purpose in the first line of the description. --- Grammar/wording awkwardness review/comments greatly appreciated, haven't used English or Ruby much, lately. Documentation/unicorn_rails.1.txt | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/Documentation/unicorn_rails.1.txt b/Documentation/unicorn_rails.1.txt index fb0e60f..0ce9bcf 100644 --- a/Documentation/unicorn_rails.1.txt +++ b/Documentation/unicorn_rails.1.txt @@ -12,14 +12,12 @@ unicorn_rails [-c CONFIG_FILE] [-E RAILS_ENV] [-D] [RACKUP_FILE] # DESCRIPTION -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. +A rackup(1)-like command to launch ancient Rails (2.x and earlier) +applications using Unicorn. Rails 3 (and later) support Rack natively, +so users are encouraged to use unicorn(1) instead of unicorn_rails(1). -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). +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. The outward interface resembles rackup(1), the internals and default middleware loading is designed like the `script/server` command -- EW