Hi all!
What is the correct way, if any, of documenting a function/method?
1.
def foo(a,b):
""" A description.
a: Whatever 1
b: Whatever 2
"""
...
2.
def foo(a,b):
""" A description.
a -- Whatever 1
b -- Whatever 2
"""
...
3.
def foo(a,b):
""" A description.
@param a: Whatever 1
@param b: Whatever 2
"""
...
4.
def foo(a,b):
""" A description.
:param a: Whatever 1
:param b: Whatever 2
"""
...
5.
Any other ...
Any comments/suggestions are welcome.
Thanks.
Paulo
--
https://mail.python.org/mailman/listinfo/python-list
