The library reference of pkgutil is only sparsely marked up. The attached patch is against 2.6 version, because I'm currently working with 2.6. Since a part of markups (namely :pep:'s) has already been done for 3.2 version, the patch cannot be applied directly to that version, and I haven't checked the versions in between.
Thanks for the report. Patch looks good to me. I assume the other function descriptions already have complete markup, since your patch touches only two of them. If there are no remarks from docs@python or objections from Georg, I will apply this in a week, taking care of all three branches.