Ticket #3455: 3455.diff

docs/model-api.txt

@@ -498 +498 @@
     class Foo(models.Model):
         gender = models.CharField(maxlength=1, choices=GENDER_CHOICES)
 
+For each field on your model which has ``choices`` set, Django will
+add a method to retrieve the human-readable name for the field's
+current value; see `get_FOO_display`_ in the database API
+documentation.
+
+.. _get_FOO_display: ../db_api/#get-foo-display
+
 Finally, note that choices can be any iterable object -- not necessarily a
 list or tuple. This lets you construct choices dynamically. But if you find
 yourself hacking ``choices`` to be dynamic, you're probably better off using