diff options
author | José Valim <jose.valim@gmail.com> | 2010-06-20 13:03:08 +0200 |
---|---|---|
committer | José Valim <jose.valim@gmail.com> | 2010-06-20 13:03:08 +0200 |
commit | 9e081caee74e6d08035a8835899dcc566536a871 (patch) | |
tree | 77649ff1acd14f3edcb2c10b2407f4b3f293810e | |
parent | 5522578d1631abf1851ed6ff3079ffae3a289b53 (diff) | |
download | rails-9e081caee74e6d08035a8835899dcc566536a871.tar.gz rails-9e081caee74e6d08035a8835899dcc566536a871.tar.bz2 rails-9e081caee74e6d08035a8835899dcc566536a871.zip |
Improve documentation for add_lib_to_load_paths!
-rw-r--r-- | railties/lib/rails/application.rb | 19 |
1 files changed, 16 insertions, 3 deletions
diff --git a/railties/lib/rails/application.rb b/railties/lib/rails/application.rb index 85ae8cbbb1..b410639272 100644 --- a/railties/lib/rails/application.rb +++ b/railties/lib/rails/application.rb @@ -84,17 +84,30 @@ module Rails delegate :middleware, :to => :config - def add_lib_to_load_paths! + # This method is called just after an application inherits from Rails::Application, + # allowing the developer to load classes in lib and use them during application + # configuration. + # + # class MyApplication < Rails::Application + # require "my_backend" # in lib/my_backend + # config.i18n.backend = MyBackend + # end + # + # Notice this method takes into consideration the default root path. So if you + # are changing config.root inside your application definition or having a custom + # Rails application, you will need to add lib to $LOAD_PATH on your own in case + # you need to load files in lib/ during the application configuration as well. + def add_lib_to_load_paths! #:nodoc: path = config.root.join('lib').to_s $LOAD_PATH.unshift(path) if File.exists?(path) end - def require_environment! + def require_environment! #:nodoc: environment = paths.config.environment.to_a.first require environment if environment end - def eager_load! + def eager_load! #:nodoc: railties.all(&:eager_load!) super end |