X-Git-Url: http://git.ithinksw.org/philo.git/blobdiff_plain/fb8a270fa22abc217efc471d860c76d5a2352c61..0959d38b27c03863ec376839dcc6d896d04e36ea:/philo/templatetags/collections.py

diff --git a/philo/templatetags/collections.py b/philo/templatetags/collections.py
index 38b3f91..414a742 100644
--- a/philo/templatetags/collections.py
+++ b/philo/templatetags/collections.py
@@ -1,3 +1,8 @@
+"""
+The collection template tags are automatically included as builtins if :mod:`philo` is an installed app.
+
+"""
+
 from django import template
 from django.conf import settings
 from django.contrib.contenttypes.models import ContentType
@@ -21,9 +26,15 @@ class MembersofNode(template.Node):
 		return ''
 
 
-def do_membersof(parser, token):
+@register.tag
+def membersof(parser, token):
 	"""
-	{% membersof <collection> with <app_label>.<model_name> as <var> %}
+	Given a collection and a content type, sets the results of :meth:`collection.members.with_model <.CollectionMemberManager.with_model>` as a variable in the context.
+	
+	Usage::
+	
+		{% membersof <collection> with <app_label>.<model_name> as <var> %}
+	
 	"""
 	params=token.split_contents()
 	tag = params[0]
@@ -45,7 +56,4 @@ def do_membersof(parser, token):
 	if params[4] != 'as':
 		raise template.TemplateSyntaxError('"%s" template tag requires the fifth parameter to be "as"' % tag)
 	
-	return MembersofNode(collection=params[1], model=ct.model_class(), as_var=params[5])
-
-
-register.tag('membersof', do_membersof)
\ No newline at end of file
+	return MembersofNode(collection=params[1], model=ct.model_class(), as_var=params[5])
\ No newline at end of file