Documentation for Custom permissions is ambiguous.

[Bradley Ayers <bradley.ayers@…>]

The example in ​http://docs.djangoproject.com/en/1.3/topics/auth/#custom-permissions is not clear. A few extra permissions are defined, e.g. "can_view", but it wasn't clear to me whether this would result in an "app.can_view" or "app.can_view_task" permission. Essentially in order to figure out what would happen, I had to create a test permission and run syncdb.

[chrisdoble]

I've attached a patch that will hopefully make things clearer.

[James Bennett]

In [16813]:

Fixed #16094: Added clear example of how to refer to custom permissions.

[James Bennett]

In [16814]:

[1.3.X] Fixed #16094: Added clear example of how to refer to custom permissions. Backport of [16813] from trunk.

[bradley.ayers]

fixed the code-block

[bradley.ayers]

There was a missing colon in the original patch. I've corrected this attached the patch.

[Julien Phalip]

Thanks for pointing this out, but it'd have been more useful if the patch was based on the latest trunk :)

The missing colon is at the end of the sentence "Continuing the above example, the following checks if a user may". This might have to be backported to 1.3.X to fix r16814.

[anonymous]

Oops! Good point julien, I didn't think that through too well :/

[Carl Meyer]

In [16836]:

Fixed #16094 -- Added missing colon in custom permissions docs.

[Carl Meyer]

In [16837]:

[1.3.X] Fixed #16094 -- Added missing colon in custom permissions docs.

Backport of r16836 from trunk.