From 50e299dbfbbfd796e63e7e13b4566cf69d2c4acb Mon Sep 17 00:00:00 2001
From: Jon Dufresne <jon.dufresne@gmail.com>
Date: Thu, 21 Jul 2016 22:05:17 -0700
Subject: Fixed #26928 -- Changed forms' checked attribute to HTML5 boolean
 style.

---
 docs/ref/forms/api.txt     | 21 +++++++++++++++------
 docs/ref/forms/widgets.txt |  4 ++++
 2 files changed, 19 insertions(+), 6 deletions(-)

(limited to 'docs/ref/forms')
diff --git a/docs/ref/forms/api.txt b/docs/ref/forms/api.txt
index 9e9388344a..de66986e18 100644
--- a/docs/ref/forms/api.txt
+++ b/docs/ref/forms/api.txt
@@ -430,7 +430,7 @@ If the form is bound to data, the HTML output will include that data
 appropriately. For example, if a field is represented by an
 ``<input type="text">``, the data will be in the ``value`` attribute. If a
 field is represented by an ``<input type="checkbox">``, then that HTML will
-include ``checked="checked"`` if appropriate::
+include ``checked`` if appropriate::
 
     >>> data = {'subject': 'hello',
     ...         'message': 'Hi there',
@@ -441,7 +441,12 @@ include ``checked="checked"`` if appropriate::
     <tr><th><label for="id_subject">Subject:</label></th><td><input id="id_subject" type="text" name="subject" maxlength="100" value="hello" required /></td></tr>
     <tr><th><label for="id_message">Message:</label></th><td><input type="text" name="message" id="id_message" value="Hi there" required /></td></tr>
     <tr><th><label for="id_sender">Sender:</label></th><td><input type="email" name="sender" id="id_sender" value="foo@example.com" required /></td></tr>
-    <tr><th><label for="id_cc_myself">Cc myself:</label></th><td><input type="checkbox" name="cc_myself" id="id_cc_myself" checked="checked" /></td></tr>
+    <tr><th><label for="id_cc_myself">Cc myself:</label></th><td><input type="checkbox" name="cc_myself" id="id_cc_myself" checked /></td></tr>
+
+.. versionchanged:: 1.11
+
+    The ``checked`` attribute was changed to use HTML5 boolean syntax rather
+    than ``checked="checked"``.
 
 This default output is a two-column HTML table, with a ``<tr>`` for each field.
 Notice the following:
@@ -471,6 +476,10 @@ Notice the following:
   attributes and ``<label>`` tags are included in the output by default, to
   follow best practices, but you can change that behavior.
 
+* The output uses HTML5 syntax, targeting ``<!DOCTYPE html>``. For example,
+  it uses boolean attributes such as ``checked`` rather than the XHTML style
+  of ``checked='checked'``.
+
 Although ``<table>`` output is the default output style when you ``print`` a
 form, other output styles are available. Each style is available as a method on
 a form object, and each rendering method returns a Unicode object.
@@ -751,19 +760,19 @@ method you're using::
     <tr><th>Subject:</th><td><ul class="errorlist"><li>This field is required.</li></ul><input type="text" name="subject" maxlength="100" required /></td></tr>
     <tr><th>Message:</th><td><input type="text" name="message" value="Hi there" required /></td></tr>
     <tr><th>Sender:</th><td><ul class="errorlist"><li>Enter a valid email address.</li></ul><input type="email" name="sender" value="invalid email address" required /></td></tr>
-    <tr><th>Cc myself:</th><td><input checked="checked" type="checkbox" name="cc_myself" /></td></tr>
+    <tr><th>Cc myself:</th><td><input checked type="checkbox" name="cc_myself" /></td></tr>
     >>> print(f.as_ul())
     <li><ul class="errorlist"><li>This field is required.</li></ul>Subject: <input type="text" name="subject" maxlength="100" required /></li>
     <li>Message: <input type="text" name="message" value="Hi there" required /></li>
     <li><ul class="errorlist"><li>Enter a valid email address.</li></ul>Sender: <input type="email" name="sender" value="invalid email address" required /></li>
-    <li>Cc myself: <input checked="checked" type="checkbox" name="cc_myself" /></li>
+    <li>Cc myself: <input checked type="checkbox" name="cc_myself" /></li>
     >>> print(f.as_p())
     <p><ul class="errorlist"><li>This field is required.</li></ul></p>
     <p>Subject: <input type="text" name="subject" maxlength="100" required /></p>
     <p>Message: <input type="text" name="message" value="Hi there" required /></p>
     <p><ul class="errorlist"><li>Enter a valid email address.</li></ul></p>
     <p>Sender: <input type="email" name="sender" value="invalid email address" required /></p>
-    <p>Cc myself: <input checked="checked" type="checkbox" name="cc_myself" /></p>
+    <p>Cc myself: <input checked type="checkbox" name="cc_myself" /></p>
 
 .. _ref-forms-error-list-format:
 
@@ -789,7 +798,7 @@ Python 2)::
     <p>Message: <input type="text" name="message" value="Hi there" required /></p>
     <div class="errorlist"><div class="error">Enter a valid email address.</div></div>
     <p>Sender: <input type="email" name="sender" value="invalid email address" required /></p>
-    <p>Cc myself: <input checked="checked" type="checkbox" name="cc_myself" /></p>
+    <p>Cc myself: <input checked type="checkbox" name="cc_myself" /></p>
 
 More granular output
 ====================
diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt
index aae92a37c9..6af97469c9 100644
--- a/docs/ref/forms/widgets.txt
+++ b/docs/ref/forms/widgets.txt
@@ -11,6 +11,10 @@ A widget is Django's representation of an HTML input element. The widget
 handles the rendering of the HTML, and the extraction of data from a GET/POST
 dictionary that corresponds to the widget.
 
+The HTML generated by the built-in widgets uses HTML5 syntax, targeting
+``<!DOCTYPE html>``. For example, it uses boolean attributes such as ``checked``
+rather than the XHTML style of ``checked='checked'``.
+
 .. tip::
 
     Widgets should not be confused with the :doc:`form fields </ref/forms/fields>`.
-- 
cgit v1.3


Subject:	This field is required.
Message:
Sender:	Enter a valid email address.
Cc myself:
Cc myself: