id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
15604	django.db.models.permalink eats docstring	Simon Law	nobody	"The {{{django.db.models.permalink}}} decorator eats docstrings, along with the other metadata that it is wrapping. That's because it's not using {{{functools.wraps}}} on its {{{inner}}} function.

It should be defined like this:

{{{
from django.utils.decorators import wraps

def permalink(func):
    from django.core.urlresolvers import reverse
    @wraps
    def inner(*args, **kwargs):
        bits = func(*args, **kwargs)
        return reverse(bits[0], None, *bits[1:3])
    return inner
}}}
"		closed	Core (Other)	1.2		fixed			Accepted	0	0	0	0	0	0