X-Git-Url: http://git.ithinksw.org/philo.git/blobdiff_plain/79e89d2c15b86b7b8d4ccf76c85d2fa2154cd2e8..943e8bc4af0c11b0ace3811199e3b0844c4c3fbc:/philo/models/base.py

diff --git a/philo/models/base.py b/philo/models/base.py
index 573c339..1726d19 100644
--- a/philo/models/base.py
+++ b/philo/models/base.py
@@ -18,10 +18,14 @@ from philo.validators import json_validator
 
 
 class Tag(models.Model):
+	"""A simple, generic model for tagging."""
+	#: A CharField (max length 255) which contains the name of the tag.
 	name = models.CharField(max_length=255)
+	#: A CharField (max length 255) which contains the tag's unique slug.
 	slug = models.SlugField(max_length=255, unique=True)
 	
 	def __unicode__(self):
+		"""Returns the value of the :attr:`name` field"""
 		return self.name
 	
 	class Meta:
@@ -340,7 +344,7 @@ class TreeManager(models.Manager):
 	
 	def get_with_path(self, path, root=None, absolute_result=True, pathsep='/', field='slug'):
 		"""
-		If ``absolute_result`` is ``True``, returns the object at ``path`` (starting at ``root``) or raises a :class:`DoesNotExist` exception. Otherwise, returns a tuple containing the deepest object found along ``path`` (or ``root`` if no deeper object is found) and the remainder of the path after that object as a string (or None if there is no remaining path).
+		If ``absolute_result`` is ``True``, returns the object at ``path`` (starting at ``root``) or raises an :class:`~django.core.exceptions.ObjectDoesNotExist` exception. Otherwise, returns a tuple containing the deepest object found along ``path`` (or ``root`` if no deeper object is found) and the remainder of the path after that object as a string (or None if there is no remaining path).
 		
 		.. note:: If you are looking for something with an exact path, it is faster to use absolute_result=True, unless the path depth is over ~40, in which case the high cost of the absolute query may make a binary search (i.e. non-absolute) faster.
 		
@@ -351,7 +355,8 @@ class TreeManager(models.Manager):
 		:param absolute_result: Whether to return an absolute result or do a binary search
 		:param pathsep: The path separator used in ``path``
 		:param field: The field on the model which should be queried for ``path`` segment matching.
-		:returns: An instance if absolute_result is True or (instance, remaining_path) otherwise.
+		:returns: An instance if ``absolute_result`` is ``True`` or an (instance, remaining_path) tuple otherwise.
+		:raises django.core.exceptions.ObjectDoesNotExist: if no object can be found matching the input parameters.
 		
 		"""