Terry J. Reedy <tjre...@udel.edu> added the comment:

My guess from the way the docs are written now is that subclassing from Action 
and over-riding just the __call__ method is the intended way, not just the 
recommended. If so, Action is a quasi-private class, only exposed so it could 
be subclassed with one method given. And if so, one could question whether 
anything more need be documented.

However, in your patch, you write

"+Many actions also override the ``__init__`` method, validating the parameters 
to the argument definition and raising a ValueError or other Exception on 
failure."

What 'many actions' are you referring to? Ones you have written, by referring 
to the code? Ones you think might be written if the doc were added?

In any case, I would prefer input from Stephen before we expose and thereby 
freeze the __init__ signature.

----------

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

Reply via email to