Check this out: <http://itamarst.org/twisted-docs/twisted.html> The output will be that much more cleaner and informative if you add a __all__ list to your package. __all__ is the list of objects you want to be exported when somone does "from yourmodule import *" and is used by my documentation program to decide what to document. It is a simple list of strings. For example: =========================================== import sys _list = [] def addToList(object): """add an object to the list""" _list.append(object) CONSTANT = 3 __all__ = ["addToList", "CONSTANT"] ===========================================