Ticket #10229: list_display.diff

index.txt

@@ -364 +364 @@
       this::
 
           list_display = ('__unicode__', 'some_other_field')
+          
+    * If the field being represented derives from a CHOICES tuple, and integers
+      are used as the keys, be sure you're using real integers in the tuple, 
+      not strings that look like integers. Otherwise, ``list_display`` will show
+      (None) for this field rather than the value you think should be displayed.
+      For example, this works as expected::
+      
+          YEARS = (
+              (0,'Non-Vintage'),
+              (9999,'Multi-Vintage'),
+              (1880,'1880'),
+              (1881,'1881'),
+          )
+          
+      While this does not::
 
+          YEARS = (
+            ('0','Non-Vintage'),
+            ('9999','Multi-Vintage'),
+            ('1880','1880'),
+            ('1881','1881'),
+          )    
+
     * Usually, elements of ``list_display`` that aren't actual database fields
       can't be used in sorting (because Django does all the sorting at the
       database level).