--------------------------------------------
certainly mention the distlib implementations, but also let's be clear if there is a pypa-recommend tool that is user-facing (like pip), that is using those parts of distlib. In most cases, that is not true currently. As for mentioning distil, I'm inclined to say no. Up to this point, you've presented it as a proof of concept.If you're wanting to mention "distil" as a real option for users, I'm concerned about fracturing the mind of users, but it's something to discuss I guess.
I hear what you're saying. I've positioned distil as a proof of concept purely because it hasn't had widespread use, but I certainly expect it to fulfil the same role as pip functionally (which it must do to be an effective test-bed for distlib). I understand that pip is the officially recommended tool, and don't want to muddy the waters, there being enough confusion about packaging in the wider community. It seems a shame that some of the improvements over pip won't be more widely available, but such is life. I have the use of them, so there's that :-) Regards, Vinay Sajip