From bd69589143371254b6d71aa74b1230144eb30a9c Mon Sep 17 00:00:00 2001 From: wycats Date: Sun, 28 Mar 2010 19:07:50 -0700 Subject: [PATCH] preinitializer.rb is no longer needed, so remove it from the guide and replace with better suggestion. [#4279 state:resolved] --- railties/guides/source/configuring.textile | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/railties/guides/source/configuring.textile b/railties/guides/source/configuring.textile index e35126fc5a15e..55077bcd2437c 100644 --- a/railties/guides/source/configuring.textile +++ b/railties/guides/source/configuring.textile @@ -9,24 +9,24 @@ endprologue. h3. Locations for Initialization Code -Rails offers (at least) five good spots to place initialization code: +Rails offers (at least) four good spots to place initialization code: -* Preinitializers -* environment.rb +* application.rb * Environment-specific Configuration Files * Initializers (load_application_initializers) * After-Initializers -h3. Using a Preinitializer +h3. Running Code Before Rails -Rails allows you to use a preinitializer to run code before the framework itself is loaded. If you save code in +RAILS_ROOT/config/preinitializer.rb+, that code will be the first thing loaded, before any of the framework components (Active Record, Action Pack, and so on.) If you want to change the behavior of one of the classes that is used in the initialization process, you can do so in this file. +To run some code before Rails itself is loaded, simply put it above the call to ++require 'rails/all'+ in your +application.rb+. h3. Configuring Rails Components -In general, the work of configuring Rails means configuring the components of Rails, as well as configuring Rails itself. The +environment.rb+ and environment-specific configuration files (such as +config/environments/production.rb+) allow you to specify the various settings that you want to pass down to all of the components. For example, the default Rails 2.3 +environment.rb+ file includes one setting: +In general, the work of configuring Rails means configuring the components of Rails, as well as configuring Rails itself. The +application.rb+ and environment-specific configuration files (such as +config/environments/production.rb+) allow you to specify the various settings that you want to pass down to all of the components. For example, the default Rails 2.3 +application.rb+ file includes one setting: -config.time_zone = 'UTC' +config.filter_parameters << :password This is a setting for Rails itself. If you want to pass settings to individual Rails components, you can do so via the same +config+ object: @@ -53,8 +53,6 @@ h4. Rails General Configuration * +config.eager_load_paths+ accepts an array of paths from which Rails will eager load on boot if cache classes is enabled. All elements of this array must also be in +load_paths+. -* +config.frameworks+ accepts an array of rails framework components that should be loaded. (Defaults to +:active_record+, +:action_controller+, +:action_view+, +:action_mailer+, and +:active_resource+). - * +config.load_once_paths+ accepts an array of paths from which Rails will automatically load from only once. All elements of this array must also be in +load_paths+. * +config.load_paths+ accepts an array of additional paths to prepend to the load path. By default, all app, lib, vendor and mock paths are included in this list.