Comment 2 for bug 606456

The iterator is helpful and definitely a best practice. we should report bugs on any packages that don't respect that namespace.

However, even in that situation, its not clear how to link to the output of 'man 3 open' that one would expect on a default or common install.

This one is particularly troubling:

http://manpages.ubuntu.com/manpages/man5/init.5.html

This is particularly frustrating as the best practice on learning about upstart is 'read man 5 init' .. but if you try to use the web to do it, you get runit-run, which is an init replacement from universe.

Seems that one simple thing to do would be to make sure the repositories are generated in least important -> most. So at least do main *last* so that its man pages will overwrite those of any other repository.

That can be fixed by switching the default order that is used right now.

Longer term, I'm testing a fix right now that builds an index file of conflicting pages so you get the Provided by's with links to each page.