New submission from Éric Araujo <mer...@netwok.org>:

Some of the confusion encountered when writing decorators arise from the 
difference between a decorator (@something) and a decorator factory 
(@something(args)).  It would help to adopt this clearer terminology in our 
docs: a decorator takes the decorated function as argument and does its 
business, a decorator factory takes some arguments and returns a decorator 
which wraps the decorated function.

(I think it was Nick who suggested this in a recent-ish mailing list thread.)

----------
assignee: docs@python
components: Documentation
messages: 166600
nosy: docs@python, eric.araujo, ncoghlan
priority: normal
severity: normal
status: open
title: Differentiate decorator and decorator factory in docs
versions: Python 2.7, Python 3.2, Python 3.3

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue15474>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to