James Bennett avatar James Bennett committed 80c6e3a

Add note about compatibility of URLConf to the docs.

Comments (0)

Files changed (1)

 Backwards-incompatible changes
-To upgrade from a previous version of django-registration, you will
-need to make one change, to your project's configuration: if you were
-using the default ``URLConf`` provided in previous versions, you will
-instead need to use the ``URLConf`` provided by the default backend in
-0.8, which is located at ``registration.backends.default.urls``. So,
-for example, if you previously had this in your ``URLConf``::
+If you're upgrading from an older release of django-registration, and
+if you were using the default setup (i.e., the included default
+URLConf and no custom URL patterns or custom arguments to views), you
+will not need to make any immediate changes. However, the old default
+URLConf has been deprecated and will be removed in version 1.0 of
+django-registration, so it is recommended that you begin migrating
+now. To do so, change any use of ``registration.urls`` to
+``registration.backends.default.urls``. For example, if you had the
+following in your root URLConf::
     (r'^accounts/', include('registration.urls')),
-you will need to change it to::
+you should change it to::
     (r'^accounts/', include('registration.backends.default.urls')),
-If you had set up custom URL patterns, you will need to consult the
-documentation for the registration views to see how to adapt your
-custom URL patterns for use with django-registration 0.8.
+The older include will continue to work until django-registration 1.0;
+in 0.8 it raises a ``PendingDeprecationWarning`` (which is ignored by
+default in Python), in 0.9 it will raise ``DeprecationWarning`` (which
+will begin printing warning messages on import) and in 1.0 it will be
+removed entirely.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.