Python "header" files

[Nicolas Fleury]

beliavsky at aol.com wrote:
> Ideally, one can use someone's C++ code by just looking at the header
> files
> (which should contain comments describing the functions in addition to
> function definitions), without access to the full source code. Can
> analogs of C++ header files be created for Python code?

You don't want to do that.  Use pydoc utilities instead.  If you use 
Windows with ActivePython, look at <PythonDir>\Tools\scripts\pydocgui.pyw.

Headers in C++ are there by obligation, not by choice.  Expect that to 
disappear the day modules are introduced in C++ (still dreaming).

Regards,
Nicolas