From 0d83052e52ddfe99c214be7ffca348a3c8feaef5 Mon Sep 17 00:00:00 2001
From: Pavel Kulikov <kulikovpavel@gmail.com>
Date: Sat, 11 Mar 2017 10:11:44 +0300
Subject: [PATCH] Fixed #27918 -- Documented ChoiceWidget.option_template_name

---
 docs/ref/forms/widgets.txt | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt
index e32cefb0da..e4630a468b 100644
--- a/docs/ref/forms/widgets.txt
+++ b/docs/ref/forms/widgets.txt
@@ -612,6 +612,14 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 Selector and checkbox widgets
 -----------------------------
 
+These widgets make use of the HTML elements ``<select>``,
+``<input type='checkbox'>``, and ``<input type='radio'>``.
+
+Widgets that render multiple choices have an ``option_template_name`` attribute
+that specifies the template used to render each choice. For example, for the
+:class:`Select` widget, ``select_option.html`` renders the ``<option>`` for a
+``<select>``.
+
 ``CheckboxInput``
 ~~~~~~~~~~~~~~~~~
 
@@ -634,6 +642,7 @@ Selector and checkbox widgets
 .. class:: Select
 
     * ``template_name``: ``'django/forms/widgets/select.html'``
+    * ``option_template_name``: ``'django/forms/widgets/select_option.html'``
     * Renders as: ``<select><option ...>...</select>``
 
     .. attribute:: Select.choices
@@ -648,6 +657,7 @@ Selector and checkbox widgets
 .. class:: NullBooleanSelect
 
     * ``template_name``: ``'django/forms/widgets/select.html'``
+    * ``option_template_name``: ``'django/forms/widgets/select_option.html'``
 
     Select widget with options 'Unknown', 'Yes' and 'No'
 
@@ -657,6 +667,7 @@ Selector and checkbox widgets
 .. class:: SelectMultiple
 
     * ``template_name``: ``'django/forms/widgets/select.html'``
+    * ``option_template_name``: ``'django/forms/widgets/select_option.html'``
 
     Similar to :class:`Select`, but allows multiple selection:
     ``<select multiple='multiple'>...</select>``
@@ -667,6 +678,7 @@ Selector and checkbox widgets
 .. class:: RadioSelect
 
     * ``template_name``: ``'django/forms/widgets/radio.html'``
+    * ``option_template_name``: ``'django/forms/widgets/radio_option.html'``
 
     Similar to :class:`Select`, but rendered as a list of radio buttons within
     ``<li>`` tags:
@@ -761,6 +773,7 @@ Selector and checkbox widgets
 .. class:: CheckboxSelectMultiple
 
     * ``template_name``: ``'django/forms/widgets/checkbox_select.html'``
+    * ``option_template_name``: ``'django/forms/widgets/checkbox_option.html'``
 
     Similar to :class:`SelectMultiple`, but rendered as a list of check
     buttons: