I'm doing a lot of work with the CPAN.pm programmer's interface for a client, and I'm spending a lot of time in the source figuring out what the rules are. As I go through this, I intend to expand the documentation for those bits.
For install, what should install() return? Is it just true or false if it worked or not? It looks like most errors end up returning nothing (so undef on failure), but I think I'm also getting false in some cases where things worked. I'm setting up some specific test cases to see if I can deduce all of that. However, if I know what it should do, I can document that too.
