To generate automatic docstrings on methods, you use
CTRL+1.
This shortcut generates simple quote. It could be nice,
if the developper could choose between simple quote and
double quote .
Also, the block comment feature in the Source menu currently
generates a comment block using #'s. It would be nice to
have the option to block comment using triple
single/double-quotes.
And it would be nice if this docstring section could be
customized :
Actually, only @param items.
But @type, @return, @rtype and maybe @see would be
wonderfull...
In fact it depends of the method, so if it could be
customized (also for single/double-quotes)...
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Logged In: YES
user_id=617340
Also, the block comment feature in the Source menu currently
generates a comment block using #'s. It would be nice to
have the option to block comment using triple
single/double-quotes.
Taken from duplicate:
http://sourceforge.net/tracker/index.php?func=detail&aid=1426319&group_id=85796&atid=577332
Logged In: YES
user_id=1499406
And it would be nice if this docstring section could be
customized :
Actually, only @param items.
But @type, @return, @rtype and maybe @see would be
wonderfull...
In fact it depends of the method, so if it could be
customized (also for single/double-quotes)...
Logged In: YES
user_id=177528
I would like to have triple-quotes as docstring as well. As
far as I know, this is the common way to do it.
P.S. When I use QuickFix/ContentAssist (CTRL+1) I do not
even get any "surround with docstring" in 1.2.4.
Is this normal ?
Logged In: YES
user_id=617340
Actually, the way to do it is not surround, but in the 'def'
line press ctrl+1 and choose make docstring.
Check http://www.fabioz.com/pydev/manual_adv_assistants.html
for more examples.
Logged In: YES
user_id=1761061
Originator: NO
I agree since triple double quotes are part of the docstring rules http://www.python.org/dev/peps/pep-0257/