If an entity does not have a docstring, pydoc.getdoc() reads the comment associated with that entity and uses that as the source of documentation. However, inspect.getcomments() returns the raw comment with the comment signs ('#') in it, thus the resulting documentation looks ugly and confusing. Is there a way to solve this problem?

I know that this is not an easy task, because by implementing a specific '#' removing solution, the format of the doc comments would be restricted to conform to that algorithm with little formatting freedom. But maybe someone can come up with a good idea, such as counting '#'-s in the first line and strip all the lines accordingly.

The best solution is to modify the offending code to use real docstrings.

Failing that, a simple explicit "'\n'.join(line.lstrip('#' for line in comment.split('\n'))" (i.e. not as part of pydoc) will handle most cases.

Anything more sophisticated would need to be tailored to the comment format of the code that is missing docstrings.