Ticket #17568: 17568.diff

docs/ref/settings.txt

@@ -1303 +1303 @@
 This is used by the :func:`~django.contrib.auth.decorators.login_required`
 decorator, for example.
 
+.. _`note on LOGIN_REDIRECT_URL setting`:
+
+.. note::
+    You can use :func:`~reverse_lazy` to reference
+    URLs by their name instead of providing hardcoded value::
+
+        # urls.py
+        urlpatterns = i18n_patterns('',
+            url(_(r'^home/$'), 'test_app.views.home', name='home'),
+        )
+
+        # settings.py
+        LOGIN_REDIRECT_URL = reverse_lazy('home')
+
+
+    This also works well with :func:`~django.conf.urls.i18n.i18n_patterns`.
+
 .. setting:: LOGIN_URL
 
 LOGIN_URL
@@ -1313 +1330 @@
 The URL where requests are redirected for login, especially when using the
 :func:`~django.contrib.auth.decorators.login_required` decorator.
 
+.. note::
+    See the `note on LOGIN_REDIRECT_URL setting`_
+
 .. setting:: LOGOUT_URL
 
 LOGOUT_URL
@@ -1322 +1342 @@
 
 LOGIN_URL counterpart.
 
+.. note::
+    See the `note on LOGIN_REDIRECT_URL setting`_
+
 .. setting:: MANAGERS
 
 MANAGERS