Ticket #8802: django-mysql-bool-note.diff

docs/ref/databases.txt

@@ -228 +228 @@
 
 .. _AlterModelOnSyncDB: http://code.djangoproject.com/wiki/AlterModelOnSyncDB
 
+BooleanFields
+-------------
+
+In Django when you use a :class:`~django.db.models.fields.BooleanField` with 
+MySQL Django will actually create an integer column.  This means that when 
+retrieving a value you will get `1` and `0` instead of `True` and `False`.  This
+is usually not an issue in your code, because in Python they are completely 
+equal(bool is actually a subclass of int).  However it does mean that if you 
+want to write portable tests you should test for equality, not output::
+    # bad
+    >>> my_obj.bool
+    True
+    
+    # good
+    >>> my_obj.bool == True
+    True
 
 .. _oracle-notes: