Skip to content

Commit

Permalink
solves everything in guides raised by WARNINGS=1 (except for one whic…
Browse files Browse the repository at this point in the history
…h is abandoned atm)
  • Loading branch information
fxn committed Aug 27, 2010
1 parent df367ad commit 3b62667
Show file tree
Hide file tree
Showing 3 changed files with 17 additions and 36 deletions.
3 changes: 2 additions & 1 deletion railties/guides/rails_guides/generator.rb
Expand Up @@ -237,8 +237,9 @@ def extract_anchors(html)
end
end

# Also, footnotes are rendered as paragraphs this way.
# Footnotes.
anchors += Set.new(html.scan(/<p\s+class="footnote"\s+id="([^"]+)/).flatten)
anchors += Set.new(html.scan(/<sup\s+class="footnote"\s+id="([^"]+)/).flatten)
return anchors
end

Expand Down
30 changes: 5 additions & 25 deletions railties/guides/source/active_support_core_extensions.textile
Expand Up @@ -1685,27 +1685,7 @@ foreign_key = options[:foreign_key] || reflection.active_record.name.foreign_key

NOTE: Defined in +active_support/core_ext/string/inflections.rb+.

h4. Conversions

h5. +constantize+

The method +constantize+ expects the receiver to contain the name of a constant, and tries to get you the object stored in there, assuming it is defined:

<ruby>
"ActiveRecord::Base".constantize # => ActiveRecord::Base
</ruby>

The name is assumed to be top-level, no matter whether it starts with "::" or not. No lexical context is taken into account:

<ruby>
C = 1
module M
C = 2
"C".constantize # => 1, same as "::C".constantize
end
</ruby>

NOTE: Defined in +active_support/core_ext/string/conversions.rb+.
h4(#string-conversions). Conversions

h5. +ord+

Expand Down Expand Up @@ -2041,7 +2021,7 @@ This method receives an arbitrary number of action names, and an optional hash o

NOTE: Defined in +active_support/core_ext/array/extract_options.rb+.

h4. Conversions
h4(#array-conversions). Conversions

h5. +to_sentence+

Expand Down Expand Up @@ -2985,7 +2965,7 @@ Date.new(2010, 1, 31).change(:month => 2)
# => ArgumentError: invalid date
</ruby>

h5. Durations
h5(#date-durations). Durations

Durations can be added and substracted to dates:

Expand Down Expand Up @@ -3191,7 +3171,7 @@ DateTime.current.change(:month => 2, :day => 30)
# => ArgumentError: invalid date
</ruby>

h5. Durations
h5(#datetime-durations). Durations

Durations can be added and substracted to datetimes:

Expand Down Expand Up @@ -3304,7 +3284,7 @@ Both +local_time+ and +utc_time+ accept up to seven positional arguments: year,

If the time to be constructed lies beyond the range supported by +Time+ in the runtime platform, usecs are discarded and a +DateTime+ object is returned instead.

h5. Durations
h5(#time-durations). Durations

Durations can be added and substracted to time objects:

Expand Down
20 changes: 10 additions & 10 deletions railties/guides/source/association_basics.textile
Expand Up @@ -550,7 +550,7 @@ build_customer
create_customer
</ruby>

h6. <em>association</em>(force_reload = false)
h6. <tt>_association_(force_reload = false)</tt>

The <tt><em>association</em></tt> method returns the associated object, if any. If no associated object is found, it returns +nil+.

Expand All @@ -560,15 +560,15 @@ The <tt><em>association</em></tt> method returns the associated object, if any.

If the associated object has already been retrieved from the database for this object, the cached version will be returned. To override this behavior (and force a database read), pass +true+ as the +force_reload+ argument.

h6. _association_=(associate)
h6. <tt>_association_=(associate)</tt>

The <tt><em>association</em>=</tt> method assigns an associated object to this object. Behind the scenes, this means extracting the primary key from the associate object and setting this object's foreign key to the same value.

<ruby>
@order.customer = @customer
</ruby>

h6. build_<em>association</em>(attributes = {})
h6(#belongs_to-build_association). <tt>build_<em>association</em>(attributes = {})</tt>

The <tt>build_<em>association</em></tt> method returns a new object of the associated type. This object will be instantiated from the passed attributes, and the link through this object's foreign key will be set, but the associated object will _not_ yet be saved.

Expand All @@ -577,7 +577,7 @@ The <tt>build_<em>association</em></tt> method returns a new object of the assoc
:customer_name => "John Doe")
</ruby>

h6. create_<em>association</em>(attributes = {})
h6(#belongs_to-create_association). <tt>create_<em>association</em>(attributes = {})</tt>

The <tt>create_<em>association</em></tt> method returns a new object of the associated type. This object will be instantiated from the passed attributes, and the link through this object's foreign key will be set. In addition, the associated object _will_ be saved (assuming that it passes any validations).

Expand Down Expand Up @@ -835,15 +835,15 @@ The <tt><em>association</em>=</tt> method assigns an associated object to this o
@supplier.account = @account
</ruby>

h6. <tt>build_<em>association</em>(attributes = {})</tt>
h6(#has_one-build_association). <tt>build_<em>association</em>(attributes = {})</tt>

The <tt>build_<em>association</em></tt> method returns a new object of the associated type. This object will be instantiated from the passed attributes, and the link through its foreign key will be set, but the associated object will _not_ yet be saved.

<ruby>
@account = @supplier.build_account(:terms => "Net 30")
</ruby>

h6. <tt>create_<em>association</em>(attributes = {})</tt>
h6(#has_one-create_association). <tt>create_<em>association</em>(attributes = {})</tt>

The <tt>create_<em>association</em></tt> method returns a new object of the associated type. This object will be instantiated from the passed attributes, and the link through its foreign key will be set. In addition, the associated object _will_ be saved (assuming that it passes any validations).

Expand Down Expand Up @@ -985,7 +985,7 @@ The +:source_type+ option specifies the source association type for a +has_one :

h6(#has_one-through). +:through+

The +:through+ option specifies a join model through which to perform the query. +has_one :through+ associations were discussed in detail <a href="#the-has-one-through-association">earlier in this guide</a>.
The +:through+ option specifies a join model through which to perform the query. +has_one :through+ associations were discussed in detail <a href="#the-has_one-through-association">earlier in this guide</a>.

h6(#has_one-validate). +:validate+

Expand Down Expand Up @@ -1136,7 +1136,7 @@ h6. <tt><em>collection</em>.exists?(...)</tt>

The <tt><em>collection</em>.exists?</tt> method checks whether an object meeting the supplied conditions exists in the collection. It uses the same syntax and options as +ActiveRecord::Base.exists?+.

h6. <tt><em>collection</em>.build(attributes = {}, ...)</tt>
h6(#has_many_collection_build). <tt><em>collection</em>.build(attributes = {}, ...)</tt>

The <tt><em>collection</em>.build</tt> method returns one or more new objects of the associated type. These objects will be instantiated from the passed attributes, and the link through their foreign key will be created, but the associated objects will _not_ yet be saved.

Expand Down Expand Up @@ -1367,7 +1367,7 @@ The +:source_type+ option specifies the source association type for a +has_many

h6(#has_many-through). +:through+

The +:through+ option specifies a join model through which to perform the query. +has_many :through+ associations provide a way to implement many-to-many relationships, as discussed <a href="#the-has-many-through-association">earlier in this guide</a>.
The +:through+ option specifies a join model through which to perform the query. +has_many :through+ associations provide a way to implement many-to-many relationships, as discussed <a href="#the-has_many-through-association">earlier in this guide</a>.

h6(#has_many-uniq). +:uniq+

Expand Down Expand Up @@ -1553,7 +1553,7 @@ h6(#has_and_belongs_to_many-collection-exists). <tt><em>collection</em>.exists?(

The <tt><em>collection</em>.exists?</tt> method checks whether an object meeting the supplied conditions exists in the collection. It uses the same syntax and options as +ActiveRecord::Base.exists?+.

h6. <tt><em>collection</em>.build(attributes = {})</tt>
h6(#has_and_belongs_to_many-collection-build). <tt><em>collection</em>.build(attributes = {})</tt>

The <tt><em>collection</em>.build</tt> method returns a new object of the associated type. This object will be instantiated from the passed attributes, and the link through the join table will be created, but the associated object will _not_ yet be saved.

Expand Down

0 comments on commit 3b62667

Please sign in to comment.