docstrings style question
Steve Brown
steve at mhomer.au
Thu Jan 10 00:47:40 EST 2008
More information about the Python-list mailing list
Thu Jan 10 00:47:40 EST 2008
- Previous message (by thread): Rebuild list of objects with redundancies on objects' attribute
- Next message (by thread): docstrings style question
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
I've got a series of modules which look like this:
#************
#
# Temperature Sense Test
#
#************
class Test3(ar_test.AR_TEST):
"""Temperature Sense Test"""
I don't like the duplicated information: But the comment is attractive, and
the docstring self.__doc__ is already in use in the test log. I've read that
all modules and classes should have docstrings, but I don't really have
anything else to say, and each module contains only one class. I don't think
that
"""Temperature Sense Test"""
class Test3(ar_test.AR_TEST):
"""Temperature Sense Test"""
would be a real improvement.
What do you think?
Steve.
- Previous message (by thread): Rebuild list of objects with redundancies on objects' attribute
- Next message (by thread): docstrings style question
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
More information about the Python-list mailing list