==========================
Django 1.0.2 release notes
==========================

Welcome to Django 1.0.2!

This is the second "bugfix" release in the Django 1.0 series,
improving the stability and performance of the Django 1.0 codebase. As
such, Django 1.0.2 contains no new features (and, pursuant to
:doc:`our compatibility policy </misc/api-stability>`, maintains backwards compatibility with Django
1.0.0), but does contain a number of fixes and other
improvements. Django 1.0.2 is a recommended upgrade for any
development or deployment currently using or targeting Django 1.0.


Fixes and improvements in Django 1.0.2
======================================

The primary reason behind this release is to remedy an issue in the
recently-released Django 1.0.1; the packaging scripts used for Django
1.0.1 omitted some directories from the final release package,
including one directory required by ``django.contrib.gis`` and part of
Django's unit-test suite.

Django 1.0.2 contains updated packaging scripts, and the release
package contains the directories omitted from Django 1.0.1. As such,
this release contains all of the fixes and improvements from Django
1.0.1; see :doc:`the Django 1.0.1 release notes </releases/1.0.1>` for
details.

Additionally, in the period since Django 1.0.1 was released:

* Updated Hebrew and Danish translations have been added.

* The default ``__repr__`` method of Django models has been made more
  robust in the face of bad Unicode data coming from the
  ``__unicode__`` method; rather than raise an exception in such
  cases, ``repr()`` will now contain the string "[Bad Unicode data]"
  in place of the invalid Unicode.

* A bug involving the interaction of Django's ``SafeUnicode`` class
  and the MySQL adapter has been resolved; ``SafeUnicode`` instances
  (generated, for example, by template rendering) can now be assigned
  to model attributes and saved to MySQL without requiring an explicit
  intermediate cast to ``unicode``.

* A bug affecting filtering on a nullable ``DateField`` in SQLite has
  been resolved.

* Several updates and improvements have been made to Django's
  documentation.