summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorClaude Paroz <claude@2xlibre.net>2015-06-19 08:42:48 +0200
committerClaude Paroz <claude@2xlibre.net>2015-06-19 20:54:46 +0200
commit9368f51e1273c56ca40e396ef5a1aa0aa7c91871 (patch)
treea44216aef9afd7996a50e030ce64cf5aa21e6764 /docs
parentb769bbd4f6a3cd1bcd9ebf3559ec6ea0f9b50565 (diff)
Fixed #20197 -- Made XML serializer fail loudly when outputting unserializable chars
Thanks Tim Graham for the review.
Diffstat (limited to 'docs')
-rw-r--r--docs/releases/1.9.txt4
-rw-r--r--docs/topics/serialization.txt10
2 files changed, 14 insertions, 0 deletions
diff --git a/docs/releases/1.9.txt b/docs/releases/1.9.txt
index 9641ab2307..a8c0b960c7 100644
--- a/docs/releases/1.9.txt
+++ b/docs/releases/1.9.txt
@@ -720,6 +720,10 @@ Miscellaneous
* Private function ``django.utils.functional.total_ordering()`` has been
removed. It contained a workaround for a ``functools.total_ordering()`` bug
in Python versions older than 2.7.3.
+* XML serialization (either through :djadmin:`dumpdata` or the syndication
+ framework) used to output any characters it received. Now if the content to
+ be serialized contains any control characters not allowed in the XML 1.0
+ standard, the serialization will fail with a :exc:`ValueError`.
.. _deprecated-features-1.9:
diff --git a/docs/topics/serialization.txt b/docs/topics/serialization.txt
index 6828eb0f62..b48c625fe8 100644
--- a/docs/topics/serialization.txt
+++ b/docs/topics/serialization.txt
@@ -213,6 +213,16 @@ the auth.User model has such a relation to the auth.Permission model::
This example links the given user with the permission models with PKs 46 and 47.
+.. admonition:: Control characters
+
+ .. versionchanged:: 1.9
+
+ If the content to be serialized contains control characters that are not
+ accepted in the XML 1.0 standard, the serialization will fail with a
+ :exc:`ValueError` exception. Read also the W3C's explanation of `HTML,
+ XHTML, XML and Control Codes
+ <http://www.w3.org/International/questions/qa-controls>`_.
+
.. _serialization-formats-json:
JSON