Froze rails gems
[depot.git] / vendor / rails / railties / doc / guides / html / configuring.html
diff --git a/vendor/rails/railties/doc/guides/html/configuring.html b/vendor/rails/railties/doc/guides/html/configuring.html
new file mode 100644 (file)
index 0000000..4aa3a0f
--- /dev/null
@@ -0,0 +1,438 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+       <title>Configuring Rails Applications</title>
+       <!--[if lt IE 8]>
+       <script src="http://ie7-js.googlecode.com/svn/version/2.0(beta3)/IE8.js" type="text/javascript"></script>
+       <![endif]-->
+       <link href="stylesheets/base.css" media="screen" rel="Stylesheet" type="text/css" />
+       <link href="stylesheets/forms.css" media="screen" rel="Stylesheet" type="text/css" />
+       <link href="stylesheets/more.css" media="screen" rel="Stylesheet" type="text/css" />
+       <style type="text/css">
+               div#container {
+       max-width: 900px;
+       padding-bottom: 3em;
+}
+
+div#content {
+       margin-left: 200px;
+}
+
+div#container.notoc {
+       max-width: 600px;
+}
+
+.notoc div#content {
+       margin-left: 0;
+}
+
+pre {
+       line-height: 1.4em;
+}
+
+#content p tt {
+       background: #eeeeee;
+       border: solid 1px #cccccc;
+       padding: 3px;
+}
+
+dt {
+       font-weight: bold;
+}
+
+#content dt tt {
+       font-size: 10pt;
+}
+
+dd {
+       margin-left: 3em;
+}
+
+#content dt tt, #content pre tt {
+       background: none;
+       padding: 0;
+       border: 0;
+}
+
+#content .olist ol {
+       margin-left: 2em;
+}
+
+#header {
+       position: relative;
+       max-width: 840px;
+       margin-left: auto;
+       margin-right: auto;
+}
+
+#header.notoc {
+       max-width: 580px;
+}
+
+#logo {
+       position: absolute;
+       left: 10px;
+       top: 10px;
+       width: 110px;
+       height: 140px;
+}
+
+div#header h1#site_title {
+       background: url('images/ruby_on_rails_by_mike_rundle2.gif') top left no-repeat;
+       position: absolute;
+       width: 392px;
+       height: 55px;
+       left: 145px;
+       top: 20px;
+       margin: 0;
+       padding: 0;
+}
+
+#site_title span {
+       display: none;
+}
+
+#site_title_tagline {
+       display: none;
+}
+
+ul#navMain {
+       position: absolute;
+       margin: 0;
+       padding: 0;
+       top: 97px;
+       left: 145px;
+}
+
+.left-floaty, .right-floaty {
+       padding: 15px;
+}
+
+.admonitionblock,
+.tableblock {
+       margin-left: 1em;
+       margin-right: 1em;
+       margin-top: 0.25em;
+       margin-bottom: 1em;
+}
+
+.admonitionblock .icon {
+       padding-right: 8px;
+}
+
+.admonitionblock .content {
+       border: solid 1px #ffda78;
+       background: #fffebd;
+       padding: 10px;
+       padding-top: 8px;
+       padding-bottom: 8px;
+}
+
+.admonitionblock .title {
+       font-size: 140%;
+       margin-bottom: 0.5em;
+}
+
+.tableblock table {
+       border: solid 1px #aaaaff;
+       background: #f0f0ff;
+}
+
+.tableblock th {
+       background: #e0e0e0;
+}
+
+.tableblock th,
+.tableblock td {
+       padding: 3px;
+       padding-left: 5px;
+       padding-right: 5px;
+}
+
+.sidebarblock {
+       margin-top: 0.25em;
+       margin: 1em;
+       border: solid 1px #ccccbb;
+       padding: 8px;
+       background: #ffffe0;
+}
+
+.sidebarblock .sidebar-title {
+       font-size: 140%;
+       font-weight: 600;
+       margin-bottom: 0.3em;
+}
+
+.sidebarblock .sidebar-content > .para:last-child > p {
+       margin-bottom: 0;
+}
+
+.sidebarblock .sidebar-title a {
+       text-decoration: none;
+}
+
+.sidebarblock .sidebar-title a:hover {
+       text-decoration: underline;
+}
+
+       </style>
+</head>
+<body>
+       <div id="header" >
+               <div id="logo">
+                       <a href="index.html" title="Ruby on Rails"><img src="images/rails_logo_remix.gif" alt="Rails" height="140" width="110" /></a>
+               </div>
+               
+               <h1 id="site_title"><span>Ruby on Rails</span></h1>
+               <h2 id="site_title_tagline">Sustainable productivity for web-application development</h2>
+
+               <ul id="navMain">
+                       <li class="first-child"><a href="http://www.rubyonrails.org/" title="Ruby on Rails" class="ruby_on_rails">Ruby on Rails</a></li>
+                       <li><a class="manuals" href="index.html" title="Manuals Index">Guides Index</a></li>
+               </ul>
+       </div>
+
+       <div id="container">
+               
+               <div id="sidebar">
+                       <h2>Chapters</h2>
+                       <ol>
+                                       <li>
+                                       <a href="#_locations_for_initialization_code">Locations for Initialization Code</a>
+                                       </li>
+                                       <li>
+                                       <a href="#_using_a_preinitializer">Using a Preinitializer</a>
+                                       </li>
+                                       <li>
+                                       <a href="#_configuring_rails_components">Configuring Rails Components</a>
+                                               <ul>
+                                               
+                                                       <li><a href="#_configuring_active_record">Configuring Active Record</a></li>
+                                               
+                                                       <li><a href="#_configuring_action_controller">Configuring Action Controller</a></li>
+                                               
+                                                       <li><a href="#_configuring_action_view">Configuring Action View</a></li>
+                                               
+                                                       <li><a href="#_configuring_action_mailer">Configuring Action Mailer</a></li>
+                                               
+                                                       <li><a href="#_configuring_active_resource">Configuring Active Resource</a></li>
+                                               
+                                                       <li><a href="#_configuring_active_support">Configuring Active Support</a></li>
+                                               
+                                               </ul>
+                                       </li>
+                                       <li>
+                                       <a href="#_using_initializers">Using Initializers</a>
+                                       </li>
+                                       <li>
+                                       <a href="#_using_an_after_initializer">Using an After-Initializer</a>
+                                       </li>
+                                       <li>
+                                       <a href="#_changelog">Changelog</a>
+                                       </li>
+                       </ol>
+               </div>
+               
+               <div id="content">
+                               <h1>Configuring Rails Applications</h1>
+                       <div id="preamble">\r
+<div class="sectionbody">\r
+<div class="para"><p>This guide covers the configuration and initialization features available to Rails applications. By referring to this guide, you will be able to:</p></div>\r
+<div class="ilist"><ul>\r
+<li>\r
+<p>\r
+Adjust the behavior of your Rails applications\r
+</p>\r
+</li>\r
+<li>\r
+<p>\r
+Add additional code to be run at application start time\r
+</p>\r
+</li>\r
+</ul></div>\r
+</div>\r
+</div>\r
+<h2 id="_locations_for_initialization_code">1. Locations for Initialization Code</h2>\r
+<div class="sectionbody">\r
+<div class="para"><p>preinitializers\r
+environment.rb first\r
+env-specific files\r
+initializers (load_application_initializers)\r
+after-initializer</p></div>\r
+</div>\r
+<h2 id="_using_a_preinitializer">2. Using a Preinitializer</h2>\r
+<div class="sectionbody">\r
+</div>\r
+<h2 id="_configuring_rails_components">3. Configuring Rails Components</h2>\r
+<div class="sectionbody">\r
+<h3 id="_configuring_active_record">3.1. Configuring Active Record</h3>\r
+<h3 id="_configuring_action_controller">3.2. Configuring Action Controller</h3>\r
+<h3 id="_configuring_action_view">3.3. Configuring Action View</h3>\r
+<h3 id="_configuring_action_mailer">3.4. Configuring Action Mailer</h3>\r
+<h3 id="_configuring_active_resource">3.5. Configuring Active Resource</h3>\r
+<h3 id="_configuring_active_support">3.6. Configuring Active Support</h3>\r
+</div>\r
+<h2 id="_using_initializers">4. Using Initializers</h2>\r
+<div class="sectionbody">\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><tt>organization, controlling load order</tt></pre>\r
+</div></div>\r
+</div>\r
+<h2 id="_using_an_after_initializer">5. Using an After-Initializer</h2>\r
+<div class="sectionbody">\r
+</div>\r
+<h2 id="_changelog">6. Changelog</h2>\r
+<div class="sectionbody">\r
+<div class="para"><p><a href="http://rails.lighthouseapp.com/projects/16213-rails-guides/tickets/28">Lighthouse ticket</a></p></div>\r
+<div class="ilist"><ul>\r
+<li>\r
+<p>\r
+November 5, 2008: Rough outline by <a href="../authors.html#mgunderloy">Mike Gunderloy</a>\r
+</p>\r
+</li>\r
+</ul></div>\r
+<div class="para"><p>actionmailer/lib/action_mailer/base.rb\r
+257:    cattr_accessor :logger\r
+267:    cattr_accessor :smtp_settings\r
+273:    cattr_accessor :sendmail_settings\r
+276:    cattr_accessor :raise_delivery_errors\r
+282:    cattr_accessor :perform_deliveries\r
+285:    cattr_accessor :deliveries\r
+288:    cattr_accessor :default_charset\r
+291:    cattr_accessor :default_content_type\r
+294:    cattr_accessor :default_mime_version\r
+297:    cattr_accessor :default_implicit_parts_order\r
+299:    cattr_reader :protected_instance_variables</p></div>\r
+<div class="para"><p>actionmailer/Rakefile\r
+36:  rdoc.options &lt;&lt; <em>&#8212;line-numbers</em> &lt;&lt; <em>&#8212;inline-source</em> &lt;&lt; <em>-A cattr_accessor=object</em></p></div>\r
+<div class="para"><p>actionpack/lib/action_controller/base.rb\r
+263:    cattr_reader :protected_instance_variables\r
+273:    cattr_accessor :asset_host\r
+279:    cattr_accessor :consider_all_requests_local\r
+285:    cattr_accessor :allow_concurrency\r
+317:    cattr_accessor :param_parsers\r
+321:    cattr_accessor :default_charset\r
+325:    cattr_accessor :logger\r
+329:    cattr_accessor :resource_action_separator\r
+333:    cattr_accessor :resources_path_names\r
+337:    cattr_accessor :request_forgery_protection_token\r
+341:    cattr_accessor :optimise_named_routes\r
+351:    cattr_accessor :use_accept_header\r
+361:    cattr_accessor :relative_url_root</p></div>\r
+<div class="para"><p>actionpack/lib/action_controller/caching/pages.rb\r
+55:          cattr_accessor :page_cache_directory\r
+58:          cattr_accessor :page_cache_extension</p></div>\r
+<div class="para"><p>actionpack/lib/action_controller/caching.rb\r
+37:        cattr_reader :cache_store\r
+48:        cattr_accessor :perform_caching</p></div>\r
+<div class="para"><p>actionpack/lib/action_controller/dispatcher.rb\r
+98:    cattr_accessor :error_file_path</p></div>\r
+<div class="para"><p>actionpack/lib/action_controller/mime_type.rb\r
+24:    cattr_reader :html_types, :unverifiable_types</p></div>\r
+<div class="para"><p>actionpack/lib/action_controller/rescue.rb\r
+36:      base.cattr_accessor :rescue_responses\r
+40:      base.cattr_accessor :rescue_templates</p></div>\r
+<div class="para"><p>actionpack/lib/action_controller/session/active_record_store.rb\r
+60:        cattr_accessor :data_column_name\r
+170:        cattr_accessor :connection\r
+173:        cattr_accessor :table_name\r
+177:        cattr_accessor :session_id_column\r
+181:        cattr_accessor :data_column\r
+282:      cattr_accessor :session_class</p></div>\r
+<div class="para"><p>actionpack/lib/action_controller/vendor/html-scanner/html/sanitizer.rb\r
+44:    cattr_accessor :included_tags, :instance_writer &#8658; false</p></div>\r
+<div class="para"><p>actionpack/lib/action_view/base.rb\r
+189:    cattr_accessor :debug_rjs\r
+193:    cattr_accessor :warn_cache_misses</p></div>\r
+<div class="para"><p>actionpack/lib/action_view/helpers/active_record_helper.rb\r
+7:    cattr_accessor :field_error_proc</p></div>\r
+<div class="para"><p>actionpack/lib/action_view/helpers/form_helper.rb\r
+805:    cattr_accessor :default_form_builder</p></div>\r
+<div class="para"><p>actionpack/lib/action_view/template_handlers/erb.rb\r
+47:      cattr_accessor :erb_trim_mode</p></div>\r
+<div class="para"><p>actionpack/test/active_record_unit.rb\r
+5:  cattr_accessor :able_to_connect\r
+6:  cattr_accessor :connected</p></div>\r
+<div class="para"><p>actionpack/test/controller/filters_test.rb\r
+286:    cattr_accessor :execution_log</p></div>\r
+<div class="para"><p>actionpack/test/template/form_options_helper_test.rb\r
+3:TZInfo::Timezone.cattr_reader :loaded_zones</p></div>\r
+<div class="para"><p>activemodel/lib/active_model/errors.rb\r
+28:    cattr_accessor :default_error_messages</p></div>\r
+<div class="para"><p>activemodel/Rakefile\r
+19:  rdoc.options &lt;&lt; <em>&#8212;line-numbers</em> &lt;&lt; <em>&#8212;inline-source</em> &lt;&lt; <em>-A cattr_accessor=object</em></p></div>\r
+<div class="para"><p>activerecord/lib/active_record/attribute_methods.rb\r
+9:      base.cattr_accessor :attribute_types_cached_by_default, :instance_writer &#8658; false\r
+11:      base.cattr_accessor :time_zone_aware_attributes, :instance_writer &#8658; false</p></div>\r
+<div class="para"><p>activerecord/lib/active_record/base.rb\r
+394:    cattr_accessor :logger, :instance_writer &#8658; false\r
+443:    cattr_accessor :configurations, :instance_writer &#8658; false\r
+450:    cattr_accessor :primary_key_prefix_type, :instance_writer &#8658; false\r
+456:    cattr_accessor :table_name_prefix, :instance_writer &#8658; false\r
+461:    cattr_accessor :table_name_suffix, :instance_writer &#8658; false\r
+467:    cattr_accessor :pluralize_table_names, :instance_writer &#8658; false\r
+473:    cattr_accessor :colorize_logging, :instance_writer &#8658; false\r
+478:    cattr_accessor :default_timezone, :instance_writer &#8658; false\r
+487:    cattr_accessor :schema_format , :instance_writer &#8658; false\r
+491:    cattr_accessor :timestamped_migrations , :instance_writer &#8658; false</p></div>\r
+<div class="para"><p>activerecord/lib/active_record/connection_adapters/abstract/connection_specification.rb\r
+11:    cattr_accessor :connection_handler, :instance_writer &#8658; false</p></div>\r
+<div class="para"><p>activerecord/lib/active_record/connection_adapters/mysql_adapter.rb\r
+166:      cattr_accessor :emulate_booleans</p></div>\r
+<div class="para"><p>activerecord/lib/active_record/fixtures.rb\r
+498:  cattr_accessor :all_loaded_fixtures</p></div>\r
+<div class="para"><p>activerecord/lib/active_record/locking/optimistic.rb\r
+38:        base.cattr_accessor :lock_optimistically, :instance_writer &#8658; false</p></div>\r
+<div class="para"><p>activerecord/lib/active_record/migration.rb\r
+259:    cattr_accessor :verbose</p></div>\r
+<div class="para"><p>activerecord/lib/active_record/schema_dumper.rb\r
+13:    cattr_accessor :ignore_tables</p></div>\r
+<div class="para"><p>activerecord/lib/active_record/serializers/json_serializer.rb\r
+4:      base.cattr_accessor :include_root_in_json, :instance_writer &#8658; false</p></div>\r
+<div class="para"><p>activerecord/Rakefile\r
+142:  rdoc.options &lt;&lt; <em>&#8212;line-numbers</em> &lt;&lt; <em>&#8212;inline-source</em> &lt;&lt; <em>-A cattr_accessor=object</em></p></div>\r
+<div class="para"><p>activerecord/test/cases/lifecycle_test.rb\r
+61:  cattr_reader :last_inherited</p></div>\r
+<div class="para"><p>activerecord/test/cases/mixin_test.rb\r
+9:  cattr_accessor :forced_now_time</p></div>\r
+<div class="para"><p>activeresource/lib/active_resource/base.rb\r
+206:    cattr_accessor :logger</p></div>\r
+<div class="para"><p>activeresource/Rakefile\r
+43:  rdoc.options &lt;&lt; <em>&#8212;line-numbers</em> &lt;&lt; <em>&#8212;inline-source</em> &lt;&lt; <em>-A cattr_accessor=object</em></p></div>\r
+<div class="para"><p>activesupport/lib/active_support/buffered_logger.rb\r
+17:    cattr_accessor :silencer</p></div>\r
+<div class="para"><p>activesupport/lib/active_support/cache.rb\r
+81:      cattr_accessor :logger</p></div>\r
+<div class="para"><p>activesupport/lib/active_support/core_ext/class/attribute_accessors.rb\r
+5:#    cattr_accessor :hair_colors\r
+10:  def cattr_reader(*syms)\r
+29:  def cattr_writer(*syms)\r
+50:  def cattr_accessor(*syms)\r
+51:    cattr_reader(*syms)\r
+52:    cattr_writer(*syms)</p></div>\r
+<div class="para"><p>activesupport/lib/active_support/core_ext/logger.rb\r
+34:  cattr_accessor :silencer</p></div>\r
+<div class="para"><p>activesupport/test/core_ext/class/attribute_accessor_test.rb\r
+6:      cattr_accessor :foo\r
+7:      cattr_accessor :bar, :instance_writer &#8658; false</p></div>\r
+<div class="para"><p>activesupport/test/core_ext/module/synchronization_test.rb\r
+6:    @target.cattr_accessor :mutex, :instance_writer &#8658; false</p></div>\r
+<div class="para"><p>railties/doc/guides/html/creating_plugins.html\r
+786:      cattr_accessor &lt;span style="color: #990000"&gt;:&lt;/span&gt;yaffle_text_field&lt;span style="color: #990000"&gt;,&lt;/span&gt; &lt;span style="color: #990000"&gt;:&lt;/span&gt;yaffle_date_field\r
+860:      cattr_accessor &lt;span style="color: #990000"&gt;:&lt;/span&gt;yaffle_text_field&lt;span style="color: #990000"&gt;,&lt;/span&gt; &lt;span style="color: #990000"&gt;:&lt;/span&gt;yaffle_date_field</p></div>\r
+<div class="para"><p>railties/lib/rails_generator/base.rb\r
+93:      cattr_accessor :logger</p></div>\r
+<div class="para"><p>railties/Rakefile\r
+265:  rdoc.options &lt;&lt; <em>&#8212;line-numbers</em> &lt;&lt; <em>&#8212;inline-source</em> &lt;&lt; <em>&#8212;accessor</em> &lt;&lt; <em>cattr_accessor=object</em></p></div>\r
+<div class="para"><p>railties/test/rails_info_controller_test.rb\r
+12:    cattr_accessor :local_request</p></div>\r
+<div class="para"><p>Rakefile\r
+32:  rdoc.options &lt;&lt; <em>-A cattr_accessor=object</em></p></div>\r
+</div>\r
+
+               </div>
+       </div>
+</body>
+</html>