usage of url template tag under-documented

[John D'Ambrosio]

Hello,
While learning about the {% url %} template tag, I found the documentation to be inadequate in one section and incorrect in another. Forums answered my question, but I just wanted to bring it to your attention. I have the snippets below.
Thanks, John

​https://docs.djangoproject.com/en/dev/ref/templates/builtins/

Reads
If you're using named URL patterns, you can refer to the name of the pattern in the url tag instead of using the path to the view.

Recommend
If you're using named URL patterns, you can refer to the name of the pattern in the url tag without quotation marks instead of using the path to the view.

​https://docs.djangoproject.com/en/dev/topics/http/urls

Reads
Here's the above example, rewritten to use named URL patterns:

urlpatterns = patterns(' ',

url(..., name="full-archive"),
url(..., "arch-summary"),

)

With these names in place (full-archive and arch-summary), you can target each pattern individually by using its name:

{% url 'arch-summary' 1945 %}
{% url 'full-archive' 2007 %}

Recommend
{% url arch-summary 1945 %}
{% url full-archive 2007 %}

[Aymeric Augustin]

Thanks for the report, but the documentation is correct.

You aren't reading the documentation for the version of Django you're using.

See:

• #18892, #18787, #18762, #18756, #18723, #18705, #18689 and other duplicates
• #18922 for the meta-problem
• #18893 for this instance of the problem