Fixed #11439 -- Added docs on including URL patterns as an iterable. Thanks to...

include

-------

A function that takes a full Python import path to another URLconf that should

be "included" in this place. See `Including other URLconfs`_ below.

A function that takes a full Python import path to another URLconf module that

should be "included" in this place.

.. versionadded:: 1.1

:meth:``include`` also accepts as an argument an iterable that returns URL

patterns.

See `Including other URLconfs`_ below.

Notes on capturing text in URLs

===============================

up to that point and sends the remaining string to the included URLconf for

further processing.

.. versionadded:: 1.1

Another posibility is to include additional URL patterns not by specifying the

URLconf Python module defining them as the `include`_ argument but by using

directly the pattern list as returned by `patterns`_ instead. For example::

    from django.conf.urls.defaults import *

    extra_patterns = patterns('',

        url(r'reports/(?P<id>\d+)/$', 'credit.views.report', name='credit-reports'),

        url(r'charge/$', 'credit.views.charge', name='credit-charge'),

    )

    urlpatterns = patterns('',

        url(r'^$',    'apps.main.views.homepage', name='site-homepage'),

        (r'^help/',   include('apps.help.urls')),

        (r'^credit/', include(extra_patterns)),

    )

.. _`Django Web site`: http://www.djangoproject.com/

Captured parameters