?
=?ISO-8859-1?Q?Lasse_V=E5gs=E6ther_Karlsen?=
I notice that if I use this syntax:
def classname:
...
##
# closes the database connection and releases the resources.
def close(self):
....
##
# Returns a list of fields
fields = property(....)
then doing:
help (classname)
then the text is listed for the property and the method, whereas if I do
this:
classname.close.__doc__
then nothing is listed, and to get that I have to use the """.."""
syntax to document:
def close(self):
"""closes the datab..."""
....
then classname.close.__doc__ shows the text.
So, my question is, is there a way to get __doc__ support for
properties, in effect, use the """xxx""" syntax for documenting properties.
Is the preferred way to use """xxx""" or # to document ?
Whatever is preferred, what's the upside/downsides of the two beyond
what I just explained?
def classname:
...
##
# closes the database connection and releases the resources.
def close(self):
....
##
# Returns a list of fields
fields = property(....)
then doing:
help (classname)
then the text is listed for the property and the method, whereas if I do
this:
classname.close.__doc__
then nothing is listed, and to get that I have to use the """.."""
syntax to document:
def close(self):
"""closes the datab..."""
....
then classname.close.__doc__ shows the text.
So, my question is, is there a way to get __doc__ support for
properties, in effect, use the """xxx""" syntax for documenting properties.
Is the preferred way to use """xxx""" or # to document ?
Whatever is preferred, what's the upside/downsides of the two beyond
what I just explained?