Documented url()'s 'regex' parameter.

1 files changed, 7 insertions, 0 deletions

diff --git a/docs/ref/urls.txt b/docs/ref/urls.txt
index 37df9a30cf..d1464da66d 100644
--- a/docs/ref/urls.txt
+++ b/docs/ref/urls.txt
@@ -33,6 +33,13 @@ Helper function to return a URL pattern for serving files in debug mode::
         ...
     ]
 
+The ``regex`` parameter should be a string or
+:func:`~django.utils.translation.ugettext_lazy()` (see
+:ref:`translating-urlpatterns`) that contains a regular expression compatible
+with Python's :py:mod:`re` module. Strings typically use raw string syntax
+(``r''``) so that they can contain sequences like ``\d`` without the need to
+escape the backslash with another backslash.
+
 The ``view`` parameter is a view function or the result of
 :meth:`~django.views.generic.base.View.as_view` for class-based views. It can
 also be an :func:`include`.