reverse() documentation

[Daniele Procida]

​https://docs.djangoproject.com/en/dev/ref/urlresolvers/#reverse:

reverse(viewname[, urlconf=None, args=None, kwargs=None, current_app=None])
viewname is either the function name (either a function reference, or the string version of the name, if you used that form in urlpatterns) or the URL pattern name.

I think this could be clearer.

• there should be a link to an example of each of the different ways in the documentation (only "URL pattern name" is elucidated this way)
• the phrase "function reference" is confusing; ​https://docs.djangoproject.com/en/dev/topics/http/urls/#passing-callable-objects-instead-of-strings speaks of "passing objects" for example and the same language should be used in both cases.

And what if one creates a URL pattern name that's the also the string version of the view function name - which would win?

[Ben Davis]

Here's my take on this: ​https://github.com/django/django/pull/2544

[Tim Graham <timograham@…>]

In 030dd4f72ca4d84c0a5e09ee625123d03651fdd1:

Fixed #22220 -- Added more examples to reverse() documention.

Thanks EvilDMP for the suggestions.

[Tim Graham <timograham@…>]

In 8c1d8a6215b123f2d0981f926db1f0405392ae5f:

[1.7.x] Fixed #22220 -- Added more examples to reverse() documention.

Thanks EvilDMP for the suggestions.

Backport of 030dd4f72c from master

[Tim Graham <timograham@…>]

In e0930608230fc7e1f1a68d51296661200857658a:

[1.6.x] Fixed #22220 -- Added more examples to reverse() documention.

Thanks EvilDMP for the suggestions.

Backport of 030dd4f72c from master