Tarek ruled that time spent improving the distutils docs was time lost and better spent on distutils2.  Accordingly, I only fix clear bugs in the doc but don’t improve them in any way.  I’m inclined to close this as wontfix, or I can remove the XXX if you’re strongly against them.  (For the packaging docs, I will fix them properly.)