Improve documentation coverage and markup

Signed-off-by: Pratik Naik <pratiknaik@gmail.com>

1 files changed, 5 insertions, 5 deletions

diff --git a/activerecord/lib/active_record/serialization.rb b/activerecord/lib/active_record/serialization.rb
index 2c8210a299..332cda1e16 100644
--- a/activerecord/lib/active_record/serialization.rb
+++ b/activerecord/lib/active_record/serialization.rb
@@ -8,11 +8,11 @@ module ActiveRecord #:nodoc:
       end
 
       # To replicate the behavior in ActiveRecord#attributes,
-      # :except takes precedence over :only.  If :only is not set
+      # <tt>:except</tt> takes precedence over <tt>:only</tt>.  If <tt>:only</tt> is not set
       # for a N level model but is set for the N+1 level models,
-      # then because :except is set to a default value, the second
-      # level model can have both :except and :only set.  So if
-      # :only is set, always delete :except.
+      # then because <tt>:except</tt> is set to a default value, the second
+      # level model can have both <tt>:except</tt> and <tt>:only</tt> set.  So if
+      # <tt>:only</tt> is set, always delete <tt>:except</tt>.
       def serializable_attribute_names
         attribute_names = @record.attribute_names
 
@@ -38,7 +38,7 @@ module ActiveRecord #:nodoc:
         serializable_attribute_names + serializable_method_names
       end
 
-      # Add associations specified via the :includes option.
+      # Add associations specified via the <tt>:includes</tt> option.
       # Expects a block that takes as arguments:
       #   +association+ - name of the association
       #   +records+     - the association record(s) to be serialized