Commit 65b26b30 authored by Simon Meers's avatar Simon Meers
Browse files

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

[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
parent 6c53a816

docs/ref/contrib/comments/custom.txt

+12 −0
Original line number Diff line number Diff line
@@ -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.