[Distutils] pkg_resources API reference now available

[Phillip J. Eby]

I've just checked in the completion of a pkg_resources API reference.  In 
case you'd like to see the HTML version, or if SourceForge hasn't updated 
anonymous CVS yet, you can see it at:

     http://peak.telecommunity.com/DevCenter/PkgResources

Keep in mind that only the API reference is completed, and it turned out to 
be a much denser, far more interconnected document than I imagined it would 
be.  My plan is to write a short architecture overview and a 
tutorial/FAQ-style "developer's guide" to go with this, so that most people 
won't have to slog through the API reference just to learn how to use the 
basic features.  But, I wanted to start by writing the reference section so 
that I'd know what stuff I could then leave out of those other guides.  :)

However, if your goal is to extend pkg_resources or setuptools in some way, 
create new distribution formats, support custom importers, or create 
package management tools, you will probably benefit greatly from taking the 
time to read the full API reference.  (Especially since the API reference 
is less text to read than the pkg_resources source code!)