colouringcode-passenger 0.1

data/DEVELOPERS.TXT

@@ -0,0 +1,101 @@
+= Developers information
+
+== Required software
+
+The tests need the following software installed:
+
+* All the usual Phusion Passenger dependencies.
+* Ruby on Rails 2.0.1 (*exactly* 2.0.1)
+* rspec >= 1.1.2
+* mime-types >= 1.15
+* daemon_controller (only for running the Nginx integration test). Install
+  with: gem install FooBarWidget-daemon_controller -s http://gems.github.com
+
+The following software is optional:
+
+* RCov, for code coverage
+* RDoc, for generating HTML Ruby API documentation
+* Doxygen, for generating HTML C++ API documentation
+* dot (part of Graphviz), for generating diagrams in HTML API documentation
+* The font "Bitstream Vera Sans", used in the class diagrams. See http://www.gnome.org/fonts
+* AsciiDoc >= 8.2.5, for converting various doc/*.txt documents to HTML
+
+== Compiling Phusion Passenger
+
+Run the following command to compile everything:
+
+ rake
+
+== Directory structure
+
+The most important directories are:
+[ lib/phusion_passenger ]
+  The source code for the spawn server, which is written in Ruby.
+[ ext/phusion_passenger ]
+  Native extensions for Ruby, used by the spawn server.
+[ ext/apache2 ]
+  Apache 2-specific source code.
+[ ext/nginx ]
+  Nginx-specific source code.
+[ ext/common ]
+  Source code shared by the Apache and Nginx modules.
+[ bin ]
+  Executables.
+[ doc ]
+  Various documentation.
+[ test ]
+  Unit tests and integration tests.
+[ test/support ]
+  Support/utility code, used in the tests.
+[ test/stub ]
+  Stub code, used in the tests.
+
+Less important directories:
+[ ext/boost ]
+  A stripped-down and customized version of the Boost C++ library
+  (www.boost.org).
+[ ext/oxt ]
+  The "OS eXtensions for boosT" library, which provides various important
+  functionality necessary for writing robust server software. It provides
+  things like support for interruptable system calls and portable backtraces
+  for C++. Boost was modified to make use of the functionality provided by OXT.
+[ benchmark ]
+  Benchmark tools.
+[ debian ]
+  Debian packaging files.
+[ man ]
+  Man pages.
+[ misc ]
+  Miscellaneous tools.
+[ misc/rake ]
+  Rake tasks.
+[ vendor ]
+  Various vendored libraries.
+
+== Tests
+
+Run all tests:
+
+ rake
+
+Run just the tests for the Apache 2 module:
+
+ rake test:apache2
+
+Run just the unit tests for the Ruby spawn server:
+
+ rake test:ruby
+
+Run just the integration tests:
+
+ rake test:integration
+
+*Note*: some tests, such as the ones that test privilege lowering, require
+root privileges. Those will only be run if Rake is run as root.
+
+== Documentation
+
+Various developer documents can be found in 'doc/*.html'.
+
+The Ruby part's API reference is located in 'doc/rdoc/'.
+The C++ part's API reference is located in 'doc/cxxapi/'.

data/INSTALL

@@ -0,0 +1,6 @@
+Please read the file README for installation instructions.
+
+If you're having trouble installing Phusion Passenger, please
+read the file 'doc/Users guide Apache.html' or 'doc/Users guide Nginx.html',
+depending on whether you want to install Phusion Passenger for Apache or for
+Nginx.

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2008, 2009 Phusion
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/NEWS

@@ -0,0 +1,174 @@
+Release 2.2.7
+-------------
+
+ * Removed forgotten debugging code in passenger-install-apache2-module,
+   which caused it not to compile anything.
+
+
+Release 2.2.6
+-------------
+
+ * Some /tmp cleaner programs such as tmpwatch try to remove subdirectories
+   in /tmp/passenger.xxx after a while because they think those
+   subdirectories are unused. This could cause Phusion Passenger to
+   malfunction, requiring a web server restart. Measures have now been
+   taken to prevent those tmp cleaner programs from removing anything
+   in /tmp/passenger.xxx. Issue #365.
+ * When autodetecting the application type, Rack is now given more priority
+   than Rails. This allows one to drop a config.ru file in a Rails directory
+   and have it detected as a Rack application instead of a Rails application.
+   Patch contributed by Sam Pohlenz: issue #338.
+ * The default socket backlog has been increased from 'SOMAXCONN' (which
+   is 128 on most platforms) to 1024. This should fix most
+   'helper_server.sock failed: Resource temporarily unavailable'
+   errors.
+ * Fixed compilation problems on Solaris. Issue #369 and issue #379.
+ * Fixed crashes on PowerPC.
+ * Some Ruby 1.9 compatibility fixes. Issue #398.
+ * The installer now displays correct dependency installation instructions
+   for Mandriva Linux.
+ * [Apache] The location of the 'apxs' and 'apr-config' commands can now
+   also be passed to the installer through the --apxs-path and
+   --apr-config-path parameters, in addition to the $APXS2 and $APR_CONFIG
+   environment variables. Issue #3.
+ * [Nginx] Various problems that only occur on 64-bit platforms have been fixed.
+ * [Nginx] The installer now installs Nginx 0.7.64 by default.
+
+
+Release 2.2.5
+-------------
+
+ * [Apache] Small file uploads are now buffered; fixes potential DoS attack
+   Phusion Passenger buffers large file uploads to temp files so that it
+   doesn't block applications while an upload is in progress, but it sent
+   small uploads directly to the application without buffering it. This could
+   result in a potential DoS attack: the client can send many small, incomplete
+   file uploads to the server, and this would block all application processes
+   until a timeout occurs. In order to solve this problem, Phusion Passenger
+   now buffers small file uploads in memory. Bug #356.
+
+ * [Apache] Fixed support for mod_rewrite passthrough rules
+   Mod_rewrite passthrough rules were not properly supported because of a bug
+   fix for supporting encoded slashes (%2f) in URLs. Unfortunately, due to
+   bugs/limitations in Apache, we can support either encoded slashes or
+   mod_rewrite passthrough rules, but not both; supporting one will break the
+   other.
+
+   Support for mod_rewrite passthrough rules is now enabled by default; that
+   is, support for encoded slashes is disabled by default. A new configuration
+   option, "PassengerAllowEncodedSlashes", has been added. Turning this option
+   on will enable support for encoded slashes and disable support for
+   mod_rewrite passthrough rules.
+
+   Issue #113 and issue #230.
+
+ * [Apache] Added a configuration option for resolving symlinks in the document root path
+   Phusion Passenger 2.2.0 and higher no longer resolves symlinks in
+   the document root path in order to properly support Capistrano-style
+   directory structures. The exact behavior is documented in the Users Guide,
+   section "How Phusion Passenger detects whether a virtual host is a web
+   application".
+
+   However, some people relied on the old behavior. A new configuration option,
+   PassengerResolveSymlinksInDocumentRoot, has been added to allow reverting
+   back to the old behavior.
+
+   Patch contributed by Locaweb (http://www.locaweb.com.br/).
+
+ * [Apache] mod_env variables are now also passed through CGI environment headers
+   Prior to version 2.2.3, environment variables set by mod_env are passed to
+   the application as CGI environment headers, not through Ruby's ENV variable.
+   In the last release we introduced support for setting ENV environment
+   variables with mod_env, and got rid of the code for setting CGI environment
+   headers. It turns out that some people relied on the old behavior, we so now
+   environment variables set with mod_env are set in both ENV and in the CGI
+   environment.
+   
+   Fixes bug #335.
+
+ * [Apache] Fixed compilation problems on some Linux systems with older versions of Apache
+   If you used to see compilation errors like this:
+
+       ext/apache2/Configuration.cpp:554: error: expected primary-expression before '.' token
+
+   then this version should compile properly.
+
+ * [Apache] Fixed I/O timeouts for communication with backend processes
+   Got rid of the code for enforcing I/O timeouts when reading from or writing to
+   a backend process. This caused more problems than it solved.
+
+ * [Nginx] Support for streaming responses (e.g. Comet or HTTP push)
+   Buffering of backend responses is now disabled. This fixes support for
+   streaming responses, something which the Apache version has supported
+   for a while now. One can generate streaming responses in Ruby on Rails
+   like this:
+
+       render :text => lambda { |response, output|
+           10_000.times do |i|
+               output.write("hello #{i}!\n")
+           end
+       }
+
+ * [Nginx] Installer now installs Nginx 0.7.61 by default
+   Previously it installed 0.6.37 by default.
+
+ * [Nginx] Fixed the installer's --extra-configure-flags flag when combined with --auto-download
+   Arguments passed to --extra-configure-flags were not being passed to the
+   Nginx configure script when --auto-download is given. This has been
+   fixed: bug #349.
+
+ * [Nginx] Fixed unnecessary download of PCRE
+   The installer now checks whether PCRE is installed in /opt/local (e.g.
+   MacPorts) as well before concluding that it isn't installed and going ahead
+   with downloading PCRE.
+
+ * Fixed STDERR capturing
+   While spawning an application, Phusion Passenger captures any output written
+   to STDERR so that it can show them later if the application failed to start.
+   This turns out to be much more difficult than expected, with all kinds of
+   corner cases that can mess up this feature.
+
+   For example, if the Rails log file is not writable, then this can cause
+   Rails to crash with a bizarre and unhelpful error message whenever it tries
+   to write to STDERR:
+
+       /!\ FAILSAFE /!\  Thu Aug 20 14:58:39 +1000 2009
+       Status: 500 Internal Server Error
+       undefined method `[]' for nil:NilClass
+
+   Some applications reopen STDERR to a log file. This didn't work.
+
+   Of all of these problems have been fixed now. (Bug #332)
+
+ * Fixed some bugs in application sources preloading
+   Rails >= 2.2 already preloads the application sources, in which case Phusion
+   Passenger wasn't supposed to perform it's own preloading, but the Rails
+   >= 2.2 detection code was bugged. This has been fixed.
+
+   Rails < 2.2 doesn't preload the application sources by itself, but there
+   should be a certain order with which the sources are preloaded, otherwise
+   preloading could fail in some applications. We now enforce a specific load
+   order: first models, then controllers, then helpers.
+
+   Bug #359.
+ 
+ * Fixed a few bugs in WSGI compliance
+   PATH_INFO is supposed to be set to the request URI, but without the query
+   string and without the base URI. This has been fixed: bug #360.
+
+ * Fixed some Ruby 1.9-specific crashes caused by encoding issues. Bug #354.
+ * Fixed loading of config/environment.rb on Ruby 1.9.2, because Ruby 1.9.2
+   no longer has "." in the default load path. Patch by metaljastix, issue #368.
+ * The Users Guide for Apache now mentions something about correct permissions
+   for application directories.
+ * Fixed compilation problems on IA-64 (bug #118). We also reduced the stack
+   sizes for the threads by half, so Phusion Passenger should use even less
+   virtual memory now.
+ * Fixed compilation problems on Linux systems with ARM CPU.
+ * Fixed a few compatibility problems with 64-bit OpenBSD.
+ * Fixed a few typos and minor bugs.
+
+
+Older releases
+--------------
+Please consult the blog posts on http://blog.phusion.nl/ for the information about older releases.

data/README

@@ -0,0 +1,59 @@
+== Introduction
+
+This is a fork of the popular Phusion Passenger Apache module / Nginx Module for Ruby On Rails application deployment
+
+== Installation
+
+=== Regular installation
+
+You can install either Colouring Code Phusion Passenger for Apache or for Nginx. Run either of
+the following programs as root:
+
+./bin/passenger-install-apache2-module
+
+-OR-
+
+./bin/passenger-install-nginx-module
+
+That's it. :)
+
+For troubleshooting, configuration and tips, please read the corresponding
+Users Guide:
+
+doc/Users guide Apache.html
+doc/Users guide Nginx.html
+
+These files are included in the source tarball, and may also be viewed online on
+our website.
+
+=== Installing via a gem
+
+You may also first generate a .gem file, and then install that.
+First, make sure that you have the following software installed:
+- Doxygen: http://www.stack.nl/~dimitri/doxygen/
+- Asciidoc: http://www.methods.co.nz/asciidoc/
+
+Next, run:
+
+rake package
+
+The gem will be available under the 'pkg' folder.
+
+== Custom Templates
+
+Colouring Code have modified Passenger to show custom error templates when there is an error.
+This is to save guard yourself and not show anyone the error stack trace.
+
+=== Rails Generator
+
+We have included a handy rails generator to generate all of the templates for you to start off with.
+
+script/generate passenger_templates
+
+The templates will then be available in:
+
+RAILS_ROOT/lib/passenger/
+
+== Legal
+
+Phusion Passenger is a trademark of Hongli Lai & Ninh Bui.