Is there *any* real documentation to PyWin32?

Gerrit Muller gerrit.muller at embeddedsystems.nl
Fri Dec 21 07:56:51 EST 2007


rurpy at yahoo.com schreef:
<...snip...>
> Personally I consider Python-win32 to be docware -- software that is
> sufficiently difficult to use with the included free documentation
> that many people will just buy the $$$ documentation.  Numpy is
> another prominent example of docware.  A misappropriation of the good-
> will value of legitimate open source software.
> 
<...snip...>
As others have pointed out Python-Win32 provides access to an extremely 
wide range of services and programs. The main purpose is to do this in a 
Pythonic was: simplifying matters, where the original interfaces are 
very awkward and complicated.

Unfortunately many of these services and programs that can be accessed 
in this way are themselves very poorly documented, or require indeed 
expensive books. Blaming Python-Win32 is hitting the wrong group of 
people entirely! You cannot expect them to document huge monsters such 
as Windows XP or Vista, or the other monsters that can be automated 
through COM, such as Powerpoint, Word and Excel.

I am myself automating some trivial MS-office stuff, but I am 
flabbergasted by the fragmentary nature of on-line documentation in 
MS-office. The real problem is that these kinds of programs are not 
described at a reasonable conceptual level, making it difficult to 
automate trivial tasks. In your term MS-office is docware, certainly not 
Python-Win32. My experiences with Python-Win32 itself are very good.

Gerrit



More information about the Python-list mailing list