Ticket #10531: 10531-patch.diff

docs/topics/db/models.txt

@@ -171 +171 @@
                 ('SR', 'Senior'),
                 ('GR', 'Graduate'),
             )
+        
+        The first element in each tuple is the value that will be stored in the database, the second
+        element will be displayed by the admin interface, or in a ModelChoiceField.  Given an instance
+        of a model object, the display value for a choices field can be accessed using the ``get_FOO_display``
+        method.  For example::
+        
+                from django.db import models
+                
+                class Person(models.Model):
+                        GENDER_CHOICES = (
+                                ('M', 'Male'),
+                                ('F', 'Female'),
+                        )
+                        name = models.CharField(max_length=60)
+                        gender = models.CharField(max_length=2, choices=GENDER_CHOICES)
+                        
+                p = Person(name="Fred Flinstone", gender="M")
+                p.save()
+                p.gender               # Returns 'M'
+                p.get_gender_display() # returns 'Male'
 
     :attr:`~Field.default`
         The default value for the field. This can be a value or a callable