From ecb56cecbddffe7f06e94a08d2d71713d85514e4 Mon Sep 17 00:00:00 2001 From: Karen Tracey Date: Tue, 2 Mar 2010 04:04:23 +0000 Subject: [PATCH] Fixed #12946: Removed an invalid example of url tag usage from the docs. git-svn-id: http://code.djangoproject.com/svn/django/trunk@12652 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/ref/templates/builtins.txt | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index 1ac86c5d1bd..8bc4f8e4f6b 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -891,12 +891,18 @@ Returns an absolute URL (i.e., a URL without the domain name) matching a given view function and optional parameters. This is a way to output links without violating the DRY principle by having to hard-code URLs in your templates:: - {% url path.to.some_view arg1,arg2,name1=value1 %} + {% url path.to.some_view v1,v2 %} The first argument is a path to a view function in the format ``package.package.module.function``. Additional arguments are optional and -should be comma-separated values that will be used as positional and keyword -arguments in the URL. All arguments required by the URLconf should be present. +should be comma-separated values that will be used as arguments in the URL. +The example above shows passing positional arguments. Alternatively you may +use keyword syntax:: + + {% url path.to.some_view arg1=v1,arg2=v2 %} + +Do not mix both positional and keyword syntax in a single call. All arguments +required by the URLconf should be present. For example, suppose you have a view, ``app_views.client``, whose URLconf takes a client ID (here, ``client()`` is a method inside the views file