Ticket #7986: 7986.patch

docs/admin.txt

@@ -365 +365 @@
     class ArticleAdmin(admin.ModelAdmin):
         prepopulated_fields = {"slug": ("title",)}
 
-When set the given fields will use a bit of Javascript to populate from the
-fields assigned.
+When set, the given fields will use a bit of Javascript to populate from the
+fields assigned. The main use for this functionality is to automatically
+generate the value for SlugFields from one or more other fields. The generated
+value is produced by concatenating the values of the source fields and then
+by cleaning and translating the result into a valid slug. 
 
 ``prepopulated_fields`` doesn't accept DateTimeFields, ForeignKeys nor
 ManyToManyFields.