More tweaks

Author: johnnyshields

docs/reference/fields.txt

@@ -847,8 +847,13 @@ coerced to the type of the field. For example:
   User.new(name: [ "hello" ])
 
 Assigning an array to a field of type Integer doesn't work since an array can't
-be coerced to an Integer. The assignment of uncastable values to a field will
-cause a ``nil`` to be written:
+be coerced to an Integer. Internally, Mongoid uses ``Mongoid::RawValue(object)``
+to represent such uncastable values. You can determine how to handle such values
+using the global config ``Mongoid.strict_type_assignment`` and the ``field :strict``
+option.
+
+By default the assignment of uncastable values to a field will cause a ``nil``
+to be assigned:
 
 .. code::
 
@@ -1008,9 +1013,9 @@ setter methods for fields of your custom type.
 
 .. note::
 
-  The ``mongoize`` method should return ``nil`` on values that are uncastable to
-  your custom type. See the secion on :ref:`Uncastable Values <uncastable-values>`
-  for more details.
+  The ``mongoize`` method should return ``Mongoid::RawValue(object, "YourTypeName")``
+  on values that are uncastable to your custom type.  See the section on
+  :ref:`Uncastable Values <uncastable-values>` for more details.
 
 The class method ``demongoize`` does the inverse of ``mongoize``. It takes the raw object
 from the MongoDB Ruby driver and converts it to an instance of your custom type.

lib/mongoid/fields/standard.rb

@@ -16,7 +16,9 @@ def mongoize(object)
         if value.is_a?(Mongoid::RawValue)
           case strict
           when :error then value.raise_error!
-          when :warn then value.warn
+          when :warn then value.warn and return nil
+          when :suppress then return nil
+          # when :defer, assign the Mongoid::RawValue and fail when trying to persist.
           end
         end
         value