Permalink
Browse files

[1.2.X] Fixed #12812 -- added warning about cyclic imports in contrib…

….comments. Thanks to Beetle_B, bjourne and philgyford for the reports, and Russ for the wording.

Backport of r14810 from trunk.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.2.X@14811 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 6c53a81 commit 65b26b30a760330aac94bf2cdaa4d18f337c875e @DrMeers DrMeers committed Dec 4, 2010
Showing with 12 additions and 0 deletions.
  1. +12 −0 docs/ref/contrib/comments/custom.txt
View
12 docs/ref/contrib/comments/custom.txt
@@ -110,6 +110,18 @@ point Django at these classes we've created::
def get_form():
return CommentFormWithTitle
+
+.. warning::
+
+ Be careful not to create cyclic imports in your custom comments app.
+ If you feel your comment configuration isn't being used as defined --
+ for example, if your comment moderation policy isn't being applied --
+ you may have a cyclic import problem.
+
+ If you are having unexplained problems with comments behavior, check
+ if your custom comments application imports (even indirectly)
+ any module that itself imports Django's comments module.
+
The above process should take care of most common situations. For more
advanced usage, there are additional methods you can define. Those are
explained in the next section.

0 comments on commit 65b26b3

Please sign in to comment.