admin documentation section errors for 'comments' tags

[jmoiron@…]

The documentation for the comments are a little bit off:

​http://jmoiron.net/~jmoiron/documentation_error.png

As you can see the free_comments_* tags and the comments_ tags show the same documentation but the tags are (of course) different. This is a side effect of the way that the tags are registered.. it tripped me up a little because the line in which I used this tag had a syntax error and when the docs told me I was wrong I dove into the code to make sure :)

(note: i'm going to go shrink that image a little :)

[Adrian Holovaty]

Ah, this is happening because both of the free_comments tags are generated from the same function, so they share a docstring, which is where the admin documentation gets its docs from.

[(none)]

Milestone Version 1.0 deleted

[Chris Beaven]

I'll accept, but I hear comments are being rewritten anyway. Good to keep tabs on tickets like this though.

[Jacob]

This is annoying, but really doesn't have to be a 1.0 fix.

[Jacob]

With the new comment system added in [8557], I'm closing all comment-related tickets since they're against an old system. Please open a new ticket for this issue if it still applies in the new system.