Ticket #13211: groups.diff

docs/topics/auth.txt

@@ -1434 +1434 @@
 
 .. currentmodule:: django.contrib.auth
 
+Programmatically creating permissions
+-------------------------------------
+
+While custom permissions can be defined within a model's ``Meta`` class, you
+can also create permissions directly. For example, you can create the ``can_publish``
+permission for a ``BlogPost`` model in ``myapp``::
+
+    from django.contrib.auth.models import Group, Permission
+    from django.contrib.contenttypes.models import ContentType
+
+    content_type = ContentType.objects.get(app_label='myapp', model='BlogPost')
+    perm = Permission.objects.create(codename='can_publish', name='Can Publish Posts',
+         content_type=content_type)
+
+The permission can be assigned to a :class:`~django.contrib.auth.models.User` via
+``user_permissions`` or a :class:`~django.contrib.auth.models.Group` via
+``permissions``.
+
+
 Authentication data in templates
 ================================
 
@@ -1526 +1545 @@
 access to a members-only portion of your site, or send them members-only email
 messages.
 
+API reference
+-------------
+
+.. class:: models.Group
+
+    As with both users and permissions, groups are implemented in a Django model
+    that lives in `django/contrib/auth/models.py`_.
+
+.. _django/contrib/auth/models.py: http://code.djangoproject.com/browser/django/trunk/django/contrib/auth/models.py
+
+Fields
+~~~~~~
+
+:class:`~django.contrib.auth.models.Group` objects have the following fields:
+
+.. attribute:: models.Group.name
+
+    Required. 80 characters or fewer. Any characters are permitted. Example:
+    ``'Awesome Users'``.
+
+.. attribute:: models.Group.permissions
+
+    Many-to-many field to :class:`~django.contrib.auth.models.Permissions`::
+
+        group.permissions = [permission_list]
+        group.permissions.add(permission, permission, ...)
+        group.permissions.remove(permission, permission, ...)
+        group.permissions.clear()
+
 .. _authentication-backends:
 
 Other authentication sources